BibliographyPlugin manages citations inside a TWiki topic, and can generate an References List at the end of the topic. This should be every usefull for writing conference papers, journal articles, ellaborated news, etc.
First of all, you must have a topic with a list of bibliography entries. Each entry must consist of a table rows with two columns: the first one contains a key, that will identify that entry (and must be unique). The second column contains the bibliography reference for that entry.
The bibliography list should look like this (from a BibTex example found with Google):
Key | Description |
---|---|
big | Jass, Hugh. A big paper. The journal of big papers, 7991, volume MCMXCVII. |
small | Freely, I.P. A small paper. The journal of small papers, 1997. (to appear). |
Then, in the topic where you want to reference and get a references list, you can use:
%CITE{theKey}%
to reference the entry with key theKey.
%BIBLIOGRAPHY{...}%
to get a list of references. %BIBLIOGRAPHY{...}%
accepts the following arguments:
Argument | Description | Default value |
---|---|---|
header | the header for the references list (like "References", "Referências" (in portuguese), and so on. | DEFAULTHEADER setting (see below). |
referencesTopic | indicates the topic bibliography must be taken from. Can be a comma-separated list of topics. | DEFAULTBIBLIOGRAPHYTOPIC setting (see below). |
order | in which order the references should appear. Accepted values are citation (references appear in citation order) and alpha (references appear in alphabetical order). | DEFAULTSORTING setting (see below). |
Usage example: | ||
%BIBLIOGRAPHY{header="---++ Referências" referencesTopic="MinhaBibliografia" order="citation"}% The above usage tells BibliographyPlugin to use "Referências" (in portuguese) as the title of the references list, to take bibliography from a topic names MinhaBibliografia and to list the references in citation order. |
Plugin settings are stored as preferences variables. To reference a plugin setting write %<plugin>_<setting>%
, i.e. %INTERWIKIPLUGIN_SHORTDESCRIPTION%
data/debug.txt
)
Note: You do not need to install anything on the browser to use this plugin. The following instructions are for the administrator who installs the plugin on the server where TWiki is running.
BibliographyPlugin.zip
in your twiki installation directory. Content:
File: | Description: |
---|---|
data/TWiki/BibliographyPlugin.txt | Plugin topic |
data/TWiki/BibliographyPlugin.txt,v | Plugin topic repository |
lib/TWiki/Plugins/BibliographyPlugin.pm | Plugin Perl module |
Plugin Author: | TWiki:Main/AntonioTerceiro |
Plugin Version: | 23 Aug 2004 |
Change History: | |
23 Aug 2004: | Added multiple references sources support |
17 Jun 2004: | Initial version |
CPAN Dependencies: | none |
Other Dependencies: | none |
Perl Version: | 5.005 |
TWiki:Plugins/Benchmark: | GoodStyle? 97%, FormattedSearch? 99%, BibliographyPlugin 97% |
Plugin Home: | http://TWiki.org/cgi-bin/view/Plugins/BibliographyPlugin |
Feedback: | http://TWiki.org/cgi-bin/view/Plugins/BibliographyPluginDev |
Related Topics: TWikiPreferences, TWikiPlugins