相关疑难解决方法(0)

我正在使用Sphinx来记录将部署在不同服务器中的Web服务.该文档中包含用户单击的URL示例,它们应该可以正常工作.我的问题是主机,端口和部署根目录会有所不同,必须为每个部署重新生成文档.

我尝试定义这样的替换:

|base_url|/path
.. |base_url| replace:: http://localhost:8080

但生成的HTML不是我想要的(在生成的链接中不包括"/ path"):

<a href="http://localhost:8080">http://localhost:8080</a>/path

有人知道如何解决这个问题吗？

使用Sphinx 1.2.3并给出此RST片段:

.. code-block:: xml

    <foo>
        <bar>|version|</bar>
    </foo>

在conf.py我有:

version = '1.0.2'

您如何确保上述RST片段呈现为:

<foo>
    <bar>1.0.2</bar>
</foo>

这个前面的问题表明,我们应该用.. parsed-literal::代替.. code-block::,但不工作,也没有在这个问题的工作所引用的链接要么.

我还想保留语法高亮.