I'd like to use some of the common symbol entity substitutions afforded by
restructured text in my Sphinx docs, using



.. include:: <isonnums.txt>



and so forth. Is there a way to include this file once for my whole
project, so that I can use the |copy| and similar substitutions in all
documents in my project? As it stands, it appears I have to .. include the
file for every RST file in my project where I use such a substitution...





Hi Victor,



I’m not sure if this is exactly what you have in mind…



We use a single substitutions file for 3 different sets of documentation.
It lives a directory above each set of documentation project.



Documentation

    -- 00-Sandbox-directory

     -- Product-A-directory

    -- Product-B-directory

    -- Product-C-directory

     -- extensions-directory-for-all-products

     substitutions.rst



All files in each product directory contain the following line at the top
of each document (line 1), followed by the chapter title:



.. include:: ../../substitutions.rst



==================

Chapter Title Here

==================



Kathy

-- 
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.

Reply via email to