diff options
Diffstat (limited to 'documentation/README')
-rw-r--r-- | documentation/README | 29 |
1 files changed, 3 insertions, 26 deletions
diff --git a/documentation/README b/documentation/README index b60472fcbf..c888b666a8 100644 --- a/documentation/README +++ b/documentation/README | |||
@@ -108,32 +108,9 @@ generated with DocBook. | |||
108 | How to build the Yocto Project documentation | 108 | How to build the Yocto Project documentation |
109 | ============================================ | 109 | ============================================ |
110 | 110 | ||
111 | Sphinx is written in Python. While it might work with Python2, for | 111 | To build the documentation, you need Sphinx and a few other packages, |
112 | obvious reasons, we will only support building the Yocto Project | 112 | which depend on your host GNU/Linux distribution. Such packages are listed on |
113 | documentation with Python3. | 113 | https://docs.yoctoproject.org/dev/ref-manual/system-requirements.html#required-packages-for-the-build-host |
114 | |||
115 | Sphinx might be available in your Linux distro packages repositories, | ||
116 | however it is not recommended to use distro packages, as they might be | ||
117 | old versions, especially if you are using an LTS version of your | ||
118 | distro. The recommended method to install the latest versions of Sphinx | ||
119 | and of its required dependencies is to use the Python Package Index (pip). | ||
120 | |||
121 | To install all required packages run: | ||
122 | |||
123 | $ pip3 install sphinx sphinx_rtd_theme pyyaml | ||
124 | |||
125 | To make sure you always have the latest versions of such packages, you | ||
126 | should regularly run the same command with an added "--upgrade" option: | ||
127 | |||
128 | $ pip3 install --upgrade sphinx sphinx_rtd_theme pyyaml | ||
129 | |||
130 | Also install the "inkscape" package from your distribution. | ||
131 | Inkscape is need to convert SVG graphics to PNG (for EPUB | ||
132 | export) and to PDF (for PDF export). | ||
133 | |||
134 | Additionally install "fncychap.sty" TeX font if you want to build PDFs. Debian | ||
135 | and Ubuntu have it in "texlive-latex-extra" package while RedHat distributions | ||
136 | and OpenSUSE have it in "texlive-fncychap" package for example. | ||
137 | 114 | ||
138 | To build the documentation locally, run: | 115 | To build the documentation locally, run: |
139 | 116 | ||