Live manual Debian Live

# Debian Live Manual

# Wnoszenie wkładu do tego projektu

677

# 13. Wnoszenie wkładu do tego projektu

678

Wnosząc swój wkład należy jasno określić posiadacza jego praw autorskich i zawrzeć wszelkie stosowane oświadczenie licencjonowania. Należy pamiętać, że aby zmiany były zaakceptowane, wkład musi być licencjonowany na tej samej licencji co reszta dokumentów, a mianowicie, GPL w wersji 3 lub nowszej.

679

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.

680

Nawet jeżeli wszystkie zmiany mogą być później zweryfikowane, prosimy abyś używał zdrowego rozsądku i tworzył dobre zmiany opisane dobrym komentarzem.

681

- Pisz komentarze do zmian, które składają się z pełnych, sensownych zdań w języku angielskim, począwszy od dużej litery, a kończących się kropką. Zwykle te komentarze zaczynają się od "Fixing/Adding/Removing/Correcting/Translating/...". ("Naprawianie/Dodawanie/Usuwanie/Korygowanie/Tłumaczenie/ itd. ... ".)

682

- Pisz dobre komenarze do zmian. Pierwsza linia musi być dokładne podsumowanie treści popełnić, która zostanie uwzględniona w liście zmian (ang. changelog). Jeśli musisz zrobić kilka wyjaśnień, napisz je niżej pozostawiając pusty wiersz po pierwszej lini, a następnie kolejny pusty wiersz po każdym akapicie. Linie każdego akapitu nie powinny przekraczać 80 znaków.

683

_ * Wysyłaj zmiany osobno. To znaczy; nie mieszaj niepowiązanych ze sobą rzeczy w tej samej zmianie. Dodać osobną zmianę dla każdej rzeczy, którą zmieniasz.

684

13.1 Translation of man pages

685

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:

686

- Working on an already existing translation

687

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

688

- Starting a new translation from scratch

689

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:

690

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

691

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

692

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