将reStructuredText中的字段转成html答案

【问题标题】：Turn fields in reStructuredText into html将reStructuredText中的字段转成html
【发布时间】：2013-02-24 10:38:38
【问题描述】：

所以我有一个包含字段的 reStructuredText 文档：

:param foo: set this to do magic

我想将 rST 转换为 html，并对 param（和其他）字段进行特殊处理。

按照here 的建议，可以使用docutils.core.publish_parts 将rST 转换为html，但显然无法控制字段的输出方式。或者我可以按照here 的建议使用docutils.core.publish_doctree 来获取伪XML，并且可能（相当乏味）对其进行修改，但我不知道如何控制如何将其转换为html。

我可以看到docutils.writers.html4css1.__init__.py 中有一个HTMLTranslator 类，但我肯定不能仅仅为了控制字段的输出方式而修改它吗？我希望某处有某种模板系统可以控制如何将 XML 转换为 html ...

【问题讨论】：

标签： python restructuredtext docutils

【解决方案1】：

看看这个，如果这对你有帮助，请告诉我

ReStructuredText (reST)

【讨论】：

好吧，这是一个从 HTMLTranslator 派生的最小示例，如果我不得不沿着这条路线走下去就可以了，但是这样做并设置 visit_field 方法似乎仍然过于复杂，因为字段被列为可扩展性docutils 文档中的机制。
对不起，我想不出更多，reST 似乎是高度无证的