Linux内核rst转HTML文档：make htmldocs报错及依赖安装求助

看起来你搞错了Sphinx的安装包——sphinxsearch是用于全文搜索的工具，不是我们生成文档需要的那个Sphinx！ 下面是完整的修复步骤，帮你顺利把内核RST文档转成HTML：

1. 卸载错误的包（可选但推荐） #

先把装错的搜索工具卸掉，避免后续混淆：

sudo apt-get remove --purge sphinxsearch

2. 安装正确的文档生成工具及依赖 #

安装官方用于文档生成的Sphinx，同时补上缺失的sphinx_rtd_theme主题：

# 安装基础的Sphinx和Python包管理工具
sudo apt-get install python3-sphinx python3-pip
# 通过pip安装Read the Docs主题（这就是你报错缺失的组件）
sudo pip3 install sphinx-rtd-theme

如果内核文档还依赖其他Sphinx扩展（比如拼写检查、标签页支持），可以一并安装：

sudo pip3 install sphinxcontrib-spelling sphinx-tabs

3. 生成HTML文档 #

进入Linux内核源码的Documentation目录（或者你存放RST文档的根目录），执行生成命令：

cd /path/to/linux-kernel/Documentation
make htmldocs

生成完成后，HTML文档会存放在Documentation/output/html路径下，直接打开里面的index.html就能浏览完整的文档了。

内容的提问来源于stack exchange，提问作者stackuser