### 4.2.3 Requirements for building documentation

The entire set of documentation for the most current build of LilyPond is available online at https://lilypond.org/doc/latest/Documentation/web/development, but you can also build them locally from the source code. This process requires the following tools and packages, in addition to the build and run-time packages (see section Requirements for compiling LilyPond, and Requirements for compiling LilyPond).

Note: If the instructions for one of the GNU/Linux distributions listed earlier (see section Requirements for compiling LilyPond) have been used, the following can be ignored, as the necessary software packages should already be installed.

• ImageMagick
We need the `convert` tool.
• gzip
• rsync
• Texi2HTML
Use version 1.82. Later versions might work, but produce suboptimal results.

It is probably easiest to download `texi2html` directly from http://download.savannah.gnu.org/releases/texi2html/texi2html-1.82.tar.gz; then extract the files into an appropriate location and run the commands

```./configure
make
sudo make install
```

Now verify that your operating system is able to see the correct version of `texi2html` by entering

```texi2html --version
```

on the command line.

• The following URW++ font families (consisting of Roman, Bold, Italic, and Bold Italic styles, in OTF format) are optional but highly recommended. If they cannot be found by FontConfig at configuration time, use the `configure` option ‘--with-urwotf-dir’ to specify their location.
• C059
• Nimbus Mono PS
• Nimbus Sans
• To get reproducible documentation builds (this is, PDF documentation files contain the same fonts regardless of the build platform), the following font families should be installed.
• Bitstream Vera Sans
• Bitstream Charter
• DejaVu Sans
• DejaVu Serif
• DejaVu Sans Mono
• Linux Libertine O
• Noto Serif CJK JP/Noto Serif JP

It is recommended to install the standard Roman (or Regular), Italic, Bold, and Bold Italic styles for all listed families; for the large Japanese fonts of the ‘Noto Serif CJK JP’ or ‘Noto Serif JP’ family, Regular and Bold styles are sufficient.

• extractpdfmark
This is an optional component. However, it is highly recommended due to the large number of included PDF snippets. While making the compilation process much slower, it helps reduce the PDF output size by large amounts: for example, the size of the Notation Reference shrinks from approx. 30MB to 7MB.
• Finally, to convert LilyPond’s documentation (in texinfo format) to PDF files, including more than thousand PDF snippets generated by LilyPond, XeTeX is used by default. If not available, pdfTeX is tried instead, which might give inferior results, however – for example, ligatures (fi, fl, ff, etc.) may not be printed in the PDF output.

Not surprisingly, both XeTeX and pdfTeX are also part of TeX Live. Most GNU/Linux and other free software distributions already provide packages for TeX Live, see above. TeX Live can can also be installed separately; it contains stand-alone binaries for most platforms.