Nota: La página original es más nueva que esta traducción.
El Proyecto de Documentación de Debian almacena sus páginas web y gran parte de sus manuales en el servidor CVS de Debian, en cvs.debian.org.
Cualquier persona puede descargar los ficheros fuente del servidor CVS. Sólo los miembros del Proyecto de Documentación de Debian pueden actualizarlos.
Puede utilizar una interfaz viewCVS para acceder a ficheros individuales mediante la web y ver sus cambios en http://cvs.debian.org/?cvsroot=debian-doc
En caso de querer descargar un manual completo, a menudo es mejor acceder directamente al servidor CVS. Para ello será necesario tener instalado el paquete cvs en su máquina.
Para conectarse, introduzca la orden:
cvs -d :pserver:anonymous@cvs.debian.org:/cvs/debian-doc login
y pulse intro cuando se le pida una contraseña.
Una vez conectado, podrá utilizar las órdenes habituales de CVS
(consulte las páginas info
de CVS) para obtener copias de ficheros,
pero no podrá hacer cambios y enviarlos.
Para bajar los ficheros la primera vez, cree un directorio para guardarlo todo e introdúzcase en él. Dentro de este directorio, se crearán dos nuevos directorios, CVS y ddp.
Utilice la siguiente orden para bajar todos los ficheros:
cvs -d :pserver:anonymous@cvs.debian.org:/cvs/debian-doc -z3
checkout ddp/manuals.sgml
Esto creará el arbol de directorios y lo llenará.
Para actualizar su copia local con los cambios que haya hecho otra gente, introdúzcase en el directorio ddp/manuals.sgml y ejecute la orden:
cvs -z3 update -d -P
Una vez haya terminado la sesión con CVS, puede utilizar la siguiente orden para cerrar la conexión con el servidor:
cvs logout
Antes de acceder al servidor CVS con este método debe tener permisos de escritura en el servidor. Por favor, lea cómo solicitar permiso de actualización si no lo tiene.
Para conectar, introduzca la siguiente orden:
cvs -d :pserver:userid@cvs.debian.org:/cvs/debian-doc login
e introduzca la contraseña que haya acordado con el coordinador de la documentación. En la orden anterior, reemplace userid por su identificador de usuario en el servidor de contraseñas del CVS. Este no tiene por que ser el mismo que su identificador de usuario en cvs.debian.org, si es que tiene uno.
Una vez conectado, podrá utilizar las órdenes habituales de CVS (consulte las páginas info de CVS) para obtener copias de ficheros y enviarlos.
Para bajar los ficheros la primera vez, cree un directorio para guardarlo todo e introdúzcase en él. Dentro de este directorio, se crearán dos nuevos directorios, CVS y ddp.
Utilice la siguiente orden para bajar todos los ficheros:
cvs -d :pserver:userid@cvs.debian.org:/cvs/debian-doc -z3 checkout
ddp/manuals.sgml
Esto creará el arbol de directorios y lo llenará.
Para actualizar su copia local con los cambios que haya hecho otra gente, introdúzcase en el directorio ddp/manuals.sgml y ejecute la orden:
cvs -z3 update -d -P
Una vez haya terminado la sesión con CVS, puede utilizar la siguiente orden para cerrar la conexión con el servidor:
cvs logout
Este método está disponible únicamente para los desrrolladores de Debian y es preferible a la utilización de pserver descrito arriba. Si usted acaba de convertirse en desarrollador, por favor póngase en contacto con el coordinador de la documentación para eliminar su cuenta de pserver.
Para conectarse con ssh, en primer lugar hay que decírselo a CVS con:
export CVS_RSH=ssh
A continuación cree un directorio para guardarlo todo e introdúzcase en él. Entonces introduzca la orden:
cvs -d :ext:userid@cvs.debian.org:/cvs/debian-doc -z3
checkout module
En esta orden, cambie userid por su identificador en el servidor CVS. Es el mismo que para todas las máquinas de Debian. Reemplace module por el nombre del módulo del que quiera hacer una copia, que normalmente será ddp/manuals.sgml. Entonces se le pedirá su contraseña. No confunda ésta con la de su propia máquina.
Se crearán dos directorios en el directorio actual, CVS y ddp. CVS creará de manera recursiva cualquier módulo (directorio) que usted haya pedido y lo rellenará con los ficheros correspondientes.
Ahora podrá utilizar las órdenes habituales de CVS (consulte las páginas info de CVS) para obtener copias y enviar ficheros.
Para actualizar su copia local con los cambios que haya hecho otra gente, introdúzcase en el directorio ddp/manuals.sgml y ejecute la orden:
cvs -z3 update -d -P
Cualquiera que desee participar en la redacción de los manuales puede conseguir privilegios de actualización. Normalmente pedimos que haya enviado un par de parches útiles primero.
Para obtenerlos, necesita enviar una petición a la lista de correos de la documentación de Debian. Por favor, explique por qué necesita el acceso. Ya sea el coordinador de documentación o un miembro importante del equipo de documentación necesita aprobar su petición antes que le sea otorgado el acceso. Una vez que le han aprobado la petición, debe pedirles que envíen una solicitud (firmada) a debian-admin.
Si usted es un desarrollador oficial de Debian, una vez que su solicitud sea aprobada, será agregado al grupo cvs_doc en cvs.debian.org y le será posible actualizar el árbol CVS desde ese momento.
Si no es desarrollador oficial de Debian, una vez que su petición fue aprobada, necesitará proveer un nombre de usuario y una contraseña. El nombre de usuario deberá ser diferente al de cuentas existentes de Debian (por favor verifique con db.debian.org). La contraseña debe ser enviada en un correo cifrado, aún cuando cvs lo envía a través de una red no cifrada.
Puede utilizar makepasswd para generar su contraseña, simplemente instale ese paquete y ejecute:
$ echo "SECRETO" |makepasswd --clearfrom=- --crypt
Otra forma simple de cifrar una contraseña es usando un script Perl de una sola línea, sabiendo que Perl ya está instalado en su máquina Debian GNU/Linux:
$ perl -e "printf \"%s\n\", crypt ("SECRETO", join ('', ('.', '/', 0..9, 'A'.. 'Z', 'a'..'z')[rand (64), rand (64)]))"
Por favor envíe el resultado, junto con su nombre de usuario preferido, a Martin Schulze. Encripte el correo completo con su llave GnuPG.
Para mayor información, por favor lea sus anotaciones al respecto.
El siguiente gráfico muestra la estructura del árbol de directorios del CVS:
Por favor, observe que el sitio web DDP se encuentra en el módulo webml del repositorio CVS de Debian, para su integración con el resto de páginas web de Debian.
Las páginas del texto del manual se generan por una tarea de cron ejecutada en www-master.debian.org cada día, en algún momento tras las 15:39, hora del Pacífico.
El script realiza un cvs update -d -P, y entonces un
make -C manuals.sgml clean publish, ambos en el directorio
ddp.
El fichero makefile está configurado para reconstruir cada subdirectorio
(que contenga documentación mantenida), y para instalar los ficheros de cada
subdirectorio en el subdirectorio doc/manuals/ del sitio web.
Los archivos makefile de cada subdirectorio se obtienen a partir de
ddp/manuals.sgml/standard.makefile.
Los ficheros de documentación generados por el script de actualización los podrá encontrar en http://www.debian.org/doc/manuals/.
Los ficheros de registro (log
) generados por el script los
encontrará en http://www-master.debian.org/build-logs/ddp/