BibtexRef

Note: The recipes here are for PmWiki versions 0.6 and 1.0 only. For PmWiki 2.0 recipes, see Cookbook.


Goal

Integrate your bibtex bibliography into your PmWiki site, display, manipulate and easily cite your references.

Solution

This little script allows you to display your bibtex bibliography into PmWiki in a convenient way and to put references to it. It introduces new markups and works directly over .bib files.

Comments, suggestions should go to Alexandre [period] Courbot [snail] lifl [period] fr.

You can see an example usage of this script at http://www.lifl.fr/RD2P/JITS/Publications. It demonstrates the query feature.

Discussion

Installation

Get the source package and untar it inside your local/ directory. You should have the following hierarchy:

  local/bibtexref/bibtexref.php

Then add

  include 'bibtexref/bibtexref.php';

to your config.php.

Also, you should upload a pdf.gif image file for displaying links to pdfs.

New actions

This script introduces a new PmWiki action: bibentry, which is used to display a bibtex entry on one page. It requires two additional parameters, bibfile (the file name to take the bibtex entry from) and bibref (the reference of the entry to display).

PmWiki tags

To make bibliographical references, you must first upload a few .bib files, either using PmWiki upload facility, or by copying them to uploads/Group/. Bibliography files are only usuable within the group they are uploaded from.

Citations are made with the tags {[...]} with the form: {[bibfile.bib,reference]}. They will expand to a clickable [reference] that will automatically direct you to the whole bibtex entry.

You can also cite the entry summary using

 bibtexsummary:[bibfile.bib,reference].

Or you can quote the complete bibtex entry with

 bibtexcomplete:[bibfile.bib,reference].

These first tags correspond to my immediate needs, but I'm going to code something different and more generic later.

You can also make bibtex queries, using the following syntax:

 bibtexquery:[bibfile.bib],[select rule][sort rule][limit rule]

"select rule", "sort rule" and "limit rule" are directly PHP code. An example is much better that any explanation here:

 bibtexquery:[bibfile.bib][$this->get('YEAR') == '2004'][!$this->get('PUBDATE')][5]

History

Contributors

Copyright

This software is distributed under the GNU General Public License. pmwiki-2.2.113 -- Last modified by {{Gnurou}}?

from IP: 85.171.160.186 ip should be disabled by default for security reasons