Consejos para traducir el sitio de la documentación, www.spip.net

-  Clasificación de los artículos dentro de las secciones

Hay dos formas de «clasificar» los artículos en spip.net:

-  en ciertas secciones, es necesario «forzar» la clasificación de los artículos según cierta lógica (por ejemplo, tutoriales, documentación de referencia), cuando exista una explicación que se desarrolla a lo largo de varios artículos sucesivos; basta con numerar los títulos de los artículos («1. Primer artículo», «2. Segundo artículo»...);

Las traductoras de la versión española han adoptado una numeración de 10 en 10 muy práctica: «10. Primer artículo», «20. Segundo artículo». Se aconseja proceder de esta forma, pues esto facilitará intercalar artículos posteriormente dentro de esta clasificación.

-  en las secciones que no necesiten una lectura «por orden» de los artículos (FAQ, trucos y utilidades...), no se numeran los artículos, lo que permite presentar al principio de la lista los últimos artículos publicados, y los más antiguos al final.

En los esqueletos, la presentación se adapta automáticamente según la numeración esté presente o no.

-  Logos de las secciones

No es necesario modificar los logos: no contienen texto (los títulos se indican con HTML en los esqueletos), lo que permite utilizarlos en todos los idiomas. Por lo tanto se aconseja utilizar los iconos de la versión francesa para instalarlos en las secciones correspondientes de los demás idiomas. El sitio no usa los «logos de paso del ratón».

-  Imágenes grandes de las secciones

Cada logo de sección se complementa con una imagen grande que se sitúa en lo alto de cada página de sección. Es el mismo dibujo que el logo, pero de dimensiones considerablemente mayores. De la misma forma, es preferible recuperar las imágenes de la versión francesa para instalarlas en las secciones correspondientes de los demás idiomas.

Estas imágenes grandes se instalan como «documentos adjuntos» en las secciones (una por sección): una vez subidos los documentos, es necesario ponerles el título «spip_haut». Hecho esto, puedes probar con «ver esta sección en línea» para verificar el resultado inmediatamente.

Al principio, es preferible uniformizar la presentación de las secciones. Después (cuando haya un poco más de tiempo), se podría trabajar en variaciones de las series de logos según los idiomas.

-  Los foros en cada idioma

Los foros se activan en este caso mediante una sección. En efecto, todos los artículos del sitio, se dejan con la configuración «básica» de los foros (es decir, activados y moderados a posteriori) sólo que en los esqueletos generalmente no se muestran; pero queda la posibilidad, después, de «jugar» con los foros de cada página en función de futuros desarrollos (por ejemplo: retomar el sistema de «notación» de las FAQ).

Para crear una sección de «foros», basta con asignarle, en el espacio privado, la palabra clave «Forums». Todos los artículos publicados en esa sección adoptarán la interfaz característica de los foros.

En spip.net, los foros son temáticos. El tema es el título del artículo que los alberga:
-  para obtener una clasificación «lógica» de los foros, numerar los títulos de los artículos (por ejemplo: «1. Instalación», «2. Uso del espacio privado»...);
-  sin duda, en el texto del artículo, describe en uno o dos párrafos el tema tratado en ese foro.

N.B. La sección de los foros del idioma se verá en la columna de la izquierda de todas las páginas de sección.

  • Moderación de los foros

Cuando crees el artículo de foro, quedarás señalado automáticamente como autor del artículo (función SPIP de base). Si lo dejas así, recibirás un mail por cada mensaje publicado en el foro de ese artículo. Esto puede resultar práctico para seguir la vida del foro; pero también puede resultar molesto si el foro es muy activo (recibirás varios mensajes cada día). Tendrás que determinar si deseas recibir esos mails de seguimiento de los foros.

Para dejar de recibir esos mails, basta con retirarte como autor del artículo. N.B. Siguiendo el mismo principio, se puede añadir como autor del artículo a toda persona que quiera recibir estos mails.

Sabemos por experiencia que los foros de SPIP tienden a crecer muy, pero muy rápido. La nueva presentación está destinada a conseguir que se puedan consultar más fácilmente (sobre todo para buscar una pregunta ya enviada). Para facilitar la función de archivo de documentación de estos foros (tengo un problema, voy a ver si la cuestión ya se ha consultado y está resuelta), se recomiendan dos puntos para la moderación:
-  lea preguntas (los mensajes de primer nivel, que lanzan un hilo de discusión) deben tener un título explícito (de esta forma, el panel grande que recapitula todas las preguntas es legible; si no, habrá hilos (threads) que no se sabe de dónde vienen...); las preguntas que no tengan título deben borrarse (hay una gran advertencia en negrita en lo alto de la página desde la que se envían los mensajes, así que...); N.B. esto no se aplica a las respuestas de las preguntas, ya que estas adoptan automáticamente el nombre «> La pregunta», suficiente para navegar;
-  verificar que las preguntas se envían al foro adecuado (por experiencia, sabemos que algunos usuarios escriben en cualquier lado); aquí también, borrar los mensajes que no estén en el lugar correcto.

