测试Sphinx

chap 02 First Steps with Sphinx¶

这篇文档意味着给你一个类教程的预览，此处的标注是说要更深入的研究。

2.1 设置文档源¶

一个文档集的根目录，被称为 源目录 。这个目录包含了Sphinx的配置文件 conf.py ，在这里，你可以配置各个方面，让Sphinx读取你的源和建造你的文档。

Sphinx用一个脚本来设置源目录，创建 conf.py ，只要运行：

$ sphinx-quickstart

然后回答它的问题。（确保都回答了。）

2.2 定义文档结构¶

首先假设你已经运行了Sphinx-quickstart 。它创建了一个源目录，包括