Sistema de control de versiones del proyecto de documentación de Debian

Acceso a los fuentes en Git

El proyecto de documentación de Debian almacena la información en Salsa, la instancia GitLab de Debian. Para acceder a ficheros individuales y revisar modificaciones recientes o las actividades del proyecto en general, visite el repositorio del DDP.

Si lo que desea es descargar manuales completos, disponer de acceso directo a Salsa es probablemente una opción mejor. Las secciones que siguen explican cómo clonar una repositorio Git (en modo de solo-lectura o de lectura-escritura) en su máquina local y cómo actualizar su copia local. Antes de empezar, por favor, instale el paquete git en su máquina.

Clonado de un repositorio Git de forma anónima (solo-lectura)

Use esta orden para descargar todos los ficheros de un proyecto: 

git clone https://salsa.debian.org/ddp-team/release-notes.git

Haga lo mismo para cada proyecto que quiera descargar. Sugerencia: para obtener el URL correcto a especificar en la orden git clone, abra el proyecto en un navegador web, haga click en el botón azul (Clone) y copie el URL (Clone with HTTPS) al portapapeles.

Clonado de un repositorio Git con privilegios de actualización (lectura-escritura)

Para poder acceder al servidor Git de esta manera, antes le han tenido que conceder acceso de escritura al repositorio. Consulte esta sección para más información sobre cómo solicitar permiso de actualización.

Con acceso de escritura a Salsa, puede emitir la orden siguiente para descargar todos los ficheros de un proyecto: 

git clone [email protected]:ddp-team/release-notes.git

Haga lo mismo para cada proyecto que quiera clonar.

Descarga de modificaciones desde el repositorio Git remoto

Para actualizar su copia local con los cambios hechos por otros, entre en el subdirectorio del manual correspondiente y ejecute esta orden: 

git pull

Obtención de privilegios de actualización (de «push»)

Cualquiera que desee participar en la escritura de manuales, FAQ, HOWTOs, etc., puede obtener privilegios de actualización (de «push»). Generalmente solo le pedimos que haya enviado previamente un par de parches útiles. Después de eso, siga estos pasos para solicitar acceso de escritura:

  1. Cree una cuenta en Salsa si no dispone ya de una.
  2. Vaya al repositorio del DDP y haga click en Request Access.
  3. Envíe un correo electrónico a [email protected] y coméntenos cómo ha contribuido al proyecto Debian.
  4. Una vez que su solicitud haya sido aprobada, formará parte del equipo del DDP.

Mecanismo de actualización automática

Todos los manuales se publican como páginas web. Se generan automáticamente en www-master.debian.org como parte del proceso ordinario de generación del sitio web, que tiene lugar cada cuatro horas. Durante este proceso, se descarga desde el archivo la última versión de los paquetes, se recompila cada manual y se transfieren todos los ficheros al subdirectorio doc/manuals/ del sitio web.

Los ficheros de documentación generados por el script de actualización se encuentran en https://www.debian.org/doc/manuals/.

Los ficheros de «log» generados por el proceso de actualización se encuentran en https://www-master.debian.org/build-logs/webwml/ (el script se llama 7doc y se ejecuta como parte del trabajo cron often).