BibliographyPlugin

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.

Syntax Rules

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):

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).
  references	indicates the topics that 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" references="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.

Example

You start writing, and then cite a
small paper %CITE{small}%. Further,
you reference a big paper %CITE{big}%.
You can even reference the small
 paper again %CITE{small}%.

%BIBLIOGRAPHY{}%

Plugin Settings

Plugin settings are stored as preferences variables. To reference a plugin setting write %<plugin>_<setting>%, i.e. %INTERWIKIPLUGIN_SHORTDESCRIPTION%

• One line description, is shown in the TextFormattingRules topic:
  • Set SHORTDESCRIPTION = cite bibliography in one topic and get a references list automatically created.

• Default topic to get references from:
  • Set DEFAULTBIBLIOGRAPHYTOPIC = BibliographyPlugin

• Default sorting for references:
  • Set DEFAULTSORTING = citation

• Default header for the references list:
  • Set DEFAULTHEADER = ---++ Referências

• To debug plugin, (See output in data/debug.txt), enable $TWiki::cfg{Plugins}{BibliographyPlugin}{Debug} = 1

Plugin Installation Instructions

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.

• Download the ZIP file from the Plugin web (see below)
• Unzip 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

• Test if the installation was successful: see above at #Example

Plugin Info

Related Topics: TWikiPreferences, TWikiPlugins

-- TWiki:Main/AntonioTerceiro - 17 Jun 2004
-- MauricioVieira - 10 Sep 2008
-- MauricioVieira - 15 Sep 2008