installlatex.rst 2.1 KB

12345678910111213141516171819202122232425262728293031323334353637383940
  1. .. _install_latex:
  2. Installing LaTeX
  3. ================
  4. In order to build the PDF Documentation, you will need to install `LaTeX <http://www.latex-project.org/>`_, and a number of LaTeX extensions. If you just want to build the HTML documentation, LaTeX is not necessary.
  5. Windows
  6. -------
  7. 1. Install `MiKTeX <https://miktex.org/howto/install-miktex>`_.
  8. 2. In the Settings section of the installer, set "Install missing packages on-the-fly" to "Always" or "Ask me first". This will let MikTex download the various extension packages required to build the GeoServer docs as they are needed.
  9. Ubuntu
  10. ------
  11. #. Install the following TeX Live packages::
  12. sudo apt-get install -y texlive-base texlive-latex-recommended \
  13. texlive-science texlive-latex-extra texlive-extra-utils
  14. 2. As an alternative to (1), you can install the standard `TeX Live <http://tug.org/texlive/acquire-netinstall.html>`_ distribution, then install `texliveonfly <http://www.ctan.org/tex-archive/support/texliveonfly>`_ to install any missing packages as they are needed.
  15. CentOS
  16. ------
  17. 1. Install the following TeX Live packages::
  18. sudo yum install texlive-pdftex texlive-latex-bin texlive-texconfig* texlive-latex* texlive-metafont* texlive-cmap* texlive-ec texlive-fncychap* texlive-pdftex-def texlive-fancyhdr* texlive-titlesec* texlive-multirow texlive-framed* texlive-wrapfig* texlive-parskip* texlive-caption texlive-ifluatex* texlive-collection-fontsrecommended texlive-collection-latexrecommended
  19. 2. As an alternative to (1), you can install the standard `TeX Live <http://tug.org/texlive/acquire-netinstall.html>`_ distribution, then install `texliveonfly <http://www.ctan.org/tex-archive/support/texliveonfly>`_ to install any missing packages as they are needed.
  20. 3. The CentOS distribution of TeX Live is missing some required extensions, which you will need to `install manually <https://en.wikibooks.org/wiki/LaTeX/Installing_Extra_Packages#Installing_a_package>`_:
  21. * `tabulary <https://www.ctan.org/pkg/tabulary>`_
  22. * `upquote <https://www.ctan.org/pkg/upquote>`_
  23. * `capt-of <https://www.ctan.org/pkg/capt-of>`_
  24. * `needspace <https://www.ctan.org/pkg/needspace>`_