This is my own fork of bibstuff. The original project can now be found
at github.com/dschwilk/bibstuff.
The fork was mainly to add the sphinx bibref extension.
I'm retiring that extension now, because sphinxcomtrib_bibtex does a better job of the same thing, is better maintained, and is working from more modern foundations.
So, if you are using the bibref extension here, I humbly beg that you
switch to using sphinxcontrib_bibtex instead.
My personal site used to use bibref, but
now uses sphinxcontrib_bibtex, so you may want to check out the site
source for hints on porting.
The original README follows.
| authors: | Dylan W. Schwilk and Alan G. Isaac |
|---|---|
| web site: | http://www.pricklysoft.org |
| source code: | http://code.google.com/p/bibstuff/ |
| date: | 2009-02-13 |
| version: | 1.0 |
See license.txt, which must be included when this software is distributed.
Simply type 'python setup.py install' in the unpacked directory.
These tools are installed in you python scripts directory or they can be run directly from where they were unpacked. Each of these tools has a command line interface and provides the -h option to describe usage.
- biblabel.py
Creates unique keys for entries bibtex database(s). default keys look like Schwilk+Isaac:2006 or Smith+Johnson+etal:1999 Command line options allow you to change the default behavior.
- bibsearch.py
Search through a bibtex database for entries by key or by regular expression. Results can be output as a (minimally) formatted reference, a full bibtex entry, or by key. Note that bibsearch always takes a database by name (-f option or first argument) standard input is used for search terms.
- bib4txt.py
Creates formatted references for a text dodument. (Useful for reStructuredText documents.) Interacts with a Bibtex style database file (without using LaTeX or bibtex). The source text file should include citation references in reStructuredText format: a citation key enclosed in brackets, followed by an underscore. Citation keys cannot be all digits. The source document can be output with formatted citation references substituted. In this case, the reference list is added to the end of the file.
- bibname.py
Create list of author/editor names for a bibtex database. Options allow you to specify a name template. See the module documentation for details.
- jabbrev.py
Replaces all journal names in a bibtex file with alternative names (abbreviations). The abbreviation file should be in the format: <ABBREVIATION> = <LONG_NAME> (see /examples/journal_names.txt). I've also provides a short script in the /examples directory that will take the list of journal abbreviations at http://www.csa.com/htbin/sjldisp.cgi?filename=/wais/data/srcjnl/biologset and produce a format readable by jabbrev.py
- reflist.py
Creates a list of keys from a latex .bbl file. This tool simply extracts reference keys from the bbl file. This is useful for creating a bibtex database limited to those references which occur only in a single latex file.
example: reflist.py my_doc.bbl | bibsearch.py -l my_db.bib > new_db.bib
Package: bibstuff
Package: bibstuff/bibstyles
There's a sphinx extension using bibstuff in the sphinxext directory. See
the comments in sphinext/bibref.py for more details.
No tests available yet
For more information on BibTeX, see the excellent discussion in chapter 13 section 4 of The LaTeX Companion.