First off, thanks so much for Sphinx. You can add MapServer <http://mapserver.osgeo.org > to the list of projects using Sphinx for its documentation. We have over 200 files of docs that eventually ends up being over 600 pages of PDF when generated by LaTeX. Sphinx and reStructuredText are a fantastic way to manage it all.
One thing that is challenging to manage with so much documentation is the referencing. We're using :ref: with labels <http://sphinx.pocoo.org/markup/inline.html#cross-referencing-arbitrary-locations > all over the place. When writers write docs, one thing they need to be able to do to make their documents stronger is add lots of linking using the :ref:'s, but you have to know what the reference names are before you can call them. It would be very handy to collect all of the :ref: names and their titles into a reStructuredText table that could be included in the documentation somewhere so authors have a primer when writing/editing their docs. Is this currently possible without too much trouble? Would I need to write an custom extension/builder to do it? Are there any examples to follow? Thanks for any pointers, and Sphinx kicks ass. Howard --~--~---------~--~----~------------~-------~--~----~ You received this message because you are subscribed to the Google Groups "sphinx-dev" group. To post to this group, send email to [email protected] To unsubscribe from this group, send email to [email protected] For more options, visit this group at http://groups.google.com/group/sphinx-dev?hl=en -~----------~----~----~----~------~----~------~--~---
