linux - 'make htmldocs' 的安装和使用

Question

我想将 Linux 内核 rst 文件转换为 html 文档。请提供明确的步骤来安装所需的包和命令以将 rst 文件生成为 html。

我已经使用以下命令安装了 sphinx

sudo apt-get install sphinxsearch

运行“make htmldocs”时遇到错误

The Sphinx 'sphinx_rtd_theme' HTML theme was not found

如果可能的话，你能帮我安装正确的软件包吗？这看起来很棘手，我已经尝试了足够多的。

Answer 1

我刚刚发现Linux内核中有一个文档解释了使用'make pdfdocs'所需的信息：

Reference: Documentation/doc-guide/sphinx.rst

#sudo apt-get install sphinxsearch
#sudo apt-get install python-sphinx-rtd-theme
#sudo apt-get install texlive-latex-recommended
#sudo apt-get install texlive-base
#sudo apt-get install graphviz
#sudo apt-get install imagemagick

从内核根目录运行以下命令

#/usr/bin/virtualenv ~/sphinx_1.4
#. ~/sphinx_1.4/bin/activate
#pip install -r Documentation/sphinx/requirements.txt
#make htmldocs

生成的 html 文档位于 Documents/output