使用docutils解析和编写RST

Question

是否有可用的写入器可以输出reStructuredText？我认为"null“作者可能就是为了这个目的，但它不会产生任何输出。

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

HTML可以如下所示输出。对于RST输出，我需要编写一个自定义的Writer来完成这个任务吗？

    import docutils.core
    import docutils.parsers.rst
    from docutils.writers import null
    import docutils.writers.html5_polyglot

    txt = """
    Title
    =====

    .. meta::
       :description: The reStructuredText plaintext markup language
       :keywords: plaintext, markup language

    """

    output = docutils.core.publish_string(
                source=txt,
                parser=docutils.parsers.rst.Parser(),
                #writer_name="null", # docutils_xml
                #writer= docutils.writers.null.Writer()
                writer=docutils.writers.html5_polyglot.Writer()
                )

    print(output)

Answer 1

是的，斯芬克斯的扩展名为sphinxcontrib.restbuilder at https://github.com/sphinx-contrib/restbuilder

免责声明:我在2014年开始编写这段代码，但直到最近它才开始变得可靠。最感谢捐款。

Answer 2

不是一个令人满意的答案，但同时我使用regex -就像在这个要旨中一样。

它将名称引用添加到文件夹中所有文件的索引指令中：

输入：

.. index::
    pair: CLASS; BACKGROUNDCOLOR

输出：

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

用例用于此拉请求：https://github.com/mapserver/docs/pull/327