Python中使用docutils.core库生成带目录的文档

docutils是一个Python库，用于处理文本和生成文档。它提供了一个名为core的模块，可以用来生成具有目录的文档。

下面是一个使用docutils.core库生成带目录的文档的示例：

import docutils.core

def generate_document(title, content):
    document_template = """
    <document>
        <title>{title}</title>
        <section id="contents">
            <title>Contents</title>
            {toc}
        </section>
        <section id="content">
            {content}
        </section>
    </document>
    """

    document = document_template.format(title=title, toc="", content=content)
    settings = {'output_encoding': 'unicode', 'doctitle_xform': False}
    parts = docutils.core.publish_parts(source=document, writer_name='html4css1', settings_overrides=settings)
    return parts['html_body']

# 示例文本内容
title = "My Document"
content = """
    <section>
        <title>Section 1</title>
        <paragraph>This is section 1.</paragraph>
    </section>
    <section>
        <title>Section 2</title>
        <paragraph>This is section 2.</paragraph>
    </section>
"""

# 生成文档
document = generate_document(title, content)
print(document)

在上面的示例中，generate_document函数接受标题和内容作为参数，并使用这些参数构建一个包含目录的文档模板。然后，使用docutils.core.publish_parts函数将文档模板转换为HTML格式。输出HTML的主体部分被提取，并作为函数的返回值。

在示例中，我们使用了一个简单的文档模板，包含了一个标题、一个目录部分和一个内容部分。目录部分的内容在<section id="contents">标签中生成，内容部分的内容在<section id="content">标签中生成。您可以根据需要自定义文档模板。

要使用这个示例，您需要安装docutils库。您可以使用以下命令在命令行中安装docutils：

pip install docutils

此示例生成的HTML文档将打印在控制台上。您可以将其保存到文件中，或进一步处理和定制生成的HTML。

总结起来，使用docutils.core库可以轻松地生成带有目录的文档。您只需要提供标题和内容，并使用一些简单的模板语法构建文档模板。这使得在Python中生成结构化的文档变得非常简单。