For the references I would take latex as paragon: define references once in one block for the whole document and refer to them as often as you want from anywhere in the document.
For this reason I dont like "Just pick up all references in all source files?" Kent Tenny's global-files-idea pleases. But I think it is not good to hardcode the paths to the files containing global references and global subsitutions. I imagine following options for the conf.py: global_substitutions_file=foo.rst global_references_file=bar.rst Gour wrote: > > Georg> Just pick up all references in all source files? > > I'm for the above. > > Georg> A related feature are global substitutions. We have > Georg> e.g. |version| which is always defined by Sphinx, but there's > Georg> currently no way to define custom substitutions that are used > Georg> throughout all docs. It's easy to add, but there's the same > Georg> question: where to define them. > > I'm for: "Designate a source file in the config which contains them." > > > Sincerely, > Gour > > > --~--~---------~--~----~------------~-------~--~----~ 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 -~----------~----~----~----~------~----~------~--~---
