BibtexRef
<< Netflix Include | Cookbook-V1 | This Farm >>
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
- Attach:bibtexref-0.2.tar.gz 2004/09/23
- Attach:bibtexref-0.1.tar.gz First release, 2004/08/27
Contributors
- Alexandre Courbot (http://www.lifl.fr/~courbot)
- Michaël Hauspie (http://www.lifl.fr/~hauspie)
- Yann Hodique (http://www.lifl.fr/~hodique)
- Romain Rouvoy (http://www.lifl.fr/~rouvoy)
Copyright
This software is distributed under the GNU General Public License. pmwiki-2.3.38 -- Last modified by {{Gnurou}}?