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 生成文档

相关推荐
Once_day9 天前
sphinx(3)RST语法
sphinx
闲人编程17 天前
【指南】为你的开源Python项目编写完善的文档(Sphinx)
python·开源·文档·sphinx·算法改进·codecapsule
张小鸟菜菜2 个月前
Java核心技术掌握多线程编程的最佳实践与性能优化
sphinx
起个破名想半天了2 个月前
解决 PocketSphinx 中文模型缺失导致的无法实现语音识别
语音识别·sphinx
夏天是冰红茶5 个月前
Sphinx和ReadtheDocs构建一个文档网站
搜索引擎·全文检索·sphinx
船长@Quant7 个月前
文档构建:Sphinx全面使用指南 — 实战篇
python·markdown·sphinx·文档构建
船长@Quant7 个月前
文档构建:Sphinx全面使用指南 — 基础篇
python·markdown·sphinx·文档构建
船长@Quant7 个月前
文档构建:Sphinx全面使用指南 — 进阶篇
python·markdown·sphinx·文档构建
轻口味1 年前
使用sphinx自动提取python中的注释成为接口文档
开发语言·python·sphinx
林戈的IT生涯1 年前
php连接sphinx的长连接事宜以及sphinx的排除查询以及关于sphinx里使用SetSelect进行复杂的条件过滤或复杂查询
php·sphinx·长连接事宜·sphinx排除查询·sphinx条件过滤·sphinx复杂查询