A BibTex Cite Plugin

Description

​BibTex is for formatting lists of bibliographic references.

This plugin provides the ability to cite from common bibtex (*.bib) files.

The plugin can use bibtex files out of :

• a repository (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.

Bugs/Feature Requests

Existing bugs and feature requests for TracBibPlugin are here.

If you have any issues, create a new ticket.

defect	11 / 17
enhancement	7 / 9
task	1 / 2

Download and Source

Download the [download:tracbibplugin zipped source], check out from using Subversion, or browse the source​ with Trac.

Installation

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

easy_install http://trac-hacks.org/svn/tracbibplugin/0.10/
easy_install http://trac-hacks.org/svn/tracbibplugin/0.11/
easy_install http://trac-hacks.org/svn/tracbibplugin/0.12/
easy_install http://trac-hacks.org/svn/tracbibplugin/1.0/

News

• The new 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 bibliograpy. The Entries must be inside a code block.
• The attachments can now be loaded fom any page in the wiki.
• A special page "BibTex" will be loaded automatically if this page exists, like in ​BadContent.

Usage

Configuration Settings

You can add a [bibtext] config section in trac.ini. In this section you can change the heading of the References and you can 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 way to invoke a bibtex file has substantially changed:

[[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

Examples

[[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

Macros

[[BibCite(key)]]
[[BibCite(key,page)]]

Wiki Syntax

cite:key
cite:key:page

Add an article without citation

[[BibNoCite(key)]]

Inserting the bibliography

This renders all cited entries:

[[BibRef]]

This renders all loaded entries:

[[BibFullRef]]

If you also want to render all entries from the special page BibTex, you can write:

[[BibFullRef(auto=true)]]

URL/DOI Fields

url and doi fields in BibTex files will be rendered to links if possible.

Full Example

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

Related

• Ticket 453
• Ticket 5175
• CiteMacro

Recent Changes

12605 by Amfortas on 2013-02-09 22:11:48

changing revision 'latest' to 'None' for trac 0.11

12604 by Amfortas on 2013-02-09 21:03:02

support for 'new-style' repository manager

12014 by Amfortas on 2012-09-18 08: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.

(more)

Author/Contributors

Author: Amfortas
Maintainer: Roman Mohr
Contributors: abeld