资源介绍
该项目只是如何使用Sphinx项目启动文档的示例
$ mkdir docs
$ cd docs
$ sphinx-quickstart
请按照说明操作,将conf.py变量“ html_theme”更改为带有美丽主题sphinx_rtd_theme
html_theme = 'sphinx_rtd_theme'
然后跑
$ make html
这些文件将在./_build/html/下生成
如果您有一棵复杂的树,请记住,“ make html”将仅查找已更改的文件,这些文件将重新生成
因此,如果您希望重新生成Sphinx项目中的所有文件,请使用
$ find . -type f -name "*.rst" -exec touch {} +
$ make html
或者只是使用我刚刚放在此目录中的自定义bash脚本
$ sh buildhtml.sh