aboutsummaryrefslogtreecommitdiff
path: root/doc/plugins/contrib/bibtex.mdwn
blob: 9b2474982457c8e4d4bdd2903aadced45e40217e (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
# 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 
(the extra \ in the toggle-directive is because it is expanded if it is not there)

    [[!bibtex key="Ihrke2011"]] [\[!toggle id="bibtexentry" text="(entry)"]]
    [\[!toggleable  id="bibtexentry" text="""
    [[!bibtex key="Ihrke2011" format="raw"]]
    [\[!toggle id="bibtexentry" text="(hide)"]]
    """]]