655

13. Contribuir al projecte

656

Quan s'envia una contribució, s'ha d'identificar clarament el titular dels drets d'autor i incloure la declaració de concessió de llicències aplicables. Recordar que per a ser acceptada, la contribució ha de tenir una llicencia igual que la resta del document, a saber, la versió de la GPL 3 o superior.

657

Les contribucions al projecte, com ara traduccions i pegats, són molt benvingudes. Qualsevol persona pot fer un lliurament directe al repositori. No obstant això, demanem que s'enviïn els canvis grans a la llista de correu per a parlar-ne en primer lloc. Veure la secció Contacte per a més informació.

658

El Live Systems Project utilitza Git com a sistema de control de versions i gestió de codi font. Com s'explica en Repositoris Git hi ha dues branques principals de desenvolupament: debian i debian-next. Tothom pot fer lliuraments a les branques debian-next dels repositoris live-boot, live-build, live-config, live-images, live-manual i live-tools.

659

No obstant això, hi ha certes restriccions. El servidor rebutja:

660

• Push que no són fast-forward.

661

• Commits merge.

662

• Afegir o eliminar etiquetes o branques.

663

Tot i que tots els lliuraments poden ser revisats, demanem que s'utilitzi el sentit comú i es facin bons lliuraments amb bons missatges.

664

• Escriure missatges de lliurament que consisteixen en oracions completes i significatives en anglès, començant amb una lletra majúscula i acabant amb un punt. En general, aquests començaran amb la forma 'Fixing/Adding/Removing/Correcting/Translating/...'.

665

• Escriure bons missatges de lliurament. La primera línia ha de ser un resum exacte dels continguts del lliurament, que s'inclourà en la llista de canvis. Si es necessita fer algunes explicacions més, escriure a sota deixant una línia en blanc després de la primera línea i després una altra línia en blanc després de cada paràgraf. Les línies dels paràgrafs no han de superar els 80 caràcters de longitud.

666

• Fer lliuraments de manera atòmica, és a dir, no barrejar coses no relacionades en el mateix lliurament. Fer un lliurament diferent per a cada canvi que es faci.

667

13.1 Fer canvis

668

Per tal de fer un push als repositoris, s'ha de seguir el següent procediment. Aquí s'utilitza live-manual com a exemple, per tant, cal substituir-lo pel nom del repositori amb que es desitja treballar. Per a obtenir informació detallada sobre com editar live-manual veure Contribuir a aquest document.

669

• Obtenir la clau pública:

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

• Afegir la següent secció a la configuració del vostre 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

• Fer una còpia del manual a través de ssh:

674

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

675

• Assegurar-se de tenir el autor i el correu electrònic configurats al Git:

676

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

677

Important: Tenir en compte que s'han d'enviar els canvis a la branca debian-next.

678

• Fer els canvis. En aquest exemple s'hauria d'escriure primer una nova secció sobre aplicar pegats i després preparar-se per a afegir els fitxers i escriure el missatge de la següent manera:

679

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

680

• Fer un push al servidor:

681

$ git push

682

13.2 Traducció de pàgines dels manuals

683

També es pot contribuir al projecte treballant en la traducció de les pàgines dels manuals dels diferents paquets live-* que el projecte manté. El procediment pot ser diferent, depenent de si s'està començant una traducció des de zero o si es segueix treballant en una ja existent:

684

• Continuar amb una traducció ja començada

685

Si es vol treballar en la traducció d'una llengua ja existent s'ha de fer els canvis als fitxers que hi ha dins manpages/po/${LANGUAGE}/*.po i després executar make rebuild des de dins del directori manpages/. Això actualitzarà les pàgines a manpages/${LANGUAGE}/*

686

• Començar una nova traducció des de zero

687

Per afegir una nova traducció de qualsevol de les pàgines dels manuals del projecte s'ha de seguir un procediment similar. Es podria resumir de la següent manera:

688

• Obrir el fitxer o fitxers que hi ha a manpages/pot/ en el teu editor preferit, com per exemple poedit, i guardar-lo com un fitxer .po a manpages/po/${LANGUAGE}/. (S'haurà de crear el directori del ${LANGUAGE}/ corresponent).

689

• Executar make rebuild dins el directori manpages/ per a crear els fitxers a manpages/${LANGUAGE}/ que contindran les pàgines dels manuals.

690

Recordar que cal afegir tots els directoris i fitxers, i després fer el commit i finalment fer un git push al servidor git.