是否可以修补Sphinx(或Sphinx主题)以避免在HTML输出中生成永久链接时重写标题?
上下文:我正在使用Sphinx编写Logtalk文档,并且在参考手册标题中,例如foo/2
和foo//2
表示不同的构造,但是Sphinx生成相同的永久链接(#foo-2
),这显然是通过进行某种标题标准化来实现的。这也破坏了与Logtalk的图表工具的集成,该工具期望链接URL中有#foo/2
和#foo//2
。
更新
使用raw
指令找到了解决方法。例如
.. raw:: html
<div id="foo/2"> </div>
我的reStructuredText文件是自动生成的,因此包含此变通办法很容易。我仍然更愿意避免这种情况。