python - 在 Sphinx 中使用自定义 HTML 编写器

Question

如何在 sphinx.writers.html 中使用与 Sphinx 附带的不同的 HTMLTranslator？

具体来说，我想修改方法depart_desc_signature。我无法修改 Sphinx 本身，因为帮助文件是与其他人一起开发的，需要使用标准 Sphinx 正确编译。

我知道Sphinx支持:

• 扩展模块:http://sphinx-doc.org/ext/appapi.html
• 自定义构建器:http://sphinx-doc.org/ext/builderapi.html

Answer 1

所选答案在最新版本的 Sphinx 中不再有效。我在 sphinx-users 邮件列表上询问，并且 Jean Abou Samra 非常友善地给了我以下解释和可以放入 conf.py 的示例代码:

配置文件中的setup()函数获取应用程序 对象并可以改变它。例如，conf.py 中的这段代码将 将所有强调标记解释为粗体:

from sphinx.writers.html import HTMLTranslator

class MyTranslator(HTMLTranslator):
     def visit_emphasis(self, node):
         self.visit_strong(node)
     def depart_emphasis(self, node):
         self.depart_strong(node)

def setup(app):
     app.set_translator('html', MyTranslator)