Este documento describe el servicio de web que prestamos, incluyendo información sobre cómo crear espejos y cómo operar nuestro repositorio, con el propósito de coordinar el trabajo en él.
Nuestro servicio de web es el fruto del trabajo voluntario de miembros de nuestra comunidad con el objetivo de distribuir información actualizada y completa relacionada con el software libre en nuestro país.
Dentro de nuestro web site usted encontrará información relacionada con los siguientes tópicos sobre software libre:
Si desea contribuir con el trabajo en nuestro sitio puede suscribirse a la lista colibri-www, enviando un correo electrónico a majordomo@bachue.com que diga "subscribe colibri-www" en el cuerpo del mensaje (no en el asunto).
En un correo a ésta lista puede contarnos las razones por las que desea contribuir y la clase de contenidos en los que desea trabajar. Con gusto le atenderemos. En este caso le recomendamos que revise la siguiente sección de este documento.
El logotipo de Colibrí fue creado por
Javier Moreno
utilizando POV-Ray.
Puede obtenerlo en distintos tamaños
(40x48, 2.0K,
100x119, 5.5K,
211x252, 16K
y
407x504, 44K)
en formato PNG y utilizarlo para
hacer un enlace a nuestro sitio.
Adicionalmente puede descargar el
código fuente utilizado para generarlo.
Para trabajar en nuestro sitio de web utilizamos Subversion en el servidor que amablemente nos ofrece para este propósito Nimonic LTDA.
Los contenidos completos del repositorio pueden ser consultados en http://sanmarcos.nimonic.com/svn/colibri/. Ahí encontrará todos los archivos en su última versión.
También puede consultar <http://sanmarcos.nimonic.com/cgi-bin/viewcvs.cgi/?root=colibri>, donde podrá consultar la historia de modificaciones de cada archivo (a través del programa ViewCVS).
Ahora bien, si desea usar una copia local del repositorio debe seguir los pasos siguientes:
En esta sección se explican los comandos utilizados por los voluntarios que trabajan en nuestro sitio de web. Para poder ejecutarlos deberá asegurarse de tener instalado Subversion.
Para retirar nuestros contenidos del repositorio puede utilizar el comando de «checkout»:
$ svn checkout http://sanmarcos.nimonic.com/svn/colibri
Éste creará el subdirectorio colibri en el directorio actual y colocará en él una copia local de la última versión de los contenidos del repositorio.
Si en el futuro desea actualizar su copia local, no necesita hacer checkout de nuevo: basta con que ejecute el siguiente comando (de «update») dentro del directorio en el que ésta se encuentre (colibri).
$ svn update
La diferencia entre hacer update y checkout es que únicamente se transferirán los cambios que se hayan hecho a los archivos desde la última vez que actualizó su copia, por lo que el proceso consumirá menos recursos y será más rápido.
Si efectua modificaciones a los archivos de su copia local y tiene una cuenta para escribir en el repositorio (lo que implica que su nombre aparecerá en la lista de webmasters), ejecute el siguiente comando para que tengan efecto en el repositorio:
$ svn commit
Subversion revisará los archivos en búsqueda de modificaciones, ejecutará su editor de texto predeterminado (según la variable de entorno $EDITOR) para que describa los cambios, le pedirá su contraseña para autenticarlo con el servidor y procederá a actualizar la versión del repositorio con respecto a su copia local.
Note que sus cambios serán efectuados sobre nuestro repositorio, por lo que tomará algún tiempo que los espejos de web del sitio se actualicen y reflejen sus modificaciones.
Si aún no tiene cuenta para escribir en el repositorio puede efectuar cambios en su copia local y utilizar el siguiente comando para generar un archivo describiendo las modificaciones realizadas:
$ svn diff > archivo.diff
Subversion comparará su copia local con la versión original del repositorio (esta versión "limpia" está almacenada en el subdirectorio .svn de su copia local) y describirá los cambios efectuados en el archivo archivo.diff (estos archivos de diferencias suelen llamarse ``parches'').
Puede enviar su parche a colibri-www@bachue.com (vea la sección anterior para obtener información de cómo suscribirse a la lista). En este caso, le recomendamos que incluya la cadena ``[PATCH]'' al comienzo del asunto (subject) de su mensaje (seguido por una descripción de los cambios propuestos), para indicarnos que éste incluye un parche. Nuestros webmasters revisaran gustosamente sus cambios, le notificarán sobre posibles correcciones y, si el parche es considerado apropiado, aplicarán sus cambios a la versión oficial en el repositorio.
Si requiere más información acerca de la utilización de Subversion, puede consultar el FAQ o el libro Subversion: The Definitive Guide.
Lo invitamos a que crée un copia (espejo) de nuestro sitio web en su servidor o el de su comunidad.
Para ésto, basta con que haga checkout de nuestro repositorio (ver sección anterior) una sola vez y se asegure de que periódicamente se haga update (por ejemplo, utilizando cron). Por favor haga que el tiempo entre cada actualización de su espejo no sea menor de un día.
Si crea algún espejo de nuestro sitio web, por favor infórmenos de su dirección y cada cuánto se actualiza para incluirlo en nuestra lista de espejos.
