Premiers pas

Les figures

Les figures sont au format SVG, format libre de dessin/schéma/graphique vectoriel facilement affichable dans une page web. Peu importe le logiciel utilisé (cf. ticket #45 pour le créer, du moment que le fichier est en SVG.

Conventions

dans les fichiers à traduire

Afin de faciliter la traduction, chaque fichier contient d'abord la version anglaise, puis la version française (évidemment en grande partie vide au départ).

Notez bien que la version anglaise est rédigée en mode "citation" ce qui s'affiche par un caractère > en début de chaque ligne quand on édite le texte en markdown. Merci de bien laisser cette mise en forme qui nous sera très utile pour reconstituer le texte intégrale en supprimant la partie anglaise.

Dès lors qu'il y a un tableau, il ne doit pas y avoir de retour à la ligne dans le texte markdown (c'est assez déroutant !-(. Soit il faut mettre deux espaces, soit la balise html: <br>

"S'approprier" un fichier à traduire

Merci, si vous souhaitez vous "approprier" un fichier, d'indiquer dans le titre anglais en première ligne du fichier, votre nom (ou id gitlab @bdavid, par exemple) et la plage de temps sur laquelle vous prévoyez ce travail. Attention, ne pas renommer le fichier !! (cela impacte l'intégration continue pour construire la page web)

À la sauvegarde (commit)

Avant de sauvegarder, indiquer à quelle étapes de traduction par les jalons suivants:

• traduction provisoire
• traduction avancée
• traduction à relire (ce qui permettra à un relecteur de prendre la main!)
• traduction finalisée

Cohérences des termes

Pour les termes, afin d'avoir une cohérence de traduction, vous pouvez vous référez au document suivant :
https://docs.google.com/spreadsheets/d/1907jCczrY-6c7HcCYRvAF5cFLNULygfS0fcd63cSNmo/edit?usp=sharing

La majorité des traducteurs va sans doute réaliser la traduction directement sous gitlab, les autres pourront donc voir que les dernières modifications ont été faites par telle ou telle personne si on ajoute son identifiant ou nom dans le message du commit, comme illustrée dans la capture ci-dessus

Pour les habitués de git/gitlab

Il est évidemment possible de copier (pull) le projet sur sa machine, de commiter en local puis de charger (push) les modifications sur le serveur, notamment si vous voulez travailler sans connexion ethernet. Dans ce cas, avant de "puller", réalisez une petite modif en ligne pour que les autres voient que vous vous appropriez le fichier. N'hésitez pas à contacter @bdavid si vous avez des questions à ce sujet.
Cf. #10