We use sphinx doc and sphinx-rtd-theme. Requirements are included.

A container based on sphinx image is created using docker-compose-dev.yml, documentation is built in watch mode thanks to sphinx-autobuild.

To compile and test documentation on local environment, run :

docker-compose up -d sphinx

Access to documentation built in html :

Translate documentation

  • Generate .pot if needed

docker-compose run --rm sphinx make gettext
  • Generate .po files

docker-compose run --rm sphinx sphinx-intl update -p _build/locale -l fr