Ajout d’une langue

Préparations

Si la langue que vous voulez traduire n’a pas déjà été initiée par quelqu’un d’autre et que vous souhaitez créer un ensemble de nouveaux fichiers pour la langue souhaitée, disons “fr” (français), vous devez d’abord utiliser l’environnement que vous avez créé, comme indiqué dans Démarrer, en particulier les sections Installation des dépendances et Construction du manuel.

Ceci va vous donner un environnement de base pour :

  • Création d’un nouveau jeu de langue de traduction à partir des sources en anglais.

  • Lancez la commande “make” pour convertir les textes traduits dans les fichiers po en fichiers html pour les tester localement.

  • Mettre à jour les modifications dans les textes en anglais qui ont été ajoutées par d’autres contributeurs.

Les exemples ci-dessous montrent le processus de création d’un nouvel jeu de fichiers pour le Français, code de langue fr, sur la plateforme Linux. Sur d’autres plateformes cela pourrait différer légèrement mais devrait être essentiellement identique.

  1. Créez un ID Blender <https://id.blender.org/register/> si vous ne l’avez pas déjà fait.

  2. Connectez-vous à projects.blender.org et Créez une question demandant un accès commit afin de transférer des modifications au référentiel central de l’équipe de traduction.

  3. Ouvrez une instance d’une application console.

  4. Change the current working directory to the directory of blender-manual, where the instance of Makefile resides.

Essai du processus make pour créer des fichiers HTML en anglais

  1. Assurez-vous que l’instance précédente du dossier build est supprimée, s’il existe

    make clean

  2. Convertissez tous les fichiers rst en fichiers pot de traduction

    make gettext

  3. Créez les fichiers html

    make html

  4. After this, you can actually view the created html files locally by opening the blender-manual/build/html/index.html file.

Création de l’entrée de la langue dans le menu HTML

  1. Create an entry for the language in the html menu by opening file ./resources/theme/js/version_switch.js (assuming you are at the blender-manual subdirectory).

  2. Trouvez la table des langues dans var all_langs = {..};.

  3. Saisissez l’entrée : 'fr': 'Fran&ccedil;ais',, ('fr': 'Français'). (Notez les caractères Unicode.)

  4. Commit the updated file:

    git add ./resources/theme/js/version_switch.js
git commit -m "HTML: Add French to language menu"

  5. Push your changes to the upstream repository:

    git push

Production du jeu de fichiers pour la langue cible

  1. Consultez le dépôt de traduction courant en utilisant la commande

    git clone https://projects.blender.org/blender/blender-manual-translations.git locale

    This will download all language sets available in the repository into the locale directory of your drive. You can go to the locale directory to see the hidden subdirectory .git within it, together with directories of languages. You’ll need to add your own set of files for the language you are trying to translating to.

  2. From the blender-manual directory to generate a set of files for fr language:

    make update_po

    Ces fichiers sont encore uniquement en anglais, avec toutes les entrées msgstr vierges.

  3. Soumettez le nouveau jeu de fichiers au dépôt central

    cd locale
git add fr
git commit -m "Initial commit language set of files for French"

Astuce

  • Il est recommandé de créer deux variables d’environnement pour ces dossiers, dans le .bashrc pour rendre plus pratique la modification ou l’écriture des commandes batch/shell pour le processus de traduction et la révision des résultats

    export BLENDER_MAN_EN=$HOME/<directory to make file directory above>/blender-manual
export BLENDER_MAN_FR=$BLENDER_MAN_EN/locale

  • Newly generated files will contain some placeholders for authors and revision dates etc. If you find the job of replacing them repetitive, make use of the script change_placeholders.sh in the subdirectory ~/blender-manual/tools_maintenance, make a copy of that to your local bin directory and replace all values that were mentioned in the file with your specific details, then after each change to a file, you would do following commands to update the file with your personal details, revision date and time, plus generating the html files for your language, which you can view using your Internet browser:

    $HOME/bin/change_placeholders.sh $BLENDER_MAN_FR
make -d --trace -w -B -e SPHINXOPTS="-D language='fr'" 2>&1