使用 sphinx 构建文档,有时候已经放置好了文档却无法读入生成。
解决方案
在环境中下载安装好相应的库:
python
pip install sphinx_markdown_tables
python
pip install m2r
打开生成的 source
目录下的 conf.py
,文件,在文件中加入:
python
extensions = ['sphinx_markdown_tables', 'm2r']
source_suffix = [".rst", ".md"]
之后使用指令 make clean
和 make html
生成文档