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

相关推荐
船长@Quant19 天前
文档构建:Sphinx全面使用指南 — 实战篇
python·markdown·sphinx·文档构建
船长@Quant19 天前
文档构建:Sphinx全面使用指南 — 基础篇
python·markdown·sphinx·文档构建
船长@Quant20 天前
文档构建:Sphinx全面使用指南 — 进阶篇
python·markdown·sphinx·文档构建
轻口味9 个月前
使用sphinx自动提取python中的注释成为接口文档
开发语言·python·sphinx
林戈的IT生涯9 个月前
php连接sphinx的长连接事宜以及sphinx的排除查询以及关于sphinx里使用SetSelect进行复杂的条件过滤或复杂查询
php·sphinx·长连接事宜·sphinx排除查询·sphinx条件过滤·sphinx复杂查询
爱123哈哈9 个月前
win11使用sphinx编写文档并部署到github page
github·全文检索·sphinx
biomooc10 个月前
docs | 使用 sphinx 转化rst文件为html文档
sphinx
GuokLiu10 个月前
240707-Sphinx配置Pydata-Sphinx-Theme
python·搜索引擎·全文检索·文档·sphinx
*_潇_*10 个月前
0122__linux之eventfd理解
sphinx
LingMax20131 年前
Mysql8 %中间%模糊搜索 强行 支持 使用 索引 代替全文搜索 全文检索数据库
sql·mysql·elasticsearch·全文检索·中文分词·solr·sphinx