Sphinx使用md文档构建失败

​使用 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 cleanmake html 生成文档

相关推荐
MC皮蛋侠客20 天前
部署 Sphinx 文档到 GitHub Pages 详细指南
github·全文检索·sphinx
MC皮蛋侠客21 天前
使用 Sphinx 构建高质量 Python 文档
python·全文检索·sphinx
Once_day2 个月前
sphinx(3)RST语法
sphinx
闲人编程2 个月前
【指南】为你的开源Python项目编写完善的文档(Sphinx)
python·开源·文档·sphinx·算法改进·codecapsule
张小鸟菜菜4 个月前
Java核心技术掌握多线程编程的最佳实践与性能优化
sphinx
起个破名想半天了4 个月前
解决 PocketSphinx 中文模型缺失导致的无法实现语音识别
语音识别·sphinx
夏天是冰红茶7 个月前
Sphinx和ReadtheDocs构建一个文档网站
搜索引擎·全文检索·sphinx
船长@Quant9 个月前
文档构建:Sphinx全面使用指南 — 实战篇
python·markdown·sphinx·文档构建
船长@Quant9 个月前
文档构建:Sphinx全面使用指南 — 基础篇
python·markdown·sphinx·文档构建
船长@Quant9 个月前
文档构建:Sphinx全面使用指南 — 进阶篇
python·markdown·sphinx·文档构建