Live manual

Live Systems

<< previous toc next >>

Podręcznik Systemów Live

Wnoszenie wkładu do tego projektu

13. Wnoszenie wkładu do tego projektu

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.

Wkład do projektu, taki jak tłumaczenia i poprawki, są bardzo mile widziane. Każdy może bezpośrednio zaangażować się w repozytoriach, jednak prosimy wysłać większe zmiany do listy mailingowej, aby omówić je w pierwszej kolejności. Patrz rozdział kontakt aby uzyskać więcej informacji.

${projekt} używa Git jako systemu kontroli wersji i zarządzania kodem źródłowym. Jak wyjaśniono w repozytorium Git są dwie główne gałęzie rozwoju: debian i debian-next. Każdy może wprowadzić zmiany do gałęzi debian-next w repozytoriach ive-boot, live-build, live-config, live-images, live-manual i live-tools.

Jednakże istnieją pewne restrykcje. Serwer odrzuci:

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

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

13.1 Wprowadzanie zmian

W celu wysłania zmian do repozytoriów, należy wykonać następującą procedurę. Tutaj używamy live-manual jako przykładu, więc zastąp go nazwą repozytorium, z którym chcesz pracować. Aby uzyskać szczegółowe informacje na temat edycji podręcznika live-manual zobacz: Współtworzenie tego dokumentu.

$ 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*

$ 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

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

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

Ważne: Pamiętaj, że powinno się wprowadzać wszelkie zmiany wyłącznie w gałęzi debian-next.

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

$ git push

13.2 Translation of man pages

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:

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

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:

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


<< previous toc next >>