Live manual Debian Live

# Debian Live Manual

# Contribuir al proyecto

677

# 13. Contribuir al proyecto

678

Cuando se envía una contribución se debe identificar claramente al titular de los derechos de autor e incluir la declaración de las licencias aplicables. Se hace notar que para ser aceptada, una contribución debe ser publicada bajo la misma licencia que el resto del documento, es decir, GPL versión 3 o posterior.

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

A pesar de que todas las entregas pueden ser revisadas, pedimos usar el sentido común y hacer buenos commits con mensajes de commit adecuados.

681

- Hay que escribir mensajes de entrega que consistan en una frase en ingles con significado completo, comenzando con una letra mayúscula y acabando con un punto final. Es habitual comenzar estas frases con la forma 'Fixing/Adding/Removing/Correcting/Translating/...'.

682

- Escribir buenos mensajes de entrega. La primera frase debe ser un resumen exacto de los contenidos del commit, que se incluirá en la lista de cambios. Si se necesita hacer algunas aclaraciones, escribirlas debajo dejando una línea en blanco después de la primera y luego otra línea en blanco después de cada párrafo. Las líneas de los párrafos no deben superar los 80 caracteres de longitud.

683

- Hacer entregas de forma atómica, es decir, no mezclar cosas no relacionadas en el mismo commit. Hacer un commit diferente para cada cambio que se realice.

684

13.1 Traducción de las páginas de manual

685

También se puede contribuir al proyecto trabajando en la traducción de las páginas de manual de los diferentes paquetes live-* que el proyecto mantiene. El proceso es diferente, dependiendo de si se está comenzando una traducción desde cero o si se continua trabajando en una traducción ya comenzada:

686

- Continuar con una traducción ya comenzada

687

Si se desea mantener la traducción de una lengua ya existente hay que realizar los cambios en el fichero o ficheros presentes en `manpages/po/${LANGUAGE}/*.po` y después ejecutar `make rebuild` desde dentro del directorio `manpages/`. Esto actualizará las páginas de manual de `manpages/${LANGUAGE}/*`

688

- Empezar una nueva traducción desde cero

689

Para añadir una nueva traducción de cualquiera de las páginas de manual del proyecto hay que seguir un proceso similar. Se puede resumir del modo siguiente:

690

- Abrir el fichero o ficheros de `manpages/pot/` en el editor preferido, como por ejemplo poedit, y guardarlo como fichero .po en `manpages/po/${LANGUAGE}/`. (Se tendrá que crear el directorio del `${LANGUAGE}/` correspondiente).

691

- Ejecutar `make rebuild` desde dentro del directorio `manpages/` para crear los ficheros `manpages/${LANGUAGE}/` que contendrán las páginas de manual.

692

Recordar que se tendrán que añadir todos los directorios y ficheros antes de escribir el mensaje de presentación y hacer la entrega al servidor git.