Contribuez
Sur cette page, le Français (fr) est utilisé pour les exemples. Cependant, il peut être remplacé par d’autres codes de langue. Aussi, assurez-vous de changer les suffixes /fr dans ce guide en ceux de la langue que vous êtes en train de traduire !
Pour voir quelles langues sont actuellement disponibles, vous pouvez parcourir le dépôt :
https://projects.blender.org/blender/blender-manual-translations
Note
Avant tout, vous êtes supposé avoir déjà construit le manuel. Si vous ne l’avez pas déjà fait, retournez à la section Prise en main.
Installation
Des fichiers de langue
Depuis le dossier contenant la copie du manuel, lancez la commande suivante
git clone https://projects.blender.org/blender/blender-manual-translations.git locale
Ceci va créer un sous-dossier locale/fr.
Vous devriez avoir une disposition de dossiers comme ceci
blender-manual
|- locale/
| |- fr/
| | |- LC_MESSAGES/
|- manual/
Note
When running Git from the command line (such as updating or committing),
you will need to change directory to locale first rather then the blender-manual directory.
Un éditeur PO
Pour éditer les fichiers PO, vous aurez besoin d’installer un éditeur PO. Nous avons recommandé l’utilisation de Poedit. Cependant, n’importe quel éditeur PO fera l’affaire.
Note
Pour les utilisateurs de Linux, vous devrez vérifier dans le dépôt de logiciels de votre distribution pour une version de Poedit. Cet éditeur n’est qu’une recommandation. Il y en a d’autres, tels que Kate ou Kwrite, qui pourraient offrir la coloration syntaxique et des outils de base pour l’édition de texte, par ex, la transposition de casse de lettres. D’autres plateformes peuvent utiliser certains éditeurs de texte prenant en charge la coloration syntaxique pour les fichiers PO, ou vous permettant de créer (tels que Notepad++ sous Windows).
Construction avec les traductions
Maintenant vous pouvez construire le manuel avec les traductions en place :
Sous Linux ou macOS, lancez
make -e BF_LANG=fr
Sous Windows, lancez
set BF_LANG=fr
make html
À présent, vous disposez d’une copie du manuel avec les traductions en place.
Édition des fichiers de traduction
Vous pouvez maintenant éditer les fichiers de traduction PO, dans le dossier LC_MESSAGES vous avez deux fichiers :
blender_manual.po– Il s’agit du fichier de traduction principal que vous allez éditer.sphinx.po– Ce fichier de traduction est beaucoup plus petit et contient des traductions pour le thème du site Web.
Pour éditer ces fichiers, ouvrez-les dans votre éditeur de traduction, c’est-à-dire Poedit. Une fois dans votre éditeur, vous verrez une liste de textes, chacun de ces éléments représente une partie du manuel d’utilisation. Vous devrez peut-être ajuster votre éditeur pour trier la liste d’une manière qui a du sens, par exemple “by source”.
You can now select an untranslated string and your editor will have an input box to add the translation.
The modified .po files can now submitted as a patch or committed back to the repository.
Astuce
Assurez-vous de Building with Translations pour détecter les erreurs de syntaxe que vous pourriez faire lors de la traduction. Ces erreurs seront affichées sous forme d’avertissements lors de la création du manuel.
Submitting Translations
Translators who have been given commit access can commit to the main repository without needing to fork the repository.
See Commit Guidelines if this applies to you.
Fork Translation Repository
Go to Blender repository and click the Fork button.
Confirm the fork with the default settings.
Now you will have to add your personal fork as a remote in your local git repository. Click SSH to see the correct URL, and then add it like this:
git remote add me [email protected]:<USERNAME>/blender-manual-translations.git git submodule sync
Note
In order to push to the fork repository, you need an SSH key.
If you don’t already have the file ~/.ssh/id_rsa.pub,
there’s a simple command to generate such keys which works on Linux, macOS, and in Git Bash on Windows:
ssh-keygen
This command will generate a private key id_rsa and a public key id_rsa.pub in ~/.ssh.
The private key must never be shown or sent to anyone else to avoid compromising your account,
but the public key is safe to share.
The contents of ~/.ssh/id_rsa.pub can be copied and pasted into
the account settings on projects.blender.org,
after clicking « Add Key ». Any name for the SSH key is ok.
Maintenance
Garder une trace des chaînes floues (fuzzy)
Quand le manuel est mis à jour, les traductions qui sont dépassées seront marquées floues (fuzzy). Pour en garder la trace, vous pouvez utiliser un outil que nous avons créé pour cette tâche.
Vous pouvez faire cela en lançant
make report_po_progress
Ceci va seulement fournir un résumé rapide. Cependant, vous pouvez avoir plus d’information en lançant
python tools_report/report_translation_progress.py locale/fr/
Vous devriez obtenir une liste de tous les fichiers avec l’information sur le nombre de chaînes vides et floues. Pour plus d’options, voir:
python tools_report/report_translation_progress.py --help
Mise à jour des fichiers PO
Comme le manuel d’origine change, les modèles devront être mis à jour. Notez que cela n’est pas obligatoire, car l’administrateur met habituellement à jour les fichiers pour toutes les langues en même temps. Ceci permet que toutes les langues soient à la même version du manuel. Cependant, si vous devez mettre à jour les fichiers vous-même, cela peut être fait comme suit :
make update_po
The updated templates can then be committed to the repository.
Voir aussi
Un guide pour ajouter une nouvelle langue se trouve dans Ajout d’une langue.