653

13. Contribuir al projecte

654

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.

655

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.

656

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

657

• 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/...'.

658

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

659

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

660

13.1 Traducció de pàgines dels manuals

661

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:

662

• Continuar amb una traducció ja començada

663

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

664

• Començar una nova traducció des de zero

665

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:

666

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

667

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

668

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