BibliographyPlugin

Cite bibliography in one topic and get a references list automatically created.

On this page:

Description

The Bibliography Plugin manages citations inside a Foswiki 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, without relying on whitespace or capitalisation variations). 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.
%CITEINLINE{theKey}% to reference samething that is not in the references. Useful to cite URL's, for example. theKey will be used both as key and text dislayed in references listing.
Warning: be sure to not use keys present in bibliography with %CITEINLINE{}%: this can have unpredicted results.

%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.

Example

You type ...	... and you get (if installed):
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{Smal l}%. You might accidentally reference a non-existent %CITE{non-existent}% reference. With %CITEINLINE% you can reference things that are not in your bibliography %CITEINLINE{http://foswiki.org/Extensions/BibliographyPlugin}%. %BIBLIOGRAPHY%	You start writing, and then cite a small paper [1]. Further, you reference a big paper [2]. You can even reference the small paper again [1]. You might accidentally reference a non-existent [??]reference. With %CITEINLINE% you can reference things that are not in your bibliography [3]. References Freely, I.P. A small paper. The journal of small papers, 1997. (to appear). Jass, Hugh. A big paper. The journal of big papers, 7991, volume MCMXCVII. http://foswiki.org/Extensions/BibliographyPlugin Reference(s): "non-existent" - were not found in the specified reference topic(s): BibliographyPlugin.

You type ...

... and you get (if installed):

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{Smal l}%. You might
accidentally reference a non-existent 
%CITE{non-existent}% reference.

With %CITEINLINE% you can reference things
that are not in your bibliography
%CITEINLINE{http://foswiki.org/Extensions/BibliographyPlugin}%.

%BIBLIOGRAPHY%

You start writing, and then cite a small paper [1]. Further, you reference a big paper [2]. You can even reference the small paper again [1]. You might accidentally reference a non-existent [??]reference.

With %CITEINLINE% you can reference things that are not in your bibliography [3].

References

Freely, I.P. A small paper. The journal of small papers, 1997. (to appear).
Jass, Hugh. A big paper. The journal of big papers, 7991, volume MCMXCVII.
http://foswiki.org/Extensions/BibliographyPlugin

Reference(s): "non-existent" - were not found in the specified reference topic(s): BibliographyPlugin.

Plugin Settings

Plugin settings are stored as preferences values. To change the setting you need to overwrite them in DefaultPreferences. Changing them here will have no effect! This allows you to upgrade the plugin without having worry about loosing your settings.

Default topic to get references from:
- Set BIBLIOGRAPHYPLUGIN_DEFAULTBIBLIOGRAPHYTOPIC = BibliographyPlugin

Default sorting for references:
- Set BIBLIOGRAPHYPLUGIN_DEFAULTSORTING = alpha

Default header for the references list:
- Set BIBLIOGRAPHYPLUGIN_DEFAULTHEADER = ---++ References

Installation Instructions

You do not need to install anything in the browser to use this extension. The following instructions are for the administrator who installs the extension on the server.

Open configure, and open the "Extensions" section. Use "Find More Extensions" to get a list of available extensions. Select "Install".

If you have any problems, or if the extension isn't available in configure, then you can still install manually from the command-line. See http://foswiki.org/Support/ManuallyInstallingExtensions for more help.

Plugin Info

Plugin Author(s): Foswiki:Main.PaulHarvey, Foswiki:Main.AndrewJones

Previous Author(s): Foswiki:Main.AntonioTerceiro

License: GPL (Gnu General Public License)

Plugin Release: 2.2.2

Plugin Version: 11925 (2011-06-15)

Change History:

15 Jun 2011 2.2.2: Foswikitask:Item10882 - Fix for Foswiki installations using UTF-8, international charsets
- ignore HTML tags in cite keys -- Foswiki:Main.PaulHarvey

05 Dec 2010 2.2.1: Foswikitask:Item10113 - Fix incorrect use of Foswiki 1.1 API

23 Jun 2010 2.2: Foswikitask:Item9182 - Be more tolerant of whitespace/capitilisation variations -- Foswiki:Main.PaulHarvey

22 Jun 2010 2.1: Foswikitask:Item9178 - Fix mod_perl/fastcgi problems; improve handling of cite keys using ',",& etc. punctuation chars -- Foswiki:Main.PaulHarvey

18 Jun 2010 2.0: Foswikitask:Item8394 - Made citation [refs] hyperlinks -- Foswiki:Main.PaulHarvey
2.0: Foswikitask:Item8459 - Convert plugin from commonTagsHandler to registerTagHandler and general code cleanup; Added Foswiki 1.1 compatibility; Minor performance improvements; Added inline alerts to aid user when citing missing references or using missing reference topics -- Foswiki:Main.PaulHarvey

29 Jan 2010 1.1: Foswikitask:Item8440 - Expand Macros in References -- Foswiki:Main.AndrewJones

17 Mar 2009 1.0: Foswikitask:Item1251 - Initial release for Foswiki -- Foswiki:Main.AndrewJones

28 Aug 2005: Adhering to official handlers in TWiki:Codev/DakarRelease. Added %CITEINLINE{...}%.

23 Aug 2004: Added multiple references sources support

17 Jun 2004: Initial version

Dependencies:

Name	Version	Description
HTML::Entities	>=1.25	Required. Available from CPAN.

Plugin Home: http://foswiki.org/Extensions/BibliographyPlugin

Development: http://foswiki.org/Development/BibliographyPlugin

Support: http://foswiki.org/Support/BibliographyPlugin

Related Topics: DefaultPreferences, SitePreferences, Plugins

This topic: System > BibliographyPlugin
Topic revision: 02 Jun 2016, MartinDiehl

Copyright © by the contributing authors. All material on this site is the property of the contributing authors.
Ideas, requests, problems regarding DAMASK? Send feedback