This guide explains how I set up Gentoo Linux on my system.
Install the sphinx and related dependencies with pip:
pip install sphinx
pip install sphinx_bootstrap_theme
pip install rst2pdf
The rst2pdf plugin did not work properly with Python 3, so use Python 2.
For latex building, make sure latex is installed, including pdflatex.
Then, run:
make all
The built files will be:
- HTML:
_build/html/index.html - Single page HTML:
_build/singlehtml/index.html - PDF made with rst2pdf:
_build/pdf/GentooSetupGuide.pdf - PDF made with latex:
_build/latex/GentooSetupGuide.pdf - EPUB:
_build/epub3/GentooSetupGuide.epub - Plain text:
_build/text
The HTML version looks the best.
To build the _package folder with all the file formats ready to be distributed, run:
make release