From: https://www.google.com/accounts/o8/id?id=AItOawnptdo_29LsbUxftV55P932hRZccivCtl0 Date: Tue, 1 Nov 2011 22:16:33 +0000 (-0400) Subject: initial X-Git-Tag: 3.20111106~7^2~4 X-Git-Url: http://git.vanrenterghem.biz/git.ikiwiki.info.git/commitdiff_plain/647b7ae616f96fc3d1ba3abb9007566de0f6d2fc?ds=sidebyside;hp=63aab2bdb13b75f0a47e65db7aa37960f608727c initial --- diff --git a/doc/plugins/contrib/bibtex.mdwn b/doc/plugins/contrib/bibtex.mdwn new file mode 100644 index 000000000..33770377d --- /dev/null +++ b/doc/plugins/contrib/bibtex.mdwn @@ -0,0 +1,42 @@ +# bibtex for ikiwiki # + +This [ikiwiki]-plugin provides a + + [[!bibtex ]] + +directive for [ikiwiki]. + +So far, it can display a raw or formatted bibtex-entry from a +bibtex-file (either checked into ikiwiki, or not). + +[ikiwiki]: http://ikiwiki.info/ + +Get it at [github]. + +[github]: https://github.com/ihrke/iki-bibtex + +Features: + +* supports websetup + +## Requirements ## + +* [Text::BibTeX] - available from CPAN + +[Text::BibTeX]: http://search.cpan.org/~ambs/Text-BibTeX-0.61/lib/Text/BibTeX.pm + +## Examples ## + +Output from file mybib.bib, bibtex key 'key1' in a citation-like +format (authors (year): journal. volume (number), pages.). + + [[!bibtex file="mybib.bib" key="key1" format="citation"]] + +Combine with toggle-plugin to optionally display the raw bibtex + + [[!bibtex key="Ihrke2011"]] [[!toggle id="bibtexentry" text="(entry)"]] + [[!toggleable id="bibtexentry" text=""" + [[!bibtex key="Ihrke2011" format="raw"]] + [[!toggle id="bibtexentry" text="(hide)"]] + """]] +