Using BibTex Cite entries for bibliographic references
This plugin provides the ability to cite from common bibtex (*.bib) files. BibTex is markup for lists of bibliographic references.
The plugin can use bibtex files out of:
- a repository, such as svn, git, mercurial
- a wiki page
- a wiki attachment
- or an external website.
If a wiki page called BibTex exists, the page is loaded automatically by
BibRef() and used as standard library.
Make sure to put bibtex entries into a code block when you use them from a wiki page.
The command structure is inspired by the reference and bibtex system in LateX. This should make it easy to make this plugin compatible with existing Trac LateX plugins.
- The default citation style is an IEEE-like style.
- BibTeX files can be loaded from external websites.
- Extensionpoint 'IBibRefFormatter' for custom citation styles introduced.
- Extensionpoint 'IBibSourceProvider' for custom !BibTeX loaders introduced.
- Wiki pages can be used as bibliography. The entries must be inside a code block.
- The attachments can now be loaded from any page in the wiki.
- A special page "BibTex" will be loaded automatically if this page exists, like in BadContent.
If you have any issues, create a new ticket.
Download the zipped source from here.
A prerequisite for installation is bibtexparser, of which a modified version is already included in the plugin.
Run one of the following commands, depending on the Trac version that you use:
easy_install https://trac-hacks.org/svn/tracbibplugin/0.10/ easy_install https://trac-hacks.org/svn/tracbibplugin/0.11/ easy_install https://trac-hacks.org/svn/tracbibplugin/0.12/ easy_install https://trac-hacks.org/svn/tracbibplugin/1.0/
You can add a bibtext section in your
trac.ini file. In this section you can change the heading of the References as well as add other sources that should always be loaded:
[bibtex] heading = Literatur # default: References auto = source:mybib.bib, wiki:BibTexBlub # default: wiki:BibTex
Load Bibtex Entries
The syntax to invoke a bibtex file is as follows:
[[BibAdd(source:path/to/file[@rev])]] # add a file from source [[BibAdd(attachment:[wikipage/]file)]] # add a file from a wiki attachment [[BibAdd(wiki:page)]] # use a wiki page [[BibAdd(http://www.external.page.com)]] # use a bibtex file from everywhere
[[BibAdd(source:bib.bib@2)]] [[BibAdd(source:trunk/bib.bib@latest)]] [[BibAdd(source:bib.bib)]] [[BibAdd(attachment:fiol.bib)]] [[BibAdd(attachment:test/lala.bib)]] [[BibAdd(http://www.external.page.com/bibtex.bib)]]
Cite an article
Add an article without citation
Inserting the bibliography
This renders all cited entries:
This renders all loaded entries:
If you also want to render all entries from the special page 'BibTex', you can write:
The url and doi fields in BibTex files will be rendered to links if possible.
= Welcome = [[BibAdd(source:mybib.bib)]] I am citing here [[BibCite(small)]] and someone said "hello world" [[BibCite(wiki,123)]] and cite:small:123-124 is important. finally the BibTex entry with the key 'big' is not cited but will appear in the references because of tho '!BibNoCite' macro. [[BibNoCite(big)]] [[BibRef()]]
When rendered this looks as follows:
- 12605 by Amfortas on 2013-02-09 23:11:48
changing revision 'latest' to 'None' for trac 0.11
- 12604 by Amfortas on 2013-02-09 22:03:02
support for 'new-style' repository manager
- 12014 by Amfortas on 2012-09-18 10:43:09
Introduced a 'bibtex' section in the config file which can be used to change the heading of the references section, and to autoload more than the wiki:BibTex? entries.