On Feb 1, 12:29 am, Guenter Milde <mi...@users.berlios.de> wrote:
> OTOH, for my taste reStructuredText is too limited for scientific > papers yet: no citation support, no referencing to numbered > tables/figures via labels, ... When we first tried writing papers in reST, our first step was to solve the problem of supporting citations in both HTML and latex. On the latex side, I just used the bibcite Sphinx extension and modified it slightly (so it would automatically copy the .bib bibliography database file to the _build/latex directory). On the HTML side, I modified bibcite slightly to put each citation name in a <span class="citation>, and added a _templates/layout.html that just adds a javascript link to the document's script_files. The javascript (written by my colleague Marc Harper) just scans the document for citations, queries our bibliography server to get the citation info, and inserts a formatted bibliography at the end of the document. All of this took about an hour to figure out and implement. For both HTML and latex it uses a single standard bibliography system (i.e. a bibtex bibliography database), and works across all my platforms: latex output, HTML on my desktop web browser, HTML on my iPad web browser, etc. The key point is that *none* of this required any changes to Sphinx. So I would say the problem is not that reST doesn't support citations, or even that Sphinx can't handle them, but only that the simple extension for doing it (bibcite) hasn't been made a standard part of the package. The (trivial) modifications I made to bibcite are here: https://bitbucket.org/foobaron/bibcite My _templates/layout.html is just: {% extends "!layout.html" %} {% set script_files = script_files + [pathto("http:// citation.marcallenharper.com/site_media/citation_fetch.js", 1)] %} I too want automatic referencing to numbered figures and tables via labels. It seems like that should be straightforward to implement. How hard do you think it would be? I am interested in trying to implement this. I'll take some more time to digest your very helpful comments, before replying further. -- Chris -- You received this message because you are subscribed to the Google Groups "sphinx-dev" group. To post to this group, send email to sphinx-dev@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.
