man 文档), 纯文本
完备的交叉引用: 语义化的标签,并可以自动化链接函数,类,引文,术语及相似的片段信息
明晰的分层结构: 可以轻松的定义文档树,并自动化链接同级/父级/下级文章
美观的自动索引:...创建文件C:\ Users \ yunswj \ Desktop \ Sphinx \ make.bat。
完成:初始目录结构已创建。...这是生成的结构
build:用来存放通过make html生成文档网页文件的目录
source:存放用于生成文档的源文件
conf.py: Sphinx的配置文件
index.rst: 主文档
config.py...HTML页面位于build \ html中。
编译过后的目录是这样的
里面有三个html文件,都打开看看
以上是打开的三个网页文档
那我写完就想自动预览文档,咋办?...)]
重新编译没有变化
为了可以自动预览,用cmd
还是主题未变,之后在解决
支持markdown文件、更改文档主题
Spinx本身不支持.md文件生成文档,需要我们使用第三方库recommonmark