Cuando se suprime un mensaje por alguna de estas razones, si la pregunta es interesante (formulación clara, asunto que no se haya tratado en el foro...), se puede reenviar un mensaje con el título corregido o situado en el foro adecuado; en este caso, es aconsejable indicar que se trata de un reenvío, acotando el mensaje original como una cita (<html><quote>...</quote></html>).

Por lo demás, los foros dedicados a SPIP no suelen presentar de problemas de moderación, sino más bien de animación. En general, hay dos tipos de mensajes a vigilar:
-  los mensajes que menosprecian a un proveedor o un producto comercial; este tipo de mensajes, casi siempre, terminan con amenazas de ser procesados; si el mensaje te parece directamente difamatorio (del tipo: «el proveedor machin-online, es una mier...»), borralo... sin dudar en pedirle al autor del mensaje que lo reformule con una crítica argumentada («en machin-online, la utilización de SPIP es difícil o imposible por tales y tales razones...»), lo que de todas formas les será más útil a las demás participantes;
-  los mensajes que propongan una solución técnica a base de PHP que introduzcan un agujero de seguridad en los sitios (del tipo, consultar la base de datos con las claves escritas directamente en el esqueleto); como mínimo, enviar inmediatamente un mensaje de respuesta, con avisos en negrita, destellante y en rojo vivo para explicar que ese trozo de código no debe utilizarse nunca jamás.

Dar ritmo a la presentación de las secciones y a la página de inicio de un idioma

Los nuevos esqueletos reproducen el comportamiento de la versión anterior en uzine.net: la página principal sólo es una lista de secciones / sub-secciones y de listas de artículos, y contiene unos recuadros que dan ritmo a la interfaz y destacan ciertos elementos. En uzine.net, esos recuadros estaban codificados «en duro» en el propio esqueleto; ahora, esto se realiza automáticamente en función de ciertos criterios.

En especial, esto permite que desaparezca el antiguo bloque «Informaciones útiles» de la parte superior de la página de inicio, introduciendo esas informaciones, destacadas, dentro de la lista de secciones / sub-secciones.

-  Destacar un sitio referenciado / sindicado

Cuando a un sitio referenciado se le da una descripción aparece un recuadro alrededor del mismo. Por lo tanto:
-  añadir una descripción a los sitios referenciados que se quieran destacar;
-  no poner descripción a los demás.

Truco utilizado, por ejemplo en «Questions et réponses» de la versión francesa: se puede resaltar de manera importante un elemento de spip.net añadiéndolo como «sitio referenciado» con un comentario. Por ejemplo, es el caso de «Liste de discussion des utilisateurs de SPIP» y «Forum de discussion»: esos bloques están creados mediante «sitios referenciados» y una descripción que tiene una conformación más potente (añadido «a mano» de una imagen, directamente en HTML, negrita - mayúscula para introducir el texto..., recuerdo del enlace de hipertexto dentro de la descripción...).

-  Un bloque explicativo en la sub-sección

Si se pone texto en una sección («modificar la sección», campo «texto»), este aparece recuadrado en la página de inicio y en las secciones padre. En la sección «Questions et réponses» de la versión francesa, el bloque «Obtenir des réponses» es en realidad el texto de la sección. N.B. el bloque es creado automáticamente por el esqueleto, no se debe codificar en el texto de la sección.

En la presentación de las sub-secciones, es la descripción del artículo lo que se ve recuadrado.

-  Señalar la lista de discusión del idioma

Cada idioma dispone de una lista de discusión (spip-#lang@rezo.net). Se señalan caso por caso en la sección de documentación del idioma de que se trate.

Para destacar una lista en la página de inicio de la sección de tal o cual idioma, basta con crear un «sitio referenciado» cuya dirección sea la página de inscripción a esa lista. Si se añade una descripción, el «sitio referenciado» se destacará en la página del sumario.

Autor o autora Xuacu Publicado el: Actualizado: 26/10/12

Traducciones: català, corsu, English, Español, français, italiano, Nederlands, Türkçe