Python 使用docutils解析和写入RST

Python 使用docutils解析和写入RST,python,restructuredtext,docutils,Python,Restructuredtext,Docutils,是否有可以输出重构文本的编写器? 我认为“null”编写器可能用于此目的,但它不会产生任何输出 我的用例是解析现有的RST文件,用Python修改文档树(例如,自动更新指令),然后将树输出回RST HTML可以如下输出。对于RST输出,我是否需要编写一个自定义的编写器 导入docutils.core 导入docutils.parsers.rst 从docutils.writers导入null 导入docutils.writers.html5\u polyglot txt=”“” 标题 =====

是否有可以输出重构文本的编写器? 我认为“null”编写器可能用于此目的,但它不会产生任何输出

我的用例是解析现有的RST文件,用Python修改文档树(例如,自动更新指令),然后将树输出回RST

HTML可以如下输出。对于RST输出,我是否需要编写一个自定义的
编写器

导入docutils.core
导入docutils.parsers.rst
从docutils.writers导入null
导入docutils.writers.html5\u polyglot
txt=”“”
标题
=====
…梅塔::
:description:重新构造的文本明文标记语言
:关键字:纯文本、标记语言
"""
输出=docutils.core.publish\u字符串(
source=txt,
parser=docutils.parsers.rst.parser(),
#writer_name=“null”,#docutils\u xml
#writer=docutils.writers.null.writer()
writer=docutils.writers.html5\u polyglot.writer()
)
打印(输出)

这不是一个令人满意的答案,但在此期间,我求助于使用regex-as

它为文件夹中的所有文件向索引指令添加名称引用:

输入:

.. index::
    pair: CLASS; BACKGROUNDCOLOR
输出:

.. index::
    pair: CLASS; BACKGROUNDCOLOR
    :name: mapfile-class-background

该用例用于此pull请求:

是的,一个名为
sphinxcontrib.restbuilder的Sphinx扩展

免责声明:我在2014年开始编写这段代码,但直到最近它才获得了一些牵引力,开始变得可靠。非常感谢您的贡献