···147147format-specific subdirectories under ``Documentation/output``.148148149149To generate documentation, Sphinx (``sphinx-build``) must obviously be150150-installed. For prettier HTML output, the Read the Docs Sphinx theme151151-(``sphinx_rtd_theme``) is used if available. For PDF output you'll also need152152-``XeLaTeX`` and ``convert(1)`` from ImageMagick153153-(https://www.imagemagick.org).\ [#ink]_154154-All of these are widely available and packaged in distributions.150150+installed. For PDF output you'll also need ``XeLaTeX`` and ``convert(1)``151151+from ImageMagick (https://www.imagemagick.org).\ [#ink]_ All of these are152152+widely available and packaged in distributions.155153156154To pass extra options to Sphinx, you can use the ``SPHINXOPTS`` make157155variable. For example, use ``make SPHINXOPTS=-v htmldocs`` to get more verbose···158160It is also possible to pass an extra DOCS_CSS overlay file, in order to customize159161the html layout, by using the ``DOCS_CSS`` make variable.160162161161-By default, the build will try to use the Read the Docs sphinx theme:162162-163163- https://github.com/readthedocs/sphinx_rtd_theme164164-165165-If the theme is not available, it will fall-back to the classic one.166166-163163+By default, the "Alabaster" theme is used to build the HTML documentation;164164+this theme is bundled with Sphinx and need not be installed separately.167165The Sphinx theme can be overridden by using the ``DOCS_THEME`` make variable.168166169167There is another make variable ``SPHINXDIRS``, which is useful when test