Search code examples
pythonpython-sphinxsubstitutionrestructuredtext

Substitutions inside Sphinx code blocks aren't replaced


In this reST example meant to be rendered by Sphinx, |yaco_url| doesn't get replaced because it's in a code-block:

.. |yaco_url| replace:: http://yaco.es/

You can use wget to download it:

.. code-block:: console

    $ wget |yaco_url|package.tar.gz

I wonder if there is some way to force the replacement of |yaco_url| before rendering the code block.


Solution

  • Use the "parsed-literal" directive.

    .. parsed-literal::
    
        ./home/user/somecommand-|version|
    

    Source: https://groups.google.com/forum/?fromgroups=#!topic/sphinx-dev/ABzaUiCfO_8: