修补Sphinx以避免在生成永久链接时避免重写标题?

时间:2018-10-07 15:09:42

标签: python-sphinx

是否可以修补Sphinx(或Sphinx主题)以避免在HTML输出中生成永久链接时重写标题?

上下文:我正在使用Sphinx编写Logtalk文档,并且在参考手册标题中,例如foo/2foo//2表示不同的构造,但是Sphinx生成相同的永久链接(#foo-2 ),这显然是通过进行某种标题标准化来实现的。这也破坏了与Logtalk的图表工具的集成,该工具期望链接URL中有#foo/2#foo//2

更新

使用raw指令找到了解决方法。例如

.. raw:: html

   <div id="foo/2">&nbsp;</div>

我的reStructuredText文件是自动生成的,因此包含此变通办法很容易。我仍然更愿意避免这种情况。

0 个答案:

没有答案