Question

在SSphinx公司(Sphinx)提供的这一反转录系统实例中,由于在编码24小时中出现过:

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

Answer 1

使用“零敲碎打”指令。

.. parsed-literal::

    ./home/user/somecommand-|version|

资料来源:https://groups.google.com/forum/? Fromgroups=#!topic/sphinx-dev/ABzaUiCfO_8 :

Answer 2

找到一个更好的解决办法(我认为),可以在其他指令中使用,例如<代码>:samp:,并且可能对未来的读者有用。

config.py:

def ultimateReplace(app, docname, source):
    result = source[0]
    for key in app.config.ultimate_replacements:
        result = result.replace(key, app.config.ultimate_replacements[key])
    source[0] = result

ultimate_replacements = {
    "{TEST}" : "replaced"
}

def setup(app):
   app.add_config_value( ultimate_replacements , {}, True)
   app.connect( source-read , ultimateReplace)

这种标记:

.. http:get:: testing/replacement/{TEST}

适当产生:

testing/replacement/replaced

请注意,如果用此取代<代码>:samp:指令中的论点,则要求采用双字母{。

:samp:`func({{TEST}})`.

来源:

友情链接