Los ficheros necesarios para generar la página están albergados en un módulo de SVN llamado web-xml (próximamente se podrá acceder de forma anónima a este módulo).

En el directorio raíz del módulo se pueden encontrar los siguientes ficheros:

catalog.xml

Fichero en XML que indica a los procesadores de hojas de estilo y verificadores de XML dónde encontrar los distintos ficheros auxiliares que necesitan (como los DTD o las hojas XSL).

Makefile

El fichero de reglas que indica a la herramienta make cómo generar la página a partir de los fuentes proporcionados.

Makefile.documentos

Un fichero de reglas auxiliar (es incluido desde el Makefile principal) que contiene las instrucciones para generar los documentos.

layout.xml

En este fichero, también en sintaxis XML, se especifican las páginas que forman parte de la web, así como su estructura lógica (en forma de árbol).

También se pueden encontrar los siguientes subdirectorios:

build

Este directorio no existe en el SVN, pero se crea durante la generación de la página mediante la herramienta make. Aquí se colocan los ficheros listos para instalar, es decir, los ficheros generados. Dentro de build se pueden encontrar otros cuatro subdirectorios: pages contiene las páginas XHTML, docs contiene los documentos en otros formatos (PDF, texto, etc.), xml contiene los documentos fuente XML después de transformarlos para ofuscar las direcciones de correo, y xsl-docbook-website contiene las hojas de transformación de Norman Walsh después de adaptarlas.

css

Contiene las hojas de estilo CSS.

merge

Los contenidos de este directorio son directamente copiados a build durante la generación de las páginas. Por eso, este directorio es ideal para colocar ficheros auxiliares, como robots.txt.

php

Los contenidos de este directorio son copiados al subdirectorio php de build, por tanto, es un buen lugar para colocar ficheros en PHP que contengan rutinas de utilidad.

xml

Las páginas, descritas en XML. Están contenidas en distintos subdirectorios, que no coinciden necesariamente con la forma final de las URLs, ya que el fichero layout.xml podría especificar una localización diferente.

xsl

Las distinas hojas de transformación. La hoja principal para transformar las páginas a XHTML es general.xsl, que a su vez incluye plantillas contenidas en los ficheros tablas.xsl, util.xsl e imagenes.xsl.

Las hojas website-a-html-plano.xsl y website-a-latex.xsl se utilizan para transformar los documentos, respectivamente, a HTML y LaTeX.

Otras dos hojas de estilo se utilizan para generar la información que complementa los Makefiles. Son las hojas custom-makefile-dep.xsl y extrae-lista-documentos.xsl.

Por último, la hoja html2xhtml.xsl fue creada por Norman Walsh, aunque se incorpora aquí ligeramente retocada. Su objetivo es transformar las hojas de Norman Walsh para que generen XHTML en lugar de HTML. De este modo, no es necesario meter estas últimas en el SVN, porque se pueden generar cada vez que sean necesarias.