Proyecto de documentación de Debian SVN

El proyecto de documentación de Debian almacena sus páginas web y gran parte del texto de los manuales en el servidor Debian Subversion svn.debian.org y en el servidor Debian Git git.debian.org. svn.debian.org y git.debian.org son parte de la instalación Gforge en alioth.debian.org. Puede consultar la documentación de Alioth para más información sobre el funcionamiento de este servicio.

Cualquiera puede descargar los fuentes almacenados en el servidor SVN/Git. Solo los miembros del proyecto de documentación de Debian pueden actualizarlos.

Acceso a los fuentes en SVN

Puede utilizar una interfaz web para acceder a los ficheros individualmente y ver las modificaciones realizadas, en https://anonscm.debian.org/viewvc/ddp/manuals/trunk/

Para descargar un manual completo, el acceso directo al servidor SVN suele ser una opción mejor. Necesita el paquete subversion en su máquina.

Conexión de forma anónima (sólo-lectura) al servidor SVN

Use esta orden para descargar todos los ficheros:

svn co svn://svn.debian.org/svn/ddp/manuals/trunk manuals

Esto creará los directorios y descargará su contenido, recursivamente.

Para actualizar su copia local con los cambios hechos por otros, entre en el directorio manuals y ejecute la orden:

svn export --force svn://svn.debian.org/svn/ddp/manuals

Conexión al servidor SVN con privilegios de actualización (svn)

Antes de acceder al servidor SVN por este método le han tenido que conceder acceso de escritura. Por favor, lea antes cómo solicitar permiso de actualización.

Use esta orden para descargar todos los ficheros:

svn co svn+ssh://svn.debian.org/svn/ddp/manuals/trunk manuals

Esto creará los directorios y descargará su contenido, recursivamente.

Para actualizar su copia local con los cambios hechos por otros, entre en el directorio manuals y ejecute la orden:

svn update

Conexión al servidor SVN con privilegios de actualización (git-svn)

Antes de acceder al servidor SVN por este método le han tenido que conceder acceso de escritura. Por favor, lea antes cómo solicitar permiso de actualización.

Use esta orden para descargar todos los ficheros:

git svn clone -s -rHEAD svn+ssh://svn.debian.org/svn/ddp/manuals manuals

Esto creará los directorios y descargará su contenido, recursivamente, y también creará un repositorio local git, sin historial, que puede seguir al servidor SVN alioth.

Para actualizar su copia local con los cambios hechos por otros, entre en el directorio manuals y ejecute la orden:

git svn rebase

Obtención de privilegios de actualización

Cualquiera que desee participar en la escritura de manuales puede obtener privilegios de actualización. Generalmente, solo pedimos que quien los solicita haya enviado previamente un par de parches útiles.

Una vez creada su cuenta en Alioth, solicite privilegios de actualización pulsando en Request to join («solicitud de ingreso») en la parte inferior derecha de la página https://alioth.debian.org/projects/ddp. Asegúrese de incluir en la casilla para comentarios las razones por las que necesita acceso. A continuación envíe un correo electrónico a debian-doc@lists.debian.org exponiendo el historial de su trabajo en Debian.

Una vez que su solicitud sea aprobada, formará parte del proyecto ddp (y del grupo Unix) en Alioth.


Mecanismo de actualización automática

Las páginas web que contienen el texto de los manuales se generan en www-master.debian.org como parte del proceso ordinario de generación del sitio web, proceso que tiene lugar cada cuatro horas.

El «script» ejecuta la orden svn export --force svn://svn.debian.org/svn/ddp/manuals y, a continuación, make -C trunk publish.

El «makefile» está configurado para generar cada subdirectorio (que contenga documentación en desarrollo), y para instalar los ficheros de cada subdirectorio existente bajo el directorio doc/manuals/ del sitio web. Los «makefiles» de los subdirectorios se derivan del manuals/standard.makefile.

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 «script» de actualización se encuentran en https://www-master.debian.org/build-logs/ddp/

Tenga en cuenta que este proceso genera de nuevo el directorio /doc/manuals/. El contenido del directorio /doc/ se genera, bien a partir de «webwml», bien con otros «scripts», como los que extraen ciertos manuales de sus paquetes.