[Docutils-users] A few more questions about citations and other related thingies

[Morten L. J. <mor...@if...>]

[This is a resend, as I haven't seen the message arrive on the list, 
possibly linked with my ISP being on SpamCops blacklist for 20 hours.]

I'm here again! ;)

I'm using --use-latex-citations in order to place my citations just
where I want them in my latex (and PDF) as previously suggested, but
it's presenting me with another problem. If I use this option, the
latex-writer makes an extra section at the end, called References and
places the citations there. This is perfect for latex, but if the same
reST-source is used for HTML output, the citations will be grouped at
the end, *without* a header to distinguish them. Does anyone have a good
way around this problem? [1]_

In relation to trying to figure out a way around this, I started
thinking about how to handle appendices in my documents. I had hoped I
could just issue a second sectnum directive and restart the section
numbering from A, but I see this hasn't been implemented yet [2]_. Does
anyone have good examples of workarounds for this problem? Is the common
solution to just have two separate documents and combine them later?

And since I was thinking about appendices, my primary use of them would
be to include python code fragments (or indeed whole files), and I came
across [3]_ a code-block directive that was proposed, "fetched" from
ASPN and submitted to docutils-devel, but doesn't seem to have made it
all the way into docutils. What stopped it? :)


.. [1] This is not a major problem, so no sweat if it's just one of
those things that has to wait until Someone(tm) fixes the whole footnote
and citations thing.

.. [2] This **is** a problem though, but on first look seems easy enough
to fix (as such things so often do), so I might be persuaded to have a
go at it, provided we could get some details fleshed out about how it
should and should not be implemented. But that's possibly a discussion
more suited for the dev-list? (which I'm not subscribed to atm.)

.. [3] In the thread starting with
http://article.gmane.org/gmane.text.docutils.devel/2097/

-- 
Morten
Life is GREAT, but sometimes complicated...