Build documentation

First, clone repository, please refer to the Galette Documentation GIT documentation to get its source.

To build the documentation, go to the root of the project (galettedoc directory if you've cloned the GIT repository) and then run make with one of the formats you want to compile (html, epub, latexpdf). In order to build the documentation for all three formats, we would run:

$ make html epub latexpdf
  sphinx-build -b html -d build/doctrees  source build/html
  Running Sphinx v1.8.4
  loading translations [fr]... done
  making output directory...
  building [mo]: targets for 0 po files that are out of date
  building [html]: targets for 41 source files that are out of date
  [...]
  Build finished. The HTML pages are in build/html.
  sphinx-build -b epub -d build/doctrees  source build/epub
  Running Sphinx v1.8.4
  loading translations [fr]... done
  making output directory...
  loading pickled environment... done
  building [mo]: targets for 0 po files that are out of date
  building [epub]: targets for 41 source files that are out of date
  [...]
  Build finished. The epub file is in build/epub.
  sphinx-build -b latex -d build/doctrees  source build/latex
  Running Sphinx v1.8.4
  loading translations [fr]... done
  making output directory...
  loading pickled environment... done
  building [mo]: targets for 0 po files that are out of date
  building [latex]: all documents
  [...]
  Running LaTeX files through pdflatex...
  [...]
  pdflatex finished; the PDF files are in build/latex.

Translations

In order to update translations, it is necessary to update POT files from the sources rst files. This can be achieved running the following command:

$ sphinx-build -b gettext source source/locale

In order to test your modifications locally on your workstation, you will need to build the documentation using an additional parameter with the make command. For example, to build the documentation in HTML in French, run :

$ make -e SPHINXOPTS="-D language='fr'" html

Note

By default, the make command will build the documentation in English.