655

13. Contribuer au projet

656

Lorsque vous soumettez une contribution, veuillez indiquer clairement le copyright et inclure toute mention légale relative à la licence. Notez que pour être acceptée, la contribution doit être déposée sous la même licence que le reste du document, c'est-à-dire la GPL version 3 ou ultérieure.

657

Les contributions au projet, comme les traductions et les correctifs, sont bienvenues. Les livraisons au dépôt sont possibles pour tout le monde, cependant, nous vous demandons d'envoyer les changements importants sur la liste de diffusion au préalable. Veuillez consulter Contacter pour plus d'informations.

658

Le Live Systems Project utilise Git en tant que système de contrôle de version et de gestion du code source. Comme expliqué dans Dépôts Git il existe deux branches de développement principales: debian et debian-next. Tout le monde peut faire des livraisons aux branches debian-next des dépôts live-boot, live-build, live-config, live-images, live-manual et live-tools.

659

Cependant, il y a certaines restrictions. Le serveur rejette :

660

• Push non fast-forward.

661

• Commits merge.

662

• Ajout ou suppression d'étiquettes ou des branches.

663

Même si toutes les livraisons pourraient être révisées, nous vous demandons d'utiliser votre bon sens et de faire bonnes livraisons avec de bons messages de livraison.

664

• Veuillez écrire les commentaires de livraison à l'aide de phrases complètes, en commençant par une majuscule et en terminant par un point, et avec la forme 'Fixing/Adding/Removing/Correcting/Translating/...'.

665

• Écrivez de bons messages de livraison. La première ligne doit être un résumé précis du contenu du commit qui sera inclus dans le changelog. Si vous avez besoin de faire quelques explications supplémentaires, écrivez-les au-dessous en laissant une ligne vide après la première, puis une autre ligne vide après chaque paragraphe. Les lignes des paragraphes ne doivent pas dépasser 80 caractères.

666

• Faites des livraisons de façon atomique, c'est-à-dire, ne mélangez pas des choses sans liens entre elles dans la même livraison. Faites un commit différent pour chaque modification que vous apportez.

667

13.1 Faire des changements

668

Afin de faire un push sur les dépôts, vous devez suivre la procédure suivante. Ici, nous utilisons live-manual comme un exemple pour le remplacer par le nom du dépôt dans lequel vous souhaitez travailler. Pour plus d'informations sur la façon de modifier live-manual, consultez Contribuer à ce document.

669

• Téléchargez la clé publique :

670

$ mkdir -p ~/.ssh/keys
$ wget http://debian-live.alioth.debian.org/other/keys/git@debian-live.alioth.debian.org -O ~/.ssh/keys/git@debian-live.alioth.debian.org
$ wget http://debian-live.alioth.debian.org/other/keys/git@debian-live.alioth.debian.org.pub -O ~/.ssh/keys/git@debian-live.alioth.debian.org.pub
$ chmod 0600 ~/.ssh/keys/git@debian-live.alioth.debian.org*

671

• Ajoutez la section suivante à votre configuration openssh-client :

672

$ cat >> ~/.ssh/config << EOF
Host debian-live.alioth.debian.org
     Hostname debian-live.alioth.debian.org
     User git
     IdentitiesOnly yes
     IdentityFile ~/.ssh/keys/git@debian-live.alioth.debian.org
EOF

673

• Clonez live-manual avec ssh :

674

$ git clone ssh://git.debian.org/git/debian-live/live-manual.git
$ cd live-manual && git checkout debian-next

675

• Assurez-vous d'avoir renseigné les champs d'auteur et d'email dans Git :

676

  $ git config user.name "John Doe"
  $ git config user.email john@example.org

677

Important: Rappelez-vous que vous devez livrer les changements sur la branche debian-next.

678

• Effectuez vos modifications. Dans cet exemple, vous devriez commencer par écrire une nouvelle section traitant l'application des correctifs et ensuite préparer l'ajout des fichiers et écrire le message de livraison comme ceci :

679

$ git commit -a -m "Adding a section on applying patches."

680

• Envoyez votre commit au serveur :

681

$ git push

682

13.2 Traduction des pages de manuel

683

Vous pouvez également contribuer au projet en travaillant à la traduction des pages man pour les différents paquets live-* que le projet maintient. La procédure est différente suivant que vous démarriez une nouvelle traduction ou que vous continuiez à travailler sur une traduction déjà existante :

684

• Continuer avec une traduction déjà commencée

685

Si vous voulez maintenir la traduction d'une langue déjà existante, vous devez effectuer vos modifications dans le ou les fichier(s) manpages/po/${LANGUAGE}/*.po puis, lancer la commande make rebuild depuis le répertoire manpages/. Ceci mettra à jour les pages de manuel dans manpages/${LANGUAGE}/*

686

• Commencer une nouvelle traduction à partir de zéro

687

Pour ajouter une nouvelle traduction de l'une des pages de manuel du projet, il vous faut suivre une procédure similaire. Elle peut être résumée comme suit :

688

• Ouvrez le ou les fichiers(s) manpages/pot/ dans votre éditeur favori, comme poedit, et sauvegardez-le en tant que fichier dans manpages/po/${LANGUAGE}/. (Vous devrez créer votre répertoire ${LANGUAGE}/).

689

• Lancez make rebuild depuis l'intérieur du répertoire manpages/ pour créer les fichiers manpages/${LANGUAGE}/ contenant les pages de manuel.

690

Souvenez-vous que vous devrez ajouter tous les répertoires et les fichiers, puis faire le commit, et finalement, poussez sur le serveur git.