On 2010-10-19, Trevor Bača wrote:
> Hi,

> Is there an affordance in Sphinx to build an HTML bibliography? At
> Project Abjad (www.projectabjad.org) we use Sphinx for all our project
> documentation, and we're very happy with it. Our online bibliography
> however ...

>   http://packages.python.org/Abjad/chapters/appendices/bibliography/index.html

> ... leaves something to be desired in terms of formatting and layout
> because the page comprises only ReST citations.

> So is there a way to have Sphinx build an attractive HTML
> bibliography? Or is the recommended strategy to build the bibliography
> by hand?

Citation support is on the `Docutils TODO list`__.

__ http://docutils.sourceforge.net/docs/dev/todo.html

There exists a Docutils add-on bibstuff_, maybe this can be used with
(or ported to) Sphinx.

.. _bibstuff: http://code.google.com/p/bibstuff/

There are also 2 Python implementations of BibTeX that can also
generate nicely styled HTML.

>From Docutil's todo.txt:

  Citations:
    Collect citations that are referenced ...

    Citations can be:

    a) defined in the document as citation elements

    b) auto-generated from entries in a bibliographic database.

       + based on bibstuff_?
       + also have a look at

         * CrossTeX_, a backwards-compatible, improved bibtex
           re-implementation in Python (including HTML export).
           (development stalled since 2 years)

         * Pybtex_,a drop-in replacement for BibTeX written in Python.

           * BibTeX styles & (experimental) pythonic style API.
           * Database in BibTeX, BibTeXML and YAML formats.
           * full Unicode support.
           * Write to TeX, HTML and plain text.

    * Automatically insert a "References" heading?

.. _CrossTeX: http://www.cs.cornell.edu/people/egs/crosstex/
.. _Pybtex:   http://pybtex.sourceforge.net/


Günter

-- 
You received this message because you are subscribed to the Google Groups 
"sphinx-dev" group.
To post to this group, send email to sphinx-...@googlegroups.com.
To unsubscribe from this group, send email to 
sphinx-dev+unsubscr...@googlegroups.com.
For more options, visit this group at 
http://groups.google.com/group/sphinx-dev?hl=en.

Reply via email to