Patacrep project documentation
Python Makefile
Switch branches/tags
Nothing to show
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
book
img
locale/en/LC_MESSAGES
more
song
.gitignore
LICENSE
Makefile
bin.rst
book.rst
conf.py
index.rst
installation.rst
more.rst
readme.md
song.rst

readme.md

Patacrep-doc

Documentation for the patacrep project, using Sphinx.

This documentation may be read online on Read the Docs.

To build the documentation, you will need a make implementation and sphinx. Sphinx can be installed with pip, or very likely with the package manager of your distribution.

Compilation

HTML

make html

PDF

You will need a working LaTeX distribution.

make latexpdf

Translated version

The main language of the documentation is French. English version is also available, and can be build with the following steps :

  1. Install gettext, or make sure you have it.
  2. Install sphinx-intl with pip.
  3. Create the gettext .pot files with make gettext
  4. Update the locale directory with sphinx-intl update -p _build/locale -l en
  5. Translate the .po files in locale/en/LC_MESSAGES/
  6. Build the HTML version with make -e SPHINXOPTS="-D language='en'" html
  7. Build the PDF version with make -e SPHINXOPTS="-D language='en'" latexpdf

When the French documentation is updated, restart at step 3.

Compiled version

A compiled PDF version should be available, someday, here : http://www.patacrep.com/data/documents/doc_fr.pdf