chap 02 First Steps with Sphinx¶ 这篇文档意味着给你一个类教程的预览,此处的标注是说要更深入的研究。 2.1 设置文档源¶ 一个文档集的根目录,被称为 源目录 。这个目录包含了Sphinx的配置文件 conf.py ,在这里,你可以配置各个方面,让Sphinx读取你的源和建造你的文档。 Sphinx用一个脚本来设置源目录,创建 conf.py ,只要运行: $ sphinx-quickstart 然后回答它的问题。(确保都回答了。) 2.2 定义文档结构¶ 首先假设你已经运行了Sphinx-quickstart 。它创建了一个源目录,包括