On Tue, Sep 16, 2008 at 2:22 AM, Georg Brandl <[EMAIL PROTECTED]> wrote: > > Hi, > > a planned feature for Sphinx 0.5 is global references. The docutils support > references, like > > See [Python]_. > > .. [Python] The Python programming language, etc. etc. etc. > > (This is different from footnotes; whose names must either be numeric or > start with a '#'.) > > For Sphinx it would make sense to make those references work between documents > and e.g. put them into a bibliography in LaTeX output.
I don't really understand the choices. > > My question now is: where do you want to put the global reference definitions? > A special directive, within which all references are global? Just pick up > all references in all source files? Designate a source file in the config > which > contains them? A file generated by Sphinx? Sort of like a 'tags' file for ReST in .build/global/references.rst? Sounds useful. > Or define them in the config in the first place? Manually enter all references which should be global? That would be tedious. > > A related feature are global substitutions. We have e.g. |version| which is > always defined by Sphinx, but there's currently no way to define custom > substitutions that are used throughout all docs. It's easy to add, but > there's the same question: where to define them. .build/global/substitutions.rst ? > > I'd like to have your input on these features, since you're going to be > using them anyway :) > > Georg > > > > --~--~---------~--~----~------------~-------~--~----~ 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 -~----------~----~----~----~------~----~------~--~---
