| Libro blanco de las tecnologías de documentación de LuCAS: Descripción, funcionamiento, herramientas y futuro del proyecto de documentación LuCAS | ||
|---|---|---|
| Anterior | Creación en LuCAS: Ejemplos | Siguiente |
Cuando un proyecto no desarrollado en LuCAS quiere sacar provecho de los recursos de este último para su difusión o mejora, el único rol que nos interesa es el del responsable de la integración, que normalmente será la misma persona que coordinó el proyecto original.
El coordinador deberá conocer técnicamente, aparte de su propio proyecto y herramientas asociadas, las utilizadas en LuCAS:
Usará CVS para enviar sus modificaciones a la base de trabajo general de LuCAS. Estas modificaciones afectarán a guiones de shell que realizan réplicas automáticas, a páginas escritas en WML (Website Meta Language) y probablemente algunos otros como los makefiles.
La idea es que el coordinador de la integración trabaje de manera totalmente autónoma sobre el árbol de ficheros de LuCAS, sin necesitar casi en ningún momento la intervención de ningún coordinador general de LuCAS.
En resumen, el trabajo consistirá en,
programar una réplica de su trabajo contenido en otro servidor
y crear la página WML del proyecto.
El coordinador deberá programar una réplica automática en LuCAS de sus ficheros contenidos en su servidor.
La réplica irá contenida en el primer nivel del árbol de ficheros de LuCAS, es decir, si su proyecto se llama MiProyecto, será accesible la réplica desde la URL http://lucas.hispalinux.es/MIPROYECTO/.
Para ello el coordinador modificaría, por ejemplo, el guión de shell replica-otros.sh, disponible en el directorio cron del CVS de LuCAS, utilizando para replicar la aplicación wget, rsync, mirror.pl o incluso el propio cvs.
El guión es ejecutado de manera automática todos los días, de manera que el coordinador deberá ver reflejado el efecto al día siguiente.
Debe crearse una página WML para facilitar a los usuarios de las páginas de LuCAS la navegación por la réplica.
A veces es adecuado empotrar algo de código PERL en la página WML, de manera que la página HTML final se generará a partir del contenido del directorio replicado reduciendo el trabajo de mantenimiento.
También debe modificarse, en su caso, la página Imenu.wml para crear una entrada de menú que apunte a la nueva página.
La página de apoyo se creará en el directorio wml del árbol CVS principal.
La actualización del servidor web es hecha de manera automática una vez al día, de manera que el coordinador puede observar el efecto esperando 24 horas.
También puede montarse si lo desea una «maqueta» del web de LuCAS en su sistema, para poder probar lo que está haciendo antes de enviarlo al servidor principal.
Los coordinadores generales de LuCAS somos conscientes de que esto no es trivial, por lo que estamos siempre disponibles para ayudar a los coordinadores en sus primeros contactos con el sistema.