I am trying to include a link to the YAPSY module in my documentation as a 
substitution. 

In my conf.py:

rst_epilog = """
.. |yapsy| replace:: `YAPSY <https://yapsy.sourceforge.net/>`_
"""


When I build my docs I get sereval repetitions of:

C:\Users\Josh\PycharmProjects\todoextensible\doc\controllingoptions.rst:36: 
ERROR: Substitution definition contains illegal element: 
 <target ids="yapsy" names="yapsy" refuri="https://yapsy.sourceforge.net/";>
.. |yapsy| replace:: `YAPSY <https://yapsy.sourceforge.net/>`_ 
C:\Users\Josh\PycharmProjects\todoextensible\doc\controllingoptions.rst:12: 
ERROR: Undefined substitution referenced: "yapsy". 


for every page in my documentation. The resulting html files have a link 
around the text |yapsy| and it isa  link back to the same page.

If I try a basic abbreviation with

rst_epilog = """
.. |yapsy| replace:: :abbr:`YAPSY (Yet Another Plugin SYstem)`
"""


the files work.

Is it possible in Sphinx 1.3.1 to get a global substitution that is an 
abbreviation and a hyperlink?

Josh

-- 
You received this message because you are subscribed to the Google Groups 
"sphinx-users" group.
To unsubscribe from this group and stop receiving emails from it, send an email 
to [email protected].
To post to this group, send email to [email protected].
Visit this group at http://groups.google.com/group/sphinx-users.
For more options, visit https://groups.google.com/d/optout.

Reply via email to