meaz 3b50eb45e1 french translations (#234 )

I "just" have cloud, mail and user to take care of, but I'll do that in another branch ;)

Co-authored-by: meaz <meaz@disroot.org>
Reviewed-on: Disroot/Howto#234
Reviewed-by: Fede.- <fede@no-reply@disroot.org>

2022-03-28 18:35:49 +00:00

6.4 KiB

Raw Blame History

title

published

visible

updated

taxonomy

page-toc

Procédure de traduction

true

Pourquoi une procédure de traduction ?

Nous pensons que la possibilité de rendre l'information accessible à tous dans leur propre langue est fondamentale pour encourager et promouvoir les réflexions et les actions collectives. Coordonner la quantité d'informations à traduire est donc une tâche importante.

Dans le cadre de ce guide, nous supposerons que vous savez ce qu'est git ou que vous avez lu ce guide pratique.

Les traductions se déroulent en quatre étapes principales.

Premièrement : Étapes uniques

Enregistrez un compte sur [l'instance git de Disroot]https://git.disroot.org/user/sign_up)
Ouvrez un terminal et démarrez git
. git init
Configurer le nom d'utilisateur et l'email de git
git config --global user.email user@email
git config --global user.name "Nom d'utilisateur"

Deuxièmement : Sélection d'une section à traduire

Vérifiez l'état de traduction du Howto ou l'état des traduction du site web (ces fichiers peuvent ne pas être à jour)
Connectez-vous au Projet des Traductions Disroot
Sélectionnez le Epic (l'ensemble des User Stories) correspondant à la langue dans laquelle vous allez traduire.
Sélectionnez la User Story (la section à traduire) et assignez-la à vous-même
.

Troisièmement : travailler sur les traductions

Clonez le dépôt de Disroot Howto
. a. Naviguez vers le dossier dans lequel vous allez travailler (ou ouvrez le terminal dans le dossier)
. b. Clonez le dépôt
git clone https://git.disroot.org/disroot/howto
Ouvrez l'éditeur de texte Atom
a. Allez dans Fichier, sélectionnez Ajouter un dossier de projet et naviguez jusqu'au dossier où le projet a été cloné.

b. Créez une branche (la branche doit avoir ce format : section_du_site_à_traduire_LAngue
Par exemple:
howto_contribute_git_ES
howto_email_webmail_IT

c. Commencez à travailler sur les traductions
d. Enregistrez sous le nom de "nom-du-fichier.le-code-de-votre-langue.md"
Par exemple, si vous travaillez sur la traduction française d'un fichier nommé "docs.md", vous devez l'enregistrer sous "docs.fr.md".
Envoi de la traduction
Une fois votre travail terminé, vous devrez "livrer" vos modifications. Un commit est un ensemble de fichiers créés ou modifiés. Pour valider vos modifications, vous devez :
a. Assurez-vous que tous les fichiers sont enregistrés
b. "Stagez" tous les fichiers que vous avez traduits et que vous voulez soumettre au serveur
c. Rédiger un message de validation (un résumé court et très précis de ce qui a été modifié)
d. Appuyez sur le bouton Commit

Une fois que les fichiers sont validés, vous devez les "pousser" (envoyer) vers le serveur :
e. Ouvrir la fenêtre popup Push/Pull.

f. Appuyer sur Push

Quatrièmement : demander la fusion des traductions

La dernière étape consiste à demander la fusion de votre travail dans la branche master. Cela signifie qu'une fois que vous avez terminé et envoyé la traduction, vous devez demander à l'équipe de traduction Disroot de vérifier s'il est possible de l'ajouter au site.

!! NOTE!!!

Pendant que vous travaillez sur votre branche, d'autres utilisateurs peuvent livrer et fusionner leurs propres modifications, surtout s'ils travaillent sur des fichiers existants. Si les modifications des autres utilisateurs ont déjà été fusionnées dans la branche principale, la version des fichiers que vous avez modifiés peut ne plus être la version actuelle et donc les modifications des autres utilisateurs peuvent ne pas être incluses dans vos fichiers. Dans ces cas, si vous voulez laisser vos modifications être fusionnées dans la branche principale, ce processus peut être très chaotique.

Une des principales fonctionnalités de Git est la possibilité de comparer les versions et d'insérer vos modifications dans les versions mises à jour des fichiers. Pour déclencher cela, vous devez mettre à jour votre branche avant de créer une demande de fusion. En faisant cela, vous épargnerez aux admins et à vous-même beaucoup de travail inutile :

Tout d'abord, il faut s'assurer que toutes les modifications sont validées.
Ouvrez un terminal (GNU/Linux)
Passez à la branche Master : git checkout master
Mettez à jour la branche Master : git pull
Passez à la branche de travail : git checkout <Nom_Branch>
Mettez à jour votre branche de travail à partir de la branche Master : git rebase master
Vérifiez les changements et envoyez-les au serveur.

Now you can start with the final steps of merging your files to the la branche Master:

Connectez-vous sur https://git.disroot.org
En haut à droite, vous verrez un bouton Créer une demande de fusion qui ouvrira le formulaire de demande de fusion, cliquez dessus.
Ajoutez un titre
Ajoutez une description
Assurez-vous que la branche source est celle à partir de laquelle vous voulez fusionner (celle sur laquelle vous avez travaillé).
S'assurer que la branche cible est celle vers laquelle vous voulez fusionner (généralement la branche Master)
Cochez la case Supprimer la branche source lorsque la demande de fusion est acceptée si vous êtes complètement sûr que votre travail est terminé, de cette façon les chances de confusion des traductions ultérieures sont évitées.

S'il y a un problème, les administrateurs peuvent vous demander de corriger quelque chose. Une fois que toutes les corrections sont effectuées et que la documentation répond aux directives de Disroot, votre demande de fusion sera transférée vers le master.

6.4 KiB Raw Blame History