Pablo Iranzo Gómez's blog

jul 01, 2006

Migrar de SPIP 1.8 a 1.9

Introducción a SPIP 1.9

SPIP 1.9 va a traer bastantes mejoras respecto a versiones anteriores, entre ellas:

  • Abandono de la compatibilidad con PHP3 y con ella, las extensiones ".php3" en los ficheros
  • Nueva organización de las carpetas
  • Nuevo sistema para llamar a los esqueletos (dejando de lado también el .php3)
  • Nuevas balizas y filtros
  • Sistema de complementos
  • Nuevos criterios para bucles (incluído uno para paginación)
  • Introducción de algunos elementos de programación AJAX(Desplazan parte de la carga de trabajo del servidor al cliente que visita la página, haciendo que la navegación sea más fluída y el servidor no se sobrecargue)
  • Soporte UTF-8

Proceso de actualización a SPIP 1.9 (de forma limpia)

El proceso lo podemos llevar a cabo de varias formas, tanto por la parte del servidor como por las plantillas, pero teniendo en cuenta una serie de precauciones.

La forma más recomendablem a mi parecer es la siguiente, ya que limpiamos lo que pudiera quedar del SPIP antiguo y mantenemos los datos para la nueva versión.

Una vez preparadas las plantillas para la nueva versión (Ver cambios necesarios más adelante), seguiremos los siguientes pasos:

  • Antes de nada, hacer una copia de seguridad de la base de datos y descargar todos los archivos de la web (esqueletos), spip, etc (por si acaso) y la base de datos que hemos copiado entre ellos.
  • Si hemos personalizado los esqueletos por nosotros mismos, habremos tenido que adaptarlos a la nueva versión (aunque en la mayoría de los casos los antiguos son prácticamente compatibles exceptuando pequeños cambios), si son los estándar, podremos eliminarlos del servidor.
  • De la web, eliminaremos todos los archivos excepto el ecrire/inc-connect.php3, el ecrire/mes_options.php3 y el /mes_fonctions.php3 y estos tres archivos, los renombraremos a ".php", igualmente, mantendremos la carpeta IMG ya que no se modificará y nos ahorrará mucho tiempo de volver a subirlas a la web.
  • Subimos la nueva versión de SPIP descargada de spip.net.

Hasta aquí, tenemos actualizados los ficheros, ahora viene la base de datos, por lo que:

  • Entraremos a http://www.nuestrositio.com/ecrire/ e introduciremos un nombre de usuario y contraseña de un administrador, de este modo al acceder a la parte privada nos pedirá actualizar la versión de la base de datos, crearemos el fichero que nos indique en ecrire/data/ y concluirá la actualización.
  • Lo siguiente es evidentemente... crear una copia de la base de datos ahora ya con la versión 1.9 y salvarla a nuestro equipo por si acaso.
  • Sólo nos queda copiar nuestras plantillas modificadas al servidor tal cual las teníamos con 1.8 y así mantendremos el aspecto original de la web.

  • Si nuestro proveedor soporta el htpasswd, sería recomendable copiar el que viene con spip htpasswd.txt al nombre que nos haya indicado nuestro proveedor (habitualmente ".htpasswd"), así como habilitar las url_propres en ecrire/mes_options.php

Adaptar los esqueletos

Una de las cosas a tener en cuenta, es que con la desaparición de los .php3, han desaparecido también (al formar parte de las mejoras) las parejas de esqueletos .html/.php3, ahora las llamadas a los esqueletos se realizan con el parámetro page=plantilla.html, o con una nueva baliza llamada #URL_PAGE que nos permite crear url's de la forma en la que SPIP las utiliza y que previsiblemente, hará que no tengamos que volver a poner las url's a mano a pesar de los cambios de versión porque podrá encargarse SPIP de adaptarlas a la nueva forma de hacerlo en cada caso.

Por ejemplo, un INCLURE antes se hacía así:

<INCLURE(cabecera.php3){id_rubrique=3}>

y ahora se hace de la siguiente forma:

<INCLURE{fond=cabecera}{id_rubrique=3}>

Al igual que antes, por ejemplo para llamar a un album fotográfico, hacíamos:

<INCLURE(album.php3){id_document=34}>

Ahora, haremos:

<INCLURE{fond=album}{id_rubrique=3}>

que automáticamente spip transformará en:

spip.php?page=album&id_rubrique=3

Este nuevo sistema, además de facilitar la validación XHTML y hacerlo independiente del tipo de URL (propre, html, propres2, etc) que estemos utilizando, permite añadir y eliminar fácilmente parámetros de la url sin más que concatenar |parametre_url'variable',valor, separador o bien, eliminar parámetros sin más que dejar el valor vacío.

En los esqueletos que creemos o modifiquemos emplearemos la baliza #DOSSIER_SQUELETTE/cualquier_contenido cuando queramos referenciar cualquier directorio o archivo que contenga la carpeta de nuestros esqueletos.

Este método, por ejemplo, se usa en la referencia a las hojas de estilo, podremos hacerla de modo que sea independiente del lugar donde las ubiquemos o del nombre que tenga la carpeta, al utilizar la baliza #DOSSIER_SQUELETTE, devolverá la ruta donde estén almacenadas. De este modo, podremos incluir el archivo favicon.ico dentro de la carpeta de las images de nuestras plantillas con #DOSSIER_SQUELETE/images/favicon.ico.

Así mismo, a partir de esta versión podemos indicar la ruta hasta el directorio de las imágenes de forma genérica, dando de este modo libertad para la elección del nombre de las carpetas tales como la de las imágenes utilizadas en la web (anteriormente era obligatorio renombrarla a IMG/).

Otro punto importante, es la posibilidad de crear ficheros local_LANG.php, donde LANG es el código ISO para el idioma, por ejemplo, es fr uk it ca, etc que permiten crear textos propios que serán traducidos a los idiomas en los que lo hayamos configurado, permitiendo así poder internacionalizar con mayor facilidad los esqueletos, y a diferencia de otras versiones, podemos incluirlos en la carpeta del esqueleto para poder mantenerlos sin mezclar nuestro código con el estándar de SPIP.

PD: Puedes ver otras mejoras a SPIP en el siguiente artículo: http://www.spip.net/fr_article3368.html, de momento, en Francés

posted at 14:48  ·   ·  spip  cms
Click to read and post comments

abr 30, 2006

Esqueleto basado en Mollio.org

Introducción

Estos esqueletos se basan en el modelo tipo C de la web de www.mollio.org, gracias a un mensaje que se envió a la lista de correo de SPIP en Español.

Los esqueletos se ajustqan al tamaño de pantalla y se visualizan adecuadamente tanto en Mozilla como otros navegadores, y al disponer de dos áreas de menús, se adaptaban más cómodamente al diseño modular que habíamos utilizado Laura Primo y Pablo Iranzo Gómez para las webs de http://Linuv.uv.es y la versión anterior de http://Alufis35.uv.es.

Créditos

Queremos agradecer desde aquí a todos ellos su trabajo previo que ha posibilitado la creación de este.

Características

  • Permiten modificar el logotipo y frase de la web modificando un artículo con una palabra clave especial
  • Permiten modificar el mensaje de la web con otro artículo con una frase especial
  • La web se adapta al tamaño del navegador, de forma que siempre se muestra la máxima información posible evitando los molestos desplazamientos que tienen muchas webs al ser diseñadas para resoluciones bajas.
  • Tiene un diseño a base de módulos, que añadidos a cada plantilla principal (rubrique, sommaire, article, etc) en la sección derecha o izquierda del menú, permiten adaptar el diseño de la página a la información mostrada.
  • Dichos módulos se habilitano o deshabilitan con las palabras clave adecuadas
  • El album fotográfico muestra controles adelante-atrás así como información de las cabeceras EXIF que proporcionan las cámaras digitales (modelo, focal, diafragma, hora, etc) (además, utiliza el sistema de caché de SPIP para mejorar la navegación)
  • El módulo de agenda así como el de mini-agenda permiten mostrar eventos programados en nuestra web
  • La ficha de información del autor, permite el envío de mensajes, pero oculta su dirección de correo electrónico para evitar SPAM
  • Cada sección y artículo muestran un mini-icono que facilita su localización al navegar por las distintas páginas del sitio web.
  • Las cabeceras de los archivos, así como los META, se generan dinámicamente en función de las palabras claves asignadas a los artículos
  • En el caso de los artículos con la palabra clave "Frase", se asigna su decripción a la descripción general de la web (META DESCRIPTION).
  • Muestra las noticias sindicadas de otras webs como si fueran artículos de la propia
  • Soporte automatizado para Google Sitemaps, simplemente enviar el archivo con el mapa del sitio y listo
  • Soporte automatizado para ROR: Resources Of a Resource
  • Validan con el comprobador de w3.org en http://validator.w3.org/
  • Los esqueletos han sido internacionalizados y ahora cuentan con soporte para Español, Inglés, Catalán y Francés
  • Es posible escoger una licencia para asociarla a los artículos y así que los buscadores la indexen también
  • Soporte para MicroSummary de Firefox 2

Requisitos

Estos esqueletos han sido desarrollados sobre la versión SPIP 1.9.2 y debido a sus características deberían ser la versión mínima sobre la que se utilizarán.

La versión para 1.8.3 está también disponible en la url arriba indicada, bajo la carpeta 1.8.3 y ya no se desarrolla para ella, es posible que la información aquí mostrada no sea aplicable.

Los esqueletos están pensados para ser utilizados con reescritura de URLS según se explica en http://www.spip.net/es_article2024.html, aunque son perfectamente compatibles en caso de no tenerla.

Para su funcionamiento, necesita que las siguientes redirecciones estén habilitadas (se hizo así para facilitar la indexación por parte de buscadores):

Actualmente y para usar las URL Propres (Las URL Propres, permiten generar rutas de acceso a los artículos basadas en el título del mismo, facilitando que sean recordadas por los usuarios y mejorando la gestión por parte de los buscadores de Internet) de SPIP, las redirecciones a habilitar son las que se distribuyen en el archivo htaccess de la carpeta "mollio", donde entre otras, se ha incorporado un esqueleto "parser" que en caso de que se nos visitara desde urls con reescritura html en lugar de propres, notifica (Hace un http redirect permanente de archivos estilo article10.html a la URL correspondiente en propre o el sistema habilitado en ese momento en el servidor) a los visitantes y buscadores el nuevo esquema.

  • El funcionamiento del conversor PDF se ha migrado al plugin article_pdf de spip con modificaciones para la internacionalización de los pdf's generados
  • Para el correcto escalado de archivos con transparencias, es recomendable el gestor "convert" o "ImageMagick" para gestionar la creación de miniaturas
  • Para el módulo de agenda es necesario habilitar la opción de Fecha de publicación anterior

Como requisitos adicionales, una vez instaladas las plantillas, es necesario:

  • Copiar la arpeta "plugins" de "mollio" al raíz del sitio, y luego, en la parte de gestión de SPIP, activar el plugin article_PDF
  • Crear enlaces simbólicos (o copias) de las plantillas: article-album.html, rubrique-album.html, rubrique-agenda.html y rubrique-synd.html a los correspondientes -(NUM#) según cúal sea el ID de nuestra sección para agenda, galería fotográfica y para titulares de otras webs.
  • Crear un grupo de palabras llamado "Design" con al menos estas palabras clave: "Notadeldia", "Agenda", "Frase", "Banner_cabecera", "Creditos", "rubrique1", "rubrique2", "rubrique3", "rubrique4", "rubrique5" *(Ver parte "Configuración con Palabras Clave")
  • Crear una sección llamada agenda y asociarle tanto a la sección como a los artículos publicados en ella la palabra clave "Agenda" (si se publican artículos con la palabra clave Agenda aparecen en la miniagenda, aunque no en la de la sección)
  • Crear para la sección de titulares, una sección y dentro de ella, una nueva sección por cada web referenciada, de forma que dentro de dicha sección sólo se referencie un sitio web, para que así la plantilla muestre en esa sección, los artículos sindicados como artículos propios. (sólo si se van a referenciar webs externas)
  • Enviar a Google Sitemaps la url del sitio con la página sitemap (por ejemplo http://Alufis35.uv.es/spip/spip.php...) para que lo indexe
  • Si se utiliza la web para un sitio de noticias, enviar a Google News la solicitud y a Google Sitemaps la url SITIO/spip.php?page=sitemap-googlenews para cumplir con los requisitos para los artículos (requiere redirects del servidor Web (.htaccess))
  • Crear un artículo y asociarle la palabra "Frase", para que las plantillas tomen del título y del logotipo del artículo el logotipo y frase para la web. (opcional)
  • Crear un artículo y asociarle la palabra "Notadeldia" para que se muestre el mensaje del día en la sección central de la portada. (opcional)
  • Crear un artículo y asociarle la palabra "Banner_cabecera" para mostrar en la parte superior derecha el logotipo de dicho artículo y enlazarlo al campo URL de dicho artículo (opcional), si le añadimos una fecha de redacción anterior, podemos especificar la fecha de caducidad en la web (para campañas, etc)
  • Crear la palabra clave "Banners" en Design y asociarla a los artículos que deban salir como al estilo de Banner_cabecera pero en el lateral derecho.
  • Crear un artículo y asociarle la palabra "Creditos" para mostrar dicho enlace en el pie de cada página a una página con información sobre la web, autores, etc (opcional)
  • Crear un grupo de palabras clave y llamarlo Licencia y luego, se van creando palabras clave a las que se le asocia el logotipo de la licencia, en la descripción se pone la URL para leer la licencia completa y en el TEXTO, se pone el código que aparece en http://creativecommons.org/license/ tras acabar de escogerla, para que los buscadores indexen el tipo de licencia del artículo

Funcionamiento

Además de los esqueletos normales de SPIP, estos tienen los siguientes módulos que se utilizan para definir o mostrar información adicional al tipo de documento que estamos visualizando, permitiendo simplificar la forma de mantener el código de los esqueletos a través de la reutilización.

Actualmente está formado por los siguientes módulos:

  Módulo              Cometido
  ------------------- ---------------------------------------------------------------------------------------------------------------------------------------------------------------------
  mod_agenda         Muestra la mini agenda con los eventos del mes en curso
  mod_artsautalbum   Muestra los artículos del mismo autor cuando estamos en un album (en función del id_document)
  mod_artsaut        Muestra los artículos del mismo autor
  mod_artssec        Muestra los artículos en la misma sección
  mod_breves         Muestra las noticias breves del sitio
  mod_banners        Muestra hasta 5 banners laterales
  mod_popul          Muestra los 5 artículos más populares del sitio
  mod_salida         Muestra las opciones de salida del documento (Impreso o PDF)
  mod_secciones      Muestra las secciones que cuelgan de la raíz del sitio
  mod_tira           Muestra la tira cómica [E.C.O.L.](http://tira.escomposlinux.org/)
  mod_traduc         Muestra otras traducciones del artículo en curso
  mod_exif           Muestra las cabeceras EXIF de las imágenes (si existen datos)
  mod_inscrip        Permite inscribirse al sitio web
  mod_jerarquia      Muestra la jerarquía en secciones para llegar al artículo
  mod_jerarquiasec   Muestra la jerarquía en secciones para llegar a la sección
  mod_keywordbrev    Muestra las palabras clave de la breve
  mod_keyword        Muestra las palabras clave del artículo
  mod_nextprev       Muestra los botones adelante y/o atrás en las galerías
  mod_nota           Muestra el mensaje del sitio web en la portada
  mod_share          Muestra enlaces para publicar directamente la web en sitios de bookmarking social
  mod_nube           Muestra una nube de palabras clave en función de las asociadas a artículos en la web
  mod_rub            Muestra los artículos que estén en una rubrique (del raíz) que tenga asociada una palabra clave en un módulo lateral, eliminándolos de la parte principal de la web
  mod_license        Permite mostrar la licencia predeterminada CC by-nc-sa 2.5 o bien, las escogidas mediante palabras clave para cada artículo
  mod_technorati     Muestra los enlaces de otros blogs que enlazan al artículo en curso

  Plantilla                                   Soporte RSS
  ------------------------------------------- --------------------------------------------------------------------------------------------
  sommaire                                    Sitio completo
  article                                     Sitio completo
  breve                                       Sitio completo
  rubrique-* (album, synd,agenda,estándar)   Sitio completo y sección, en el caso de -synd se envía el feed de los artículos sindicados
  mot                                         Sitio completo y artículos con esa palabra clave
  album                                       se comporta como article
  el resto                                    el sitio completo

Configuración por palabras clave

Ahora se puede configurar el aspecto visual de Mollio mediante el uso o no de palabras clave.

Todas estas palabras deberán estar creadas en el grupo "Design" para que no interfieran con los artículos mostrados en la web.

Palabras clave "BASE", dentro de Design, como todas las especiales

  Palabra        Descripción
  -------------- -----------------------------------------------------------------------------------------------------------------------------------------------------
  _is_config   Indica que este archivo debe ser tratado como un fichero de configuración (Debe asignarse a todos los que quieran incluir alguna de las siguientes)

  Palabra                 Descripción
  ----------------------- --------------------------------------------------------------------------------
  _is_sommaire          Indica que el fichero de configuración afecta a la página principal
  _is_site              Indica que el fichero de configuración afecta al sitio (para el color)
  _is_article           Indica que el fichero de configuración afecta a los artículos
  _is_auteur            Indica que el fichero de configuración afecta a la página del autor
  _is_breve             Indica que el fichero de configuración afecta a las noticias breves
  _is_album             Indica que el fichero de configuración afecta a los álbumes fotográficos
  _is_plan              Indica que el fichero de configuración afecta al mapa del sitio
  _is_recherche         Indica que el fichero de configuración afecta a la página de búsqueda
  _is_correo            Indica que el fichero de configuración afecta a la entrada al correo
  _is_forum             Indica que el fichero de configuración afecta a la página de comentarios
  _is_forums            Indica que artículo redirije a la página de entrada a los foros
  _is_jabber            Indica que el fichero de configuración afecta a la página de entrada de Jabber
  _is_login             Indica que el fichero de configuración afecta a la página de inicio de sesión
  _is_rubrique          Indica que el fichero de configuración afecta a las secciones
  _is_rubrique-agenda   Indica que el fichero de configuración afecta a la Agenda
  _is_rubrique-album    Indica que el fichero de configuración afecta a los Álbumes
  _is_contact           Indica que el artículo se utilizará tanto por título como por enlace como medio de contacto

  Propiedad                           Descripción                                                                                                                                                           Aplica a
  ----------------------------------- --------------------------------------------------------------------------------------------------------------------------------------------------------------------- ------------
  _is_blue / _is_red / is_grey   Color del sitio (predeterminado azúl)                                                                                                                                 _is_site
  _has_email                        Habilita mostrar la página para ver el correo                                                                                                                         _is_site
  _has_jabber                       Habilita mostrar la página para el cliente jabber                                                                                                                     _is_site
  _has_customhead                   Incluye el archivo custom_head.html con los códigos de urchin, etc que quiera crear cada usuario                                                                     _is_site
  _shows_license                    Muestra el icono y texto del tipo de lidencia o sólo incluye las cabeceras para los buscadores en caso de que _has_license esté activado pero no _shows_license   _is_site
  _has_plan                         Habilita mostrar la pestaña de mapa del sitio                                                                                                                         _is_site
  _has_persistent_recherche        Muestra siempre el cuadro de búsqueda haya o no banner                                                                                                                _is_site
  _has_forums                       Muestra la pestaña para acceder a los foros                                                                                                                           _is_site

  Propiedad           Indica que la página debe incluir el módulo
  ------------------- ---------------------------------------------
  _has_agenda       mod_agenda.html
  _has_banners      mod_banners.html
  _has_breves       mod_breves.html
  _has_popul        mod_popul.html
  _has_nube         mod_nube.html
  _has_exif         mod_exif.html
  _has_inscrip      mod_inscript
  _has_keywords     mod_keywordbrev.html mod_keyword.html
  _has_license      mod_license.html
  _has_menu         A todas
  _has_mots         mod_mots.html
  _has_nextprev     mod_nextprev.html
  _has_salida       mod_salida.html
  _has_secciones    mod_secciones.html
  _has_share        mod_share.html
  _has_tira         mod_tira.html
  _has_traduc       mod_traduc.html
  _has_samesect     mod_artssec.html
  _has_sameauth     mod_artsaut.html mod_artsautalbum.html
  _has_rubriques    mod_rub.html
  _has_technorati   mod_technorati.html
  _has_contact      Incluirá un enlace al artículo marcado como _is_contact

Por ejemplo, para crear una web con el juego de colores Rojo, crearemos un artículo al que le asignaremos las palabras:

"_is_config" "_is_site" "_is_red"

Para crear una página de sommaire con nube de palabras clave, articulos populares y menu, haremos otro artículo con las palabras clave:

"_is_config" "_is_sommaire" "_has_menu" "_has_popul" "_has_nube"

NOTA:

Actualmente las plantillas sólo muestran los módulos que originalmente tenían, aunque se irán revisando para poder incluir más módulos con la intención de poder configurar mejor la apariencia sin necesidad de tocar el código HTML, así como, si fuera posible, elegir ubicación del módulo y orden

En caso de no indicar _is_config o ninguno de los módulos a los que afecta, se utiliza la que hasta ahora era la disposición estándar de módulos, etc

Los módulos, en caso de no tener datos que mostrar, no aparecen, por ejemplo el de traducciones, el de palabras clave o el de datos EXIF, de forma que sólo aparecerán en caso de que los hayamos inclido (y de que sean necesarios claro).

En principio, una vez tenidas en cuenta las anteriores consideraciones, podremos trabajar con normalidad con el sitio web, con la única limitación o pega (que no he sabido resolver y de la que no he recibido respuesta en la lista de SPIP) de que los artículos deben obligatoriamente llevar al menos una palabra clave asociada, que no pertenezca al grupo de palabras "Design", que por otro lado, dado que las plantillas establecen los META KEYWORDS en función de las palabras clave indicadas, nos ayudará a que los buscadores visiten nuestras webs.

Te recomiendo en este caso que crees un grupo de palabras clave llamado "Tema" y que recomiendes (mediante la opción adecuada en la definición del grupo) que se escoja al menos una palabra de este grupo.

Para utilizar la agenda, deberás publicar artículos en su sección y asignarles la fecha del evento en el campo de "Fecha de Publicación Anterior", para que así SPIP la coloque en el día apropiado

En caso de que tengas alguna duda relacionada o considerases que alguna parte de este documento o de las plantillas se puede mejorar, no dudes en colgar un mensaje al respecto.

PD:

Puedes consultar el funcionamiento a nivel de usuario de las plantillas consultando el artículo Manual de usuario de los esqueletos modificados de spip-contrib, pues es análogo al de estas plantillas.

Puedes también consultar los últimos cambios en el código

posted at 05:06  ·   ·  spip  cms
Click to read and post comments

feb 20, 2005

Esqueleto basado en el de spip-contrib

Introducción

Antes de nada... Estos esqueletos se basan en los aparecidos en http://www.spip-contrib.net, gracias a un mensaje que se envió a la lista de correo de SPIP en Español, hablando de otros modelos basados en esos mismos (los de nqnwebs para atén de Martín Gaitán)

Lo que me llamó la atención de estos esqueletos era que se adaptaban bien al tamaño de pantalla y se veían adecuadamente tanto en Mozilla como otros navegadores, y que al disponer de dos áreas de menús, se adaptaban más cómodamente al diseño modular que habíamos utilizado Laura Primo y Pablo Iranzo Gómez para las webs de http://Linuv.uv.es y la versión anterior de http://Alufis35.uv.es.

Créditos

Queremos agradecer desde aquí a todos ellos su trabajo previo que ha posibilitado la creación de este.

Características

  • Permiten modificar el logotipo y frase de la web modificando un artículo con una palabra clave especial
  • Permiten modificar el mensaje de la web con otro artículo con una frase especial
  • La web se adapta al tamaño del navegador, de forma que siempre se muestra la máxima información posible evitando los molestos desplazamientos que tienen muchas webs al ser diseñadas para resoluciones bajas.
  • Tiene un diseño a base de módulos, que añadidos a cada plantilla principal (rubrique, sommaire, article, etc) en la sección derecha o izquierda del menú, permiten adaptar el diseño de la página a la información mostrada.
  • El album fotográfico muestra controles adelante-atrás así como información de las cabeceras EXIF que proporcionan las cámaras digitales (modelo, focal, diafragma, hora, etc) (además, utiliza el sistema de caché de SPIP para mejorar la navegación)
  • El módulo de agenda así como el de mini-agenda permiten mostrar eventos programados en nuestra web
  • La ficha de información del autor, permite el envío de mensajes, pero oculta su dirección de correo electrónico para evitar SPAM
  • Cada sección y artículo muestran un mini-icono que facilita su localización al navegar por las distintas páginas del sitio web.
  • Las cabeceras de los archivos, así como los META, se generan dinámicamente en función de las palabras claves asignadas a los artículos
  • En el caso de los artículos con la palabra clave "Frase", se asigna su decripción a la descripción general de la web (META DESCRIPTION).
  • Muestra las noticias sindicadas de otras webs como si fueran artículos de la propia
  • Soporte automatizado para Google Sitemaps, simplemente enviar el archivo con el mapa del sitio y listo
  • Soporte automatizado para ROR: Resources Of a Resource

Requisitos

Estos esqueletos han sido desarrollados sobre la versión SPIP 1.8.2d, y aunque debería funcionar sobre las posteriores a la 1.7.2, no se han realizado pruebas al respecto.

Los esqueletos están pensados para, y asumen, que el servidor tenga habilitada la reescritura de enlaces .html a .php3 según se explica en http://www.spip.net/es_article2024.html, aunque es posible adaptarlos para que funcionen sin ellas.

Para su funcionamiento, necesita que las siguientes redirecciones estén habilitadas (se hizo así para facilitar la indexación por parte de buscadores):

RewriteRule ^spip/rubrique([0-9]+).html$ rubrique.php3?id_rubrique=$1 [QSA,L]
RewriteRule ^spip/article([0-9]+).html$ article.php3?id_article=$1 [QSA,L]
RewriteRule ^spip/breve([0-9]+).html$ breve.php3?id_breve=$1 [QSA,L]
RewriteRule ^spip/secteur([0-9]+).html$ secteur.php3?id_rubrique=$1 [QSA,L]
RewriteRule ^spip/album([0-9]+).html$ album.php3?id_document=$1 [QSA,L]
RewriteRule ^spip/plan.html$ plan.php3 [QSA,L]
RewriteRule ^spip/mot([0-9]+).html$ mot.php3?id_mot=$1 [QSA,L]
RewriteRule ^spip/imprimir([0-9]+).html$ imprimir.php3?id_article=$1 [QSA,L]
RewriteRule ^spip/auteur([0-9]+).html$ auteur.php3?id_auteur=$1 [QSA,L]

Actualmente y para usar las URL Propres (las URL Propres, permiten generar rutas de acceso a los artículos basadas en el título del mismo, facilitando que sean recordadas por los usuarios y mejorando la gestión por parte de los buscadores de Internet) de SPIP, las redirecciones que tengo habilitadas son las siguientes (adjunto el archivo htaccess por motivos de comodidad):

RewriteRule ^spip/rubrique([0-9]+).html$ rubrique.php3?id_rubrique=$1 [QSA,L]
RewriteRule ^spip/article([0-9]+).html$ article.php3?id_article=$1 [QSA,L]
RewriteRule ^spip/breve([0-9]+).html$ breve.php3?id_breve=$1 [QSA,L]
RewriteRule ^spip/secteur([0-9]+).html$ secteur.php3?id_rubrique=$1 [QSA,L]
RewriteRule ^spip/album([0-9]+).html$ album.php3?id_document=$1 [QSA,L]
RewriteRule ^spip/plan.html$ plan.php3 [QSA,L]
RewriteRule ^spip/mot([0-9]+).html$ mot.php3?id_mot=$1 [QSA,L]
RewriteRule ^spip/imprimir([0-9]+).html$ imprimir.php3?id_article=$1 [QSA,L]
RewriteRule ^spip/auteur([0-9]+).html$ auteur.php3?id_auteur=$1 [QSA,L]
RewriteRule ^+-[^/.]+(-+)?(.html)?$ mot.php3 [QSA,E=url_propre:$0,L]
RewriteRule ^+[^/.]++?(.html)?$ breve.php3 [QSA,E=url_propre:$0,L]
RewriteRule ^-[^/.]+-?(.html)?$ rubrique.php3 [QSA,E=url_propre:$0,L]
RewriteRule ^_[^/.]+_?(.html)?$ auteur.php3 [QSA,E=url_propre:$0,L]
RewriteRule ^@[^/.]+@?(.html)?$ site.php3 [QSA,E=url_propre:$0,L]
RewriteRule ^[^/.]+(.html)?$ article.php3 [QSA,E=url_propre:$0,L]

La redirección para album, pdf.php3 e imprimir son las únicas no estándar, así que en caso de no poder o no querer hacer uso de este sistema, se deberían modificar los esqueletos de estas páginas (así como de los módulos relacionados) para utilizar la estándar con extensiones en php3

  • Para el funcionamiento del conversor a PDF, es necesaria la utilidad "htmldoc"
  • Para el correcto escalado de archivos con transparencias, es recomendable el gestor "convert" o "ImageMagick" para gestionar la creación de miniaturas
  • Para el módulo de agenda es necesario habilitar la opción de Fecha de publicación anterior

Como requisitos adicionales, una vez instaladas las plantillas, es necesario:

  • Crear enlaces simbólicos (o copias) de los archivos .php3 de la carpeta de los esqueletos a la principal de SPIP
  • Crear enlaces simbólicos (o copias) de los archivos .css de la carpeta de los esqueletos a la principal de SPIP
  • Crear enlaces simbólicos (o copias) de las plantillas: article-album.html, rubrique-album.html, rubrique-agenda.html y rubrique-synd.html a los correspondientes -(NUM#) según cúal sea el ID de nuestra sección para agenda, galería fotográfica y para titulares de otras webs.
  • Crear un grupo de palabras llamado "Design" con al menos estas palabras clave: "Notadeldia", "Agenda", "Frase", "Banner_cabecera"
  • Crear un artículo y asociarle la palabra "Frase", para que las plantillas tomen del título y del logotipo del artículo el logotipo y frase para la web.
  • Crear un artículo y asociarle la palabra "Notadeldia" para que se muestre el mensaje del día en la sección central de la portada.
  • Crear un artículo y asociarle la palabra cabecera" para mostrar en la parte superior derecha el logotipo de dicho artículo y enlazarlo al campo URL de dicho artículo
  • Crear una sección llamada agenda y asociarle tanto a la sección como a los artículos publicados en ella la palabra clave "Agenda" (si se publican artículos con la palabra clave Agenda aparecen en la miniagenda, aunque no en la de la sección)
  • Crear para la sección de titulares, una sección y dentro de ella, una nueva sección por cada web referenciada, de forma que dentro de dicha sección sólo se referencie un sitio web, para que así la plantilla muestre en esa sección, los artículos sindicados como artículos propios.
  • Enviar a Google Sitemaps el archivo sitemap.php3 para que lo indexe Funcionamiento

Además de los esqueletos normales de SPIP, estos tienen los siguientes módulos que se utilizan para definir o mostrar información adicional al tipo de documento que estamos visualizando, permitiendo simplificar la forma de mantener el código de los esqueletos a través de la reutilización.

Actualmente está formado por los siguientes módulos laterales:

  ------------------------ ------------------------------------------------------------------------------------------------
  Módulo                   Cometido
  mod_agenda.html         Muestra la mini agenda con los eventos del mes en curso
  mod_artsautalbum.html   Muestra los artículos del mismo autor cuando estamos en un album (en función del id_document)
  mod_artsaut.html        Muestra los artículos del mismo autor
  mod_artssec.html        Muestra los artículos en la misma sección
  mod_breves.html         Muestra las noticias breves del sitio
  mod_popul.html          Muestra los 5 artículos más populares del sitio
  mod_salida.html         Muestra las opciones de salida del documento (Impreso o PDF)
  mod_secciones.html      Muestra las secciones que cuelgan de la raíz del sitio
  mod_tira.html           Muestra la tira cómica [E.C.O.L.](http://tira.escomposlinux.org/)
  mod_traduc.html         Muestra otras traducciones del artículo en curso
  mod_exif.html           Muestra las cabeceras EXIF de las imágenes (si existen datos)
  mod_inscrip.html        Permite inscribirse al sitio web
  mod_jerarquia.html      Muestra la jerarquía en secciones para llegar al artículo
  mod_jerarquiasec.html   Muestra la jerarquía en secciones para llegar a la sección
  mod_keywordbrev.html    Muestra las palabras clave de la breve
  mod_keyword.html        Muestra las palabras clave del artículo
  mod_nextprev.html       Muestra los botones adelante y/o atrás en las galerías
  mod_nota.html           Muestra el mensaje del sitio web en la portada
  mod_opbl1.html          Abre el estilo de bloque 1
  mod_opbl2.html          Abre el estilo de bloque 2
  mod_opbl3.html          Abre el estilo de bloque 3
  mod_clobl1.html         Cierra el estilo de bloque 1
  mod_clobl2.html         Cierra el estilo de bloque 2
  mod_clobl3.html         Cierra el estilo de bloque 3
  ------------------------ ------------------------------------------------------------------------------------------------

Las plantillas generales (rubrique, -album, -synd, article, etc) llevan un div que se llama lefter y otro que se llama righter, esos son los paneles laterales, podremos incluir, activar o desactivar los módulos que queramos haciendo INCLURES.

Los módulos, en caso de no tener datos que mostrar, no aparecen, por ejemplo el de traducciones, el de palabras clave o el de datos EXIF, de forma que sólo aparecerán en caso de que los hayamos inclido (y de que sean necesarios claro).

En principio, una vez tenidas en cuenta las anteriores consideraciones, podremos trabajar con normalidad con el sitio web, con la única limitación o pega (que no he sabido resolver y de la que no he recibido respuesta en la lista de SPIP) de que los artículos deben obligatoriamente llevar al menos una palabra clave asociada, que no pertenezca al grupo de palabras "Design", que por otro lado, dado que las plantillas establecen los META KEYWORDS en función de las palabras clave indicadas, nos ayudará a que los buscadores visiten nuestras webs. Te recomiendo en este caso que crees un grupo de palabras clave llamado "Tema" y que recomiendes (mediante la opción adecuada en la definición del grupo) que se escoja al menos una palabra de este grupo.

Para utilizar la agenda, deberás publicar artículos en su sección y asignarles la fecha del evento en el campo de "Fecha de Publicación Anterior", para que así SPIP la coloque en el día apropiado

En caso de que tengas alguna duda relacionada o considerases que alguna parte de este documento o de las plantillas se puede mejorar, no dudes en colgar un mensaje al respecto.

Saludos

posted at 22:52  ·   ·  spip  cms
Click to read and post comments

nov 25, 2004

Manual de la web SPIP

Manual de instrucciones de la web

Introducción

Para facilitar el uso de la web tanto por personas acostumbradas al trabajo con ordenadores, como personas que no lo están,hacía falta una de forma de agrupar a la vez un sistema sencillo de manejar como potente en su funcionamiento y posibilidades de adaptación.

Se analizaron los diversos sistemas libres de gestión de contenidos (la opción de editar directamente las páginas quedó descartada por su complejidad y falta de uniformidad, etc), y entre los más habituales: PHP-Nuke, Post-Nuke, Drupal, etc se fueron descartando debido a los problemas de seguridad de los que adolecían los más extendidos como PHP-Nuke, o a la orientación a personas acostumbradas al manejo de estos sistemas.

SPIP

Al final se escogió a SPIP: Sistema para la Publicación en Internet. SPIP es un gestor de contenido diseñado con la idea de crear los archivos digitales de Le Monde Diplomatique y se creó combinando otros sistemas ya utilizados en revistas online.

Como características, cabe destacar, que debido a su orientación al mundo editorial SPIP contempla características muy interesantes:

  • Varios niveles de acceso: Administrador, Editor, Redactor
  • Estructura por secciones
  • Completo soporte multilingüe (con gestión de traducciones entre artículos, etc)
  • Soporte avanzado para formatos dentro de los artículos, inclusión de documentos como imágenes, vídeos, etc, enlaces internos, notas al pie, etc

Además de todas estas, SPIP aporta toda la funcionalidad de un gestor de contenido, como la creación de ficheros de sindicación, sindicación de titulares de otras páginas, buscador, imágenes por cada categoría, etc.

Estructura de SPIP

SPIP está estructurado en torno a secciones (rubriques) que pueden estar ubicadas en el raíz del sitio, o bien dentro de otras secciones.

A nivel de publicación, SPIP soporta dos tipos de artículo, las breves y los artículos.

Las breves están orientadas a pequeñas notas, no muy desarrolladas, por ejemplo, convocatorias de reuniones, concentraciones, etc, por otro lado, los artículos están orientados a comunicados de prensa, y a noticias más elaboradas, por ejemplo, en el caso de una concentración, explicando los motivos que han llevado a esa situación, enlaces a las noticias en otros sitios, etc.

La web

El aspecto actual se basa en una modificación de las plantillas estándar de SPIP, con plantillas especiales para mostrar galerías fotográficas, etc, así como iconos personalizados según la sección.

La potencia de SPIP se basa precisamente en tener un mismo sistema para edición de artículos, gestión, etc que a su vez permite aplicando unas plantillas bastante sencillas de crear, personalizar completamente el aspecto de la web, llegando a ejemplos como los mostrados en la web de spip.

Llegando a hacer que parezca mentira que por debajo esté funcionando el mismo sistema de gestión.

Actualmente existe un equipo desarrollando una nueva apariencia para la web, de forma que su aspecto resulte más atractivo y muestre de forma más organizada la información.

Precauciones

A modo de ejemplo, publicar una noticia de dos líneas de texto convocando a una manifestación o enlazando a otra web como un artículo no es buena idea, cuando disponemos de las noticias breves que además de tener más visibilidad, no "desilusionan" al entrar y ver que están vacías.

De igual modo, al poner un enlace a otra noticia o a otra web, no basta con indicar la dirección, sino hacerlo de forma que la persona que lea la noticia, sin más que pinchar encima, pueda acceder a ella.

Claro está, es conveniente, una vez creado un artículo, ver el aspecto que tiene, para proceder a corregir todos los detalles que se nos pudieran haber pasado por alto.

Debemos pues, procurar dotar a los artículos y como consecuencia a la web, de los mejores contenidos posibles, lo más completos, referenciados y sobre todo actualizados, para así poder ser un lugar de referencia del que la gente pueda obtener información

Entrada a la zona administrativa

En la página principal, pincharemos sobre el enlace "Espacio privado" y nos aparecerá la ventana de inicio de sesión.

Tras introducir el identificador de usuario, se nos solicitará la contraseña. Realizado este trámite, SPIP, nos muestra su panel de gestión.

A partir de ahora, podremos acceder a todas las funciones de SPIP para las que estamos autorizados, escribir artículos, solicitar su publicación, modificarlos, crear secciones, etc

La primera pantalla que nos aparece, es una especie de resumen de las citas pendientes según el calendario de la web, listado de secciones, artículos en curso de redacción, peticiones administrativas pendientes de atención, así como una lista con los atajos a las funciones que habitualmente más se utilizan.

La aplicación está plagada de iconos que nos muestran la ayuda de la que dispone el entorno para dicho cuadro, utilizando estos botones podremos conocer rápidamente cómo utilizar una función que desconocíamos.

Vamos a presionar sobre el enlace "Nuevo Artículo", ya que es donde principalmente vamos a trabajar.

Creando un artículo

Cuando pinchamos el atajo para crear un nuevo artículo nos aparece una nueva ventana.

En ella, tenemos unos recuadros para ir rellenando los campos que luego darán forma a nuestro artículo.

Antetítulo, Título y Subtítulo

Como en una noticia de un periódico, tenemos un antetítulo, un título y un subtítulo, que nos permiten crear una pequeña ampliación sobre el texto que vamos a tratar. A modo de ejemplo, se pueden consultar noticias ya publicadas en la web que hacen uso de estos campos.

El campo estrictamente necesario es el título y la sección.

Sección

Debemos escoger correctamente la sección, para así facilitar que artículos de temáticas relacionadas estén juntos, a la vez que facilitamos que la persona encargada de la labor de editor, tenga que perder menos tiempo y pueda realizar un mejor trabajo.

Además de esta estructura, tenemos una sección para tablón de anuncios (donde publicaremos las breves), otra para galería fotográfica (artículos que no tengan texto, o muy pequeño y tengan muchas fotografías adjuntas, por ejemplo el de una concentración, evento, etc).

Descripción

Una vez escogida adecuadamente la sección donde irá ubicado, debemos especificar una descripción rápida del artículo que aparecerá junto al título mientras el artículo esté en la parte principal de la portada y que ayudará al visitante a conocer el contenido, en caso de omitirse, se utilizará el comienzo del texto del artículo.

Epígrafe

El epígrafe es una ampliación de la descripción que nos permite obtener una introducción al texto del artículo.

Texto

Este es el lugar donde trabajaremos principalmente, como habremos visto, en cada uno de los cuadros tenemos el botón de ayuda para abrir la ayuda del entorno y conocer el funcionamiento de cada cuadro, su función y las opciones que podemos utilizar en su interior.

Dentro del cuadro de texto podemos utilizar código HTML para aplicar formato, o bien utilizar los atajos que incorpora SPIP.

Atajos

Párrafos: Se deben separar entre sí con una línea en blanco: dos retornos de carro seguidos.

Listas numeradas "-#" o listas de elementos "-" al principio de la línea. Listas anidadas: añadiendo asteriscos tras el guión según el nivel de anidamiento.

Cursiva, texto entre llaves "{" y "}"

Negrita, texto entre llaves dobles "{ {" y "} }"

Subtítulos, precedido por tres ###

Línea de separación horizontal, cuatro guiones seguidos "----"

Hipervínculos:

  • a otro artículo: "texto", donde texto y destino son los que vamos variando nosotros, existen una serie de destinos "especiales":
  • art# Artículo,
  • br# Enlace a la noticia breve,
  • doc# Documento adjunto,
  • img# Imagen adjunta,
  • emb# Adjunto incrustado en la web (por ejemplo un vídeo),
  • mot# Palabra clave,
  • site# Web,
  • aut# Autor",
  • como por ejemplo art# que nos permite insertar el enlace a otro artículo de la web, y si dejamos el texto en blanco, nos indica el título que le asignamos.

Hipervínculos a diccionarios externos, por defecto WikiPedia [?palabra]

Notas al pie de página, texto entre dobles corchetes "[[ y "]]", por defecto son notas numeradas, si pones entre "<" y ">" (dentro de los corchetes), puedes forzar a un número o a una nota con por ejemplo asterisco.

Tablas: Se separa cada columna con la barra vertical: "|" y se indica título entre dobles llaves "{ {" y "} }`

Texto sin interpretar: encerrado entre el tag HTML

Código a no interpretar y mostrar de forma especial entre el tag: "code"

Post Scriptum

Este cuadro nos permite añadir texto al final del artículo, que por ejemplo nos puede ser útil para referenciar a otros artículos relacionados, etc.

Las breves

Una noticia breve, se parece mucho a un artículo, con la limitación de sólo poder publicarse en las secciones de primer nivel.

La breve contiene Título, opción para escoger sección, el texto de la breve y un enlace.

Todo en SPIP depende de la plantilla que se utilice, de forma que algunos campos pueden no aparecer a pesar de haberlos puesto (de ahí el siguiente punto de este documento).

Por norma, sería aconsejable limitar las breves a pequeños avisos, que se escribieran todo en el título, por ejemplo : "Próxima reunión del AdR el día X en la cafetería del campus"

Luego en el texto, se podría ampliar un poco más la información, pero siempre, teniendo en mente que se debería escribir un artículo al que enlace la breve, indicando los motivos que impulsan a esa concentración, cita, etc de forma que quede ampliada la información que con el título no es suficiente.

Comprobando el resultado

Una vez hemos escrito un artículo y hemos presionado el botón de validar, nos aparece una vista previa de cómo quedará el artículo, su título, antetítulo, descripción, etc.

Como "extras" a lo que ya habíamos visto, ahora podremos cambiar el idioma del artículo por si no es el adecuado, añadir autores al mismo (para artículos compartidos) y sobre todo, revisarlo para ver que esté bien escrito, con un formato adecuado, etc.

Tras realizar todos estos pasos, podemos cambiar el estado para pedir la publicación del mismo, así el editor podrá saber que queremos publicarlo, y tras comprobar que es correcto, procederá a validarlo para que aparezca en la web.

Si el artículo lleva alguna fotografía, podemos adjuntarla también en este paso, así como algún documento. Si quisiéramos ubicarlas en algún lugar en concreto del documento, deberíamos volver a modificar el documento y utilizar los enlaces explicados anteriormente con los números que asigna SPIP a cada documento adjuntado.

También podemos adjuntar iconos personalizados a los artículos, de forma que por ejemplo un artículo que vaya en la sección de acción sindical aparezca como un megáfono.

Actualmente, si no se especifica ninguno en el artículo, se utilice el de la sección.

Consideraciones

Si el artículo va a tener documentos adjuntos, sería interesante, que por ejemplo en el caso de referencias técnicas, etc, éstos se publiquen como un artículo, no como un adjunto a un artículo, el motivo es muy sencillo, si un artículo lleva un adjunto, es poco probable que un buscador lo descargue y lo indexe, mientras que si es texto, los buscadores lo encontrarán, lo añadirán a sus bases de datos, y permitirán que se encuentre el artículo con mayor facilidad.

Si el artículo va a tener adjuntadas muchas fotografías, por ejemplo en el caso de fotografías de una install party, un evento, etc, es recomendable crear dos artículos, uno con todo el texto del artículo, detallando por ejemplo, el motivo del evento, del programa del mismo, y por otro lado, en la parte de "post Scriptum", ponga el enlace a otro artículo publicado en la sección de "Galería fotográfica", donde se pondrían todas las imágenes relacionadas, permitiendo que la gente que sólo esté interesada en el texto, lo descargue rápidamente y por otro lado pueda consultar las fotografías con más calma.

Una de las cosas a tener en cuenta para la publicación: cuanto más completo sea el artículo con textos claros, bien estructurados, enlaces a los lugares de dónde se ha sacado la información, o dónde se puede ampliar o contrastar la misma, enlaces a la Wikipedia para las palabras más "complejas" o que son importantes, pero no tienen lugar para una explicación dentro del artículo, etc, harán por un lado que los buscadores encuentren y valoren mejor la página y la información, favoreciendo que se la visite, y por otro lado, harán que los visitantes se lleven una buena impresión del trabajo realizado y vuelvan a ella convirtiéndola en un lugar de consulta frecuente, ampliando así su utilidad.

posted at 18:44  ·   ·  cms  spip
Click to read and post comments