novelWriter-docs_fr

Mon memo.

• Créer un environnement virtuel. miniconda

./conda create --name sphinx_env

• Activer l'environnement virtuel.

source /home/jim/miniconda3/bin/activate sphinx_env

• Installer Sphinx.

pip install sphinx

• Vérifier la version installé.

sphinx-build --version

• Installer le module pour la localisation.

pip install sphinx-intl

---

download ou clone du repository de novelWriter : https://github.com/vkbo/novelWriter

Création d'un dossier fr_build dans le dossier docs

Paramètres à ajouter au conf.py

locale_dirs = ['locales/']
gettext_compact = False

à partir du dossier docs

Extraire les messages traduisibles vers les fichiers .pot.

On peut changer le dossier de destination avec la variable BUILDDIR (Voir [[Makefile]])

Valeurs par défaut :

SPHINXOPTS    =
SPHINXBUILD   = sphinx-build
SOURCEDIR     = source
BUILDDIR      = build

Exemple : Générer le dossier gettext dans le dossier fr_build

make gettext BUILDDIR=fr_build

Générer les fichiers .po.

Nous utiliserons les fichiers .pot générés à l'étape précédente.

sphinx-intl update -p fr_build/gettext -l fr

Cette commande crée les dossiers : locales/fr/LC_MESSAGES dans lequel les fichiers .po sont stockés.

On doit avoir maintenant :

• Les fichiers .pot. dans :

/docs/fr_build/gettext/

• Les fichiers_.po_ dans :

/docs/source/locales/fr/LC_MESSAGES/

Traduction des messages avec [[poedit]]

Générer la documentationhtml en français.

make -e SPHINXOPTS="-D language='fr'" BUILDDIR=fr_build html

Générer le pdf via latex

make -e SPHINXOPTS="-D language='fr'" BUILDDIR=fr_build latex

Puis à partir du dossier latex créé

make