Información para Webmasters

Introducción

Las tecnologías y programas usados para mantener la página web de la FSFE pueden ser familiares para muchos desarrolladores y autores y pueden ser de interés a aquellos que aun no los han descubierto.

Traductores y voluntarios ocasionales pueden que sólo entren en contacto con

• Savannah, para el servicio de CVS y la gestión de permisos de acceso.
• XHTML, con el cual las páginas estáticas se generan cada cinco minutos.
• Concurrent Version System (CVS), para coordinación y sincronización.

Los voluntarios interesados en profundizar en el mantenimiento deben estar familiarizados con

• Perl, para el mantenimiento y creación de scripts.
• Apache, como servidor web.

Comprender cómo se crean las páginas

Las páginas web de www.fsfeurope.org se mantienen como un conjunto de archivos XML. El servidor web genera las páginas HTML a partir de estos archivos XML automáticamente cada cinco minutos. Consecuentemente, toda la edición de las páginas se hace en archivos XML, y nunca se edita directamente el HTML.

Cada página en www.fsfeurope.org se denomina «nombre.idioma.html» (idioma proviene de las dos letras del código iso-639 de idiomas, tal como «es» para español o «de» para alemán). Los archivos fuente se nombran «nombre.idioma.xhtml».
Algunas páginas tienen partes dinámicas: aparte de los textos fijos tomados del archivo .xhtml, incluyen información desde uno o varios archivos .xml. Una vez que la página está construida, el sistema de construcción toma el archivo .xml traducido cuando sea posible; y en caso contrario la versión inglesa en aquellos archivos.xml que aun no han sido traducidos. De esta manera, ciertas páginas pueden terminar con partes de texto traducido y otras que se muestra aun en inglés. Ejemplos de estas páginas incluyen la portada, la página de noticias y la página de eventos.

Registrarse en savannah

El código fuente de las páginas web está almacenados en Savannah, un servidor hospedado por la Free Software Foundation, nuestra organización hermana en América del Norte. Para conseguir acceso de escritura a estos archivos debe crear una cuenta en este servidor.

Registrar una nueva cuenta

Siga este vínculo para registrar una cuenta nueva. Elija un nombre, una contraseña, rellene con su nombre real y su dirección de correo y pulse en el botón «Submit».

Entonces recibirá un correo electrónico desde savannah. Para poder completar su registro visite la URL mencionada en él. La cuentas no confirmadas antes de dos días se borrarán de la base de datos.

Después de confirmar su cuenta, puede entrar en https://savannah.gnu.org con su nombre y su contraseña.

Crear una clave SSH

Mientras puede usar la contraseña para entrar en el portal en Savannah, debe registrar una clave SSH para conseguir acceso CVS. Esto debe hacerse en cada máquina desde la cual vaya a acceder al repositorio CVS.

Para crear y registrar una clave SSH, siga las siguientes instrucciones proporcionadas en el FAQ de Savannah.

Unirse al proyecto FSFE

Hay muchos proyectos hospedados en Savannah, y el acceso CVS se garantiza individualmente por cada proyecto. Para conseguir acceso a los archivos fuente de la página web de la FSFE debe hacerse miembro del proyecto FSFE.

Elija «Group Membership» en las solapas superiores. Ahora introduzca «FSFE» e la caja de búsqueda «Request for Inclusion», active el control FSF Europe e introduzca un comentario.

Los administradores del proyecto FSFE recibirán un correo con su petición y el comentario. Pudiendo aprobar su inclusión en el proyecto. Despues de esto podrá ver «FSF Europe» en «Groups I'm Contributor of» tras su entrada en savannah.

Descargando el repositorio por primera vez

Primero debe asegurarse de que su archivo ~/.bashrc contiene una línea que diga
export CVS_RSH=ssh
luego cree un directorio para el repositorio y ejecute
$ cvs -z3 -d username@cvs.savannah.gnu.org:/web/fsfe co .
en ese directorio. Entonces se le pedirá su contraseña SSH. Introdúzcala y confirme. Si todo está bien, el sitio web se descargará.

Trabajando con el repositorio

Después de descargar el repositorio por primera vez, debe ejecutar
$ cvs update -d
en el directorio fsfe antes de cada vez que trabaje con un archivo.

Si desea añadir nuevos archivos al repositorio debe ejecutar
$ cvs add nombre del archivo

Para publicar sus cambios en el servidor, tanto si es un archivo nuevo o una modificación de uno existente, ejecute
$ cvs commit nombre de archivo
y un editor se abrirá para permitir introducir una descripción de sus cambios.

Puede descargar un detallado manual de CVS en la página de CVS.

Si desea saber todas las modificaciones que se hacen en los fuentes fuentes de la página web puede suscribirse a la lista de correo de notificación CVS. Recibirá un correo por cada cambio publicado.

Manejo responsable del acceso de escritura

Si tiene derechos de escritura a las páginas web, subscríbase a la lista de correo de webmasters.

Tenga en cuenta que todos sus cambios serán efectivos y visibles automáticamente, sin ninguna intervención posterior de nadie. En consecuencia, hay algunas cosas que le pedimos hacer siempre que realice cambios o con los nuevos archivos:

• La FSFE mantiene la responsabilidad sobre el contenido de las páginas web. No ejecute modificaciones que cambien el sentido del texto sin la aprobación de un miembro del equipo principal de la FSFE. (Esto no es necesario para traducciones de contenido ya existente)

• Si está publicando traducciones, y existe alguna posibilidad de que otros puedan corregirlas, use esta oportunidad. Puede usar la lista de correo de traductores para pedir que revisen su traducción. Si está traduciendo archivos o corrigiéndolos, le animamos a corregirlos ortográficamente usando herramientas automáticas como GNU aspell, ispell o su corrector ortográfico favorito. Por ejemplo, para usar GNU aspell en un sistema Debian GNU/Linux, simplemente instale los paquetes aspell y aspell-XX (donde «XX» es el código de su idioma), y ejecute la orden

  aspell -H -d language -c file.xhtml

  (donde «language» es el nombre del diccionario de su idioma; la opción -d puede omitirse si su UNIX local es el mismo del idioma del diccionario).

• Asegúrese de que todos los archivos sean realmente XML. Hay un script de nombre tools/validate.pl que ayuda a encontrar errores en el markup. Los XML incorrectos rompen el proceso automático de construcción de las páginas web y bloquean las actualizaciones completas del sitio web de la FSFE. Si sospecha que el proceso de construcción esta roto, puede ver el registro de la última ejecución de construcción aquí.

  El script validate.pl requiere el módulo Perl XML::LibXML; si no está instalado en su sistema, puede validar arachivos usando su validador XML favorito. Por ejemplo puede usar la utilidad de línea línea de órdenes xmllint del proyecto libxml2 (si está usando la distribución Debian GNU/Linux, instale el paquete libxml2-utils); ejecute la orden

  xmllint --noout file.xhtml

  y observe los posibles mensajes de error.

• Asegúrese de que la codificación del archivo es consistente con el contenido del atributo «encoding» declarado en la primera línea de cada archivo. Por ejemplo, si si archivo está codificado como «iso-8859-1» (también conocido como codificación «latin-1»), la primera línea debe poner

  <?xml version="1.0" encoding="iso-8859-1" ?>

  Otra codificación válida es la unicode, o codificación «UTF-8». Si quiere cambiar la codificación del archivo, puede usar la utilidad estándar iconv, como en el siguiente ejemplo (que convierte un archivo de «latin1» a codificación «utf-8»):

  iconv -f LATIN1 -t UTF8 inputfile > outputfile

Coordine con otras personas que también tienen acceso de escritura al CVS para estar seguro de que sus traducciones y correcciones entregadas por la gente sin acceso de escritura se publican correctamente después de que hayan sido corregidas. Desde luego, compruebe estos archivos antes de ejecutarlos como si comprobara sus propios archivos.

Más información

Teniendo en cuenta que la página web de la FSFE tiene un ámbito europeo y global y elecciones de usuario de nivel local que suplementan la información para un país específico, la disposición tiene un cierta complejidad que se oculta totalmente para el usuario de la página.

Salvo que solamente desee traducir páginas, vea abajo, asegúrese de mirar la referencia estructural.

También hay un archivo de documentación Texinfo «Webmastering FSF Europe» de Jonas Öberg, que implementa el sistema de construcción de la página. Léalo para conocer más acerca del trabajo con páginas web.

To top