Live manual Debian Live

# Debian Live Manual

# Contribuire al progetto

644

# 13. Contribuire al progetto

645

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.

646

Contributions to the project, such as translations and patches, are greatly welcome. Anyone can send merge requests. The projects are hosted on Salsa: ‹https://salsa.debian.org/live-team› follow Salsa's documentation for instructions on how to contribute.

647

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

648

- 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/...".

649

- 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.

650

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

651

13.1 Translation of man pages

652

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:

653

- Working on an already existing translation

654

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}/*`

655

- Starting a new translation from scratch

656

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:

657

- 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).

658

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

659

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