Установка и использование 'make htmldocs'

Question

Я хочу преобразовать первые файлы ядра Linux в HTML-документ. Пожалуйста, предоставьте четкие инструкции по установке необходимых пакетов и команд для генерации первого файла в 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