在獅身人面像中使用自定義html編寫器

Question

如何在sphinx.writers.html中使用與獅身人面像一起提供的不同HTMLTranslator？我想修改方法depart_desc_signature。我無法修改Sphinx本身，因爲幫助文件正在與其他人一起開發，需要使用標準Sphinx正確編譯。

我知道獅身人面像支持：

• 擴展模塊：http://sphinx-doc.org/ext/appapi.html
• 自定義生成器：http://sphinx-doc.org/ext/builderapi.html

Answer 1

在conf.py定義html_translator_class指定的HTML翻譯。

例如，

html_translator_class = 'html2.HTMLTranslator' 

這不玩mathjax不錯的，所以如果html2否則的sphinx.writers.html副本，則需要明確添加調用mathjax到HTMLTranslator：

def visit_displaymath(self, node): 
    import sphinx.ext.mathjax 
    sphinx.ext.mathjax.html_visit_displaymath(self, node) 
def depart_displaymath(self, node): 
    return 
def visit_math(self, node): 
    import sphinx.ext.mathjax 
    sphinx.ext.mathjax.html_visit_math(self, node) 
def depart_math(self, node): 
    return