wiki:TracBibPlugin

Version 3 (modified by figaro, 2 months ago) (diff)

Cosmetic changes

Add bibliographic references to wiki pages

Description

BibTeX is a system 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, such as svn, git, mercurial
  • a wiki page
  • a wiki attachment
  • 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.

Other features:

  • The new default citation style is an IEEE-like style.
  • !BibTeX files can be loaded from external websites.
  • Extension point IBibRefFormatter for custom citation styles introduced.
  • Extension point 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 from any page in the wiki.
  • A special page "BibTex" will be loaded automatically if this page exists, like in BadContent.

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 latex plugins: tagged:LaTeX

Bugs/Feature Requests

Existing bugs and feature requests for TracBibPlugin are here.

If you have any issues, create a new ticket.

defect

11 / 16

enhancement

7 / 9

task

1 / 2

Download

Download the zipped source from here.

Source

You can check out TracBibPlugin from here 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 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/

Configuration

You can add a [bibtext] config section in your trac.ini file. 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 anywhere on the web

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:

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

Attachments (1)

Download all attachments as: .zip