¿Qué son los archivos «dist»?

Est artículo se considera como un archivo histórico y está reemplazado por «¿Dónde poner los archivos de esqueletos?»

Como ya sabrás (si no, lee el tutorial y o el manual de referencia) el sistema de esqueletos está basado en archivos .html que contienen la presentación gráfica del sitio. Por ejemplo «article.html» presenta los artículos, «rubrique.html» presenta las secciones...

Ahora bien, nos dimos cuenta que frecuentemente quienes manipulaban su sitio público modificando estos archivos .html distribuidos con SPIP, encontraban problemas al actualizarlo, si previamente no habían tenido la precaución de hacer una copia de seguridad de los archivos modificados.

En efecto, al reinstalar todos los nuevos archivos distribuidos con SPIP, estos reemplazan pura y simplemente los archivos modificados (olvidando hacer una copia de seguridad de sus modificaciones).

Desde [SPIP 1.8], los archivos .html están mejor ordenados. Una carpeta dist está destinada a los ficheros que vienen con la distribución de SPIP. Estos ficheros contienen la información sobre la paginación «por omisión» del sitio y no deberían ser modificados.

Así, una persona que quiere crear su propia paginación, desarrollará sus archivos article.html, rubrique.html, etc. en la raíz del sitio o, mejor aún, en la carpeta squelettes dedicada a tal efecto. Si se actualiza la distribución de SPIP, sólo los archivos en dist serán remplazados y la webmestre no perderá sus personalizaciones.

Nota: Les archivos .php3, parejas de los archivos .html de un esqueleto SPIP, deben quedar siempre en la raíz del sitio [1].

Histórico: Desde [SPIP 1.3] y hasta [SPIP 1.7.2], los archivos de esqueletos que venían en la distribución de SPIP estaban en la raíz del sitio y se denominaban «article-dist.html», «rubrique-dist.html», y así sucesivamente. Para personalizar estos archivos alcanzaba con primero renombrarlos «article.html», «rubrique.html», etc. (sin el -dist).

Para ir más lejos

Desde [SPIP 1.8], SPIP busca los ficheros .html de los esqueletos primero en la raíz del sitio, y luego, si no existen en la raíz, en la carpeta squelettes. Como último recurso, SPIP toma los archivos por omisión de la carpeta dist.

Nota: Además, si se define una variable de personalización $dossier_squelettes como se explica en la documentación correspondiente, SPIP buscará los archivos de esqueletos prioritariamente en esta sub-carpeta, antes que en todas la precedentes.

Este es el orden (por prioridad decreciente) en el que son utilizados los ficheros de esqueletos según su nombre:

-  rubrique=10.html : si este fichero existe, sólo se aplica a la sección (rubrique) número 10;

-  si este fichero no existe, entonces SPIP busca si hay un fichero denominado rubrique-10.html, si éste existe, la sección (rubrique) 10 y sus sub-secciones lo utilizan, pues es «recursivo»;

Nota: Para que se tengan en cuenta estos ficheros,es necesario que el fichero por omisión (rubrique.html) se encuentre en el mismo directorio.

-  si este archivo no existe, SPIP busca si existe uno denominado rubrique.html que se aplica a todas las secciones del sitio que no están relacionados con los archivos indicados anteriormente;

Histórico: Hasta [SPIP 1.7.2], si este archivo no existe, SPIP utiliza entonces el archivo rubrique-dist.html que es el que se distribuye por omisión. Si quieres modificarlo renombralo como rubrique.html, de tal manera que no se borren tus modificaciones en la próxima actualización de SPIP.