wiki:TracBibPlugin

Version 22 (modified by Amfortas, 5 years ago) (diff)

--

A BibTex Cite Plugin

Description

The aim of this plugin is to provide the ability to cite from common bibtex (*.bib) files.
The plugin can use bibtex files out of a svn repository, a git repository,a wiki page or from an Wiki-Attachment.

If a wiki page called [BibTex] exists this 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.

Download and Source

Download the zipped source, check out from using Subversion, or browse the source with Trac.

Install

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

Requirements

bibtexparser which is included in the plugin.

News

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

Load Bibtex Entries

The way how 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 

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

Cite an article

[[BibCite(key)]]

Add an article without citation

[[BibNoCite(key)]]

Inserting the bibliography

[[BibRef]]

Full Example

#load bibliography
[[BibAdd(source:bib.bib@latest)]]
Let's cite BibCite(12332).
...
You will not see this [[BibNoCite(33425)]] here but it will appear in "BibRef"
...

#Render Cited Articles
[[BibRef]]

Known Issues

Currently only UTF8 encoded files are supported due to to lack of my knowledge how to successfully convert in any case to valid strings.

Recent Changes

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

Author/Contributors

Author: Amfortas
Contributors: abeld

Attachments (1)

Download all attachments as: .zip