El LDP se propone ofrecer acceso CVS a sus autores. Buenas razones para ello serían las siguientes:
CVS mantendrá una copia de respaldo local de sus documentos. En caso de que desee enviar un documento a otro autor, éste podrá simplemente recuperarla en CVS y trabajar con ella. Si necesita volver a una versión anterior del documento, también podrá obtenerla en CVS.
Es una herramienta magnífica para un grupo de personas que trabaja en el mismo documento. CVS le dirá qué cambios ha hecho otro autor mientras Usted editaba su versión y le permitirá integrar dichos cambios.
Guarda un registro de todos los cambios realizados. Estos registros (y las fechas correspondientes) pueden incorporarse automáticamente en el documento haciendo uso de ciertas etiquetas especiales procesadas antes que el procesador SGML.
Proporciona medios para que un programa actualice automáticamente el sitio web de LDP, incorporando nueva información a medida que ésta se redacta y se envía. Aún no disponemos de esta opción, pero es uno de nuestros objetivos. Por el momento, las actualizaciones de CVS van indicando al coordinador de los CÓMO que debe actualizar el sitio web, por lo que si utiliza CVS, no tendrá que enviar un e-mail con su código SGML.
Si está utilizando CVS por primera vez, las siguientes páginas web le serán de gran ayuda:
En primer lugar, tendrá que abrir una cuenta en el repositorio CVS de LDP. Este es el directorio raíz que CVS utiliza para diferentes proyectos (CÓMOs, mini CÓMOs, etc), que a su vez constituyen subdirectorios de él.
Para esto tendrá que crear una contraseña con hash y un nombre de usuario. El hash de la contraseña le permitirá enviar una contraseña cifrada que el grupo CVS no conocerá. Podrá efectuar esto, haciendo uso de la orden siguiente (desde bash o sh):
bash$ echo your_password | perl -e "print crypt(<>,\ join '',('.', '/', 0..9, 'A'..'Z', 'a'..'z')[rand 64, rand 64]),\"\n\"" |
Envíe la salida de esta orden con su nombre de usuario a: <cvsadmin@cvslist.linuxdoc.org>. De este modo, se creará su propio directorio CVSROOT, y recibirá una respuesta por e-mail. Cuando reciba esta respuesta, acceda a su CVSROOT y asegúrese de que todo está configurado correctamente:
bash$ export CVSROOT=:pserver:su_identificador@cvs.linuxdoc.org:/cvsroot bash$ cvs -d $CVSROOT login |
(Sustituya su_identificador con lo que se le envió en el correo de respuesta).
Se le pedirá que especifique su contraseña, y, posteriormente, se le dará acceso en modo de lectura-escritura al repositorio de CVS. Una vez haya accedido al sistema mediante cvs login, su contraseña se almacenará en .cvsroot y no tendrá que volver a utilizar cvs login. Configure CVSROOT y continúe. Puede acceder al repositorio completo de linuxdoc mediante la siguiente orden:
bash$ cvs get LDP |
También puede acceder al fuente de SGML de su documento mediante las órdenes:
bash$ cvs get howto/YOUR-HOWTO.sgml bash$ cvs get minihowto/YOURDOC.sgml |
Si no necesita abrir una cuenta en CVS (por ejemplo, si lo que desea es publicar documentación del LDP), puede acceder anónimamente al repositorio en modo lectura. Para ello, deberá utilizar la siguiente orden:
bash$ cvs -d :pserver:cvs@anoncvs.linuxdoc.org:/cvsroot login |
Utilice cvs como contraseña. Puede acceder a los módulos de linuxdoc como se ha mencionado anteriormente. Tenga en cuenta que los cambios en el sitio anoncvs pueden retrasarse una media hora con respecto al sitio principal.
Puede acceder al repositorio de CVS a través de la red, en http://cvsweb.linuxdoc.org/index.cgi/linuxdoc.
Podrá obtener una lista de interfaces gráficas para CVS en http://freshmeat.net/appindex. Busque CVS.
CVS dispone de una etiqueta especial, $Id, que le permite insertar automática y directamente la fecha y la versión en el documento. Al utilizarla, CVS la convertirá en $Id: HOWTO-HOWTO.sgml,v 1.4 2000/06/12 20:49:54 markk Exp $. Al incluirse esta etiqueta en un documento, aquella información se actualizará cada vez que se modifique el fichero, incrementándose, asimismo, la marca de revisión.
Cuando esté listo para enviar los cambios al servidor CVS, utilice la orden cvs ci -m "comentario" SU-CÓMO.sgml. El -m "comentario" no es necesario, pero si no lo incluye, se abrirá el editor (normalmente, vi, o el especificado en su variable de entorno EDITOR ) y se le dará la oportunidad de añadir comentarios sobre los cambios.
En la lista ldp-discuss, podrá estar al tanto de cuestiones relacionadas con CVS. Por ahora, los envíos a LDP deberán remitirse a <ldp-submit@lists.linuxdoc.org>.