使用docutils.core生成漂亮的文档

Docutils是Python的文档工具库，可以用于生成漂亮的文档，并且支持添加使用例子。下面是一个使用Docutils生成漂亮文档并带有使用例子的简单示例。

首先，我们需要安装Docutils库。可以通过在命令行中运行以下命令进行安装：

pip install docutils

安装完成后，我们可以使用Docutils来生成文档。下面是一个简单的示例代码：

from docutils.core import publish_parts

document = """
==============
Example
==============

This is an example document.

Usage Example
-------------

.. code-block:: python

    def add(a, b):
        return a + b

    result = add(2, 3)
    print(result)

Output:

5

"""

html = publish_parts(document, writer_name='html')['html_body']
print(html)

在上面的示例中，我们定义了一个使用例子的文档，并且使用了Docutils的publish_parts函数将其转换为HTML格式的文档。我们使用了writer_name='html'参数来指定生成HTML格式的输出。最后，我们可以通过publish_parts的返回值获取到生成的HTML文档，并将其打印出来。

运行上述代码后，将会得到一个新的HTML文档。该文档包含了我们定义的使用例子，并且以漂亮的格式展示了出来。可以将其保存为.html文件，并在浏览器中打开查看效果。

这只是一个非常简单的示例，实际上我们可以在文档中添加更多的部分来展示更多的使用例子。Docutils还支持其他格式的输出，例如PDF、LaTeX等。

总之，使用Docutils可以轻松地生成漂亮的文档，并且通过添加使用例子可以更好地展示功能和用法。这对于开发人员来说非常有用，可以将其用于编写技术文档、API文档等。