655

13. Contribuire al progetto

656

When submitting a contribution, please clearly identify its copyright holder and include any applicable licensing statement. Note that to be accepted, the contribution must be licensed under the same license as the rest of the documents, namely, GPL version 3 or later.

657

I contributi al progetto, come traduzioni e patch, sono estremamente benvenuti. Chiunque può eseguire il commit direttamente sul repository; tuttavia chiediamo di inviare le modifiche più corpose in mailing list, per poterne prima discutere. Per maggiori informazioni vedere la sezione Contatti.

658

The Live Systems Project uses Git as version control system and source code management. As explained in Git repositories there are two main development branches: debian and debian-next. Everybody can commit to the debian-next branches of the live-boot, live-build, live-config, live-images, live-manual and live-tools repositories.

659

Tuttavia ci sono alcune restrizioni. Il server rifiuta:

660

• push non fast-forward,

661

• commit merge,

662

• aggiunta o rimozione di tag e branch.

663

Anche se tutti i commit possono essere corretti, chiediamo di usare il buon senso ed eseguire buoni commit con dei buoni messaggi.

664

• Si scrivano messaggi costituiti da frasi in inglese esaurienti e utili, inizianti con una lettera maiuscola e terminanti con un punto. Solitamente cominceranno con la forma "Fixing/Adding/Removing/Correcting/Translating/...".

665

• Scrivere buoni messaggi nei commmit. La prima riga deve contenere un sunto accurato del contenuto del commit in quanto verrà incluso nel changelog. Se si necessita di aggiungere ulteriori spiegazioni, scriverle sotto lasciando una riga vuota dopo la prima e quindi un'altra vuota dopo ogni paragrafo. Le righe non devono superare gli 80 caratteri.

666

• Eseguire commit atomici, ovvero non mescolare cose non inerenti tra loro nello stesso commit ma farne uno per ogni modifica apportata.

667

13.1 Applicare le modifiche

668

Per eseguire il push ai repository è necessario seguire la seguente procedura. Verrà usato live-manual come esempio per cui rimpiazzalo con il nome del repository su cui si vuole lavorare. Per informazioni dettagliare su come modificare live-manual si veda Contribuire a questo documento.

669

• Prelevare la chiave pubblica:

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

• Aggiungere la seguente sezione alla propria configurazione di 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

• Scaricare tramite ssh un clone del manuale:

674

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

675

• Assicurarsi di avere impostato autore e indirizzo email:

676

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

677

Importante: Notare che tutte le modifiche vanno eseguite sul ramo debian-next.

678

• Apportare le modifiche. In questo esempio si scrive prima una nuova sezione che si occupa di applicare patch e quindi prepararla al commit aggiungendo i file e scrivendo il messaggio in questo modo:

679

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

680

• Inviare il commit al server:

681

$ git push

682

13.2 Translation of man pages

683

You can also contribute to the project working on the translation of the man pages for the different live-* packages that the project maintains. The procedure is different depending on whether you are starting a translation from scratch or continue working on an already existing one:

684

• Working on an already existing translation

685

If you want to maintain the translation of an already existing language you have to make your changes to your manpages/po/${LANGUAGE}/*.po file or files and then run make rebuild from inside the manpages/ directory. This will update the actual man pages in manpages/${LANGUAGE}/*

686

• Starting a new translation from scratch

687

In order to add a new translation of any of the project's man pages you have to follow a similar procedure. It could be summarized as follows:

688

• Open the manpages/pot/ file or files in your favourite editor, such as poedit, and save it as a .po file in manpages/po/${LANGUAGE}/. (You will have to create your ${LANGUAGE}/ directory).

689

• Run make rebuild from inside the manpages/ directory to create the manpages/${LANGUAGE}/ files which will contain the actual man pages.

690

Remember that you will have to add all the directories and files, then make the commit and finally push to the git server.