SPIP

Artículos de esta sección

  • [12] Todas las balizas propias de un artículo

    Estamos acostumbrados a ver en los esqueletos un boucle articles en el que se incluyen las balizas habituales: título(titre), fecha, autor, etc.

    Si miramos la base de datos de spip, concretamente la tabla spip_articles, vemos que tiene 29 campos, cada uno de ellos dará lugar a una BALIZA del mismo nombre que el campo (salvo en MAYÚSCULAS y precedida por el símbolo #).

    Además SPIP calcula nuevas BALIZAS basándose en esos campos y en otros datos, por lo que las posibilidades de expresar un artículo (o las balizas del mismo) son inmensas.

    Bucle Artículos Recientes

    Demos un vistazo a esos 29 campos:

    Estructura de la tabla spip_articles de la base de datos spip (ver 1.9 final)
    NombreTipoNullIndicePor DefectoExtras
    id_articlebigint(21) PRI auto_increment
    surtitretext    
    titretext    
    soustitretext    
    id_rubriquebigint(21) MUL0 
    descriptiftext    
    chapomediumtext    
    textelongblob    
    psmediumtext    
    datedatetime  0000-00-00 00:00:00 
    statutvarchar(10) MUL0 
    id_secteurbigint(21) MUL0 
    majtimestamp(14)YES   
    exportvarchar(10)YES oui 
    date_redacdatetime  0000-00-00 00:00:00 
    visitesint(11)  0 
    referersint(11)  0 
    popularitedouble  0 
    accepter_forumchar(3)    
    date_modifdatetime MUL0000-00-00 00:00:00 
    langvarchar(10) MUL  
    langue_choisiechar(3)YES non 
    id_tradbigint(21) MUL0 
    extralongblobYES   
    idxenum(’’,’1’,’non’,’oui’,’idx’) MUL  
    id_versionint(10) unsigned  0 
    nom_sitetinytext    
    url_sitevarchar(255) MUL  
    url_proprevarchar(255) MUL  

    Todos los campos dar lugar a una baliza:

    campo #BALIZA Descripción
    id_article #ID_ARTICLE nº que identifica a cada artículo. Se incrementa automáticamente
    surtitre #SURTITRE antetítulo
    titre #TITRE título
    soustitre #SOUSTITRE subtítulo
    id_rubrique #ID_RUBRIQUE nº que identifica la sección a la que pertenece el artículo
    descriptif #DESCRIPTIF descripción
    chapo #CHAPO epígrafe
    texte #TEXTE texto principal del artículo
    ps #PS PostData
    date #DATE Fecha de publicación (o de creación en caso de no estar aún publicado). Se puede modificar trás la publicación
    statut #STATUT Estado del artículo (prepa, prop, publie, refuse o poubelle)
    id_secteur #ID_SECTEUR identificador del sector (rama principal; sale directamente de la raíz)
    maj #MAJ última modificación en la tabla (calculado por MySQL)
    export #EXPORT ???
    date_redac #DATE_REDAC Fecha de la primera publicación. Modificable. Se puede elegir «no mostrar»
    visites #VISITES número de visitas del artículo
    referers #REFERERS Enlaces al artículo desde otras páginas de Internet
    popularite #POPULARITE Popularidad del artículo en porcentaje
    accepter_forum #ACEPTER_FORUM Indica si el artículo acepta comentarios y el tipo de moderación
    date_modif #DATE_MODIF Fecha de laúltima vez que se abrió el artículo para editarlo (aunque no modificara nada)
    lang #LANG idioma del artículo
    langue_choisie #LANGUE_CHOISIE
    id_trad #ID_TRAD
    extra #EXTRA
    idx #IDX Está o no indexado
    id_version #ID_VERSION
    nom_site #NOM_SITE Nombre del sitio refrenciado en el artículo
    url_site #URL_SITE URL del sitio refrenciado en el artículo
    url_propre #URL_PROPRE

    Algunas de las balizas se explicarán más detalladamente en artículos posteriores. Incluso puede que no le encuentres sentido a algunas, pues sólo sirven como enlace para otras tablas (por ejemplo referers).

    Para que estén disponibles algunas balizas, tienen que estar activadas en la configuración. Por ejemplo si entramos en:
    Configuración del sitio / Contenido del sitio /Los artículos

    vemos que las opciones pueden estar activadas o No activadas. Si no está activada Enlaces hipertexto no estarán disponibles las balizas NOM_SITE y URL_SITE. Puedes ver un ejemplo de artículo con enlace hipertexto-lubrin.org/probando_spip/spip.php?article9

    Veamos un ejemplo con un artículo real que se encuentra en:
    lubrin.org/probando_spip/spip.php?article1

    campo
    id_article
    surtitre
    titre
    soustitre
    id_rubrique
    descriptif
    chapo
    texte
    ps
    date
    statut
    id_secteur
    maj
    export
    date_redac
    visites
    referers
    popularite
    accepter_forum
    date_modif
    lang
    langue_choisie
    id_trad
    extra
    idx
    id_version
    nom_site
    url_site
    url_propre
    Contenido
    1
    Antetítulo
    Mi primer artículo
    Subtítulo
    1
    descripción rápida de mi primer artículo
    Introducción de mi primer artículo
    Aquí está el texxto o contenido ... (CORTADO)
    Post Data de mi primer artículo
    2006-08-09 11:01:46
    publie
    1
    20060809110147
    oui
    0000-00-00 00:00:00
    2
    0
    0.0196282324760186
    pos
    2006-08-09 10:51:46
    es
    non
    0
     
    oui
    0
     
     
     

    Los datos del artículo anterior se han sacado directamente de la base de datos. En el siguiente ejemplo (un artículo con más de 3000 visitas) veremos los datos extraídos usando las balizas de spip.

    En el enlace siguiente se ve mejor

    El ejemplo está en el siguiente enlace:
    lubrin.org/spip.php?page=articulo_total&id_article=33

  • [11] Fórmulas matemáticas en tus artículos

    Las fórmulas matemáticas en SPIP se insertan usando código LaTeX.

    El procesador de macros o lenguaje de bajo nivel LaTeX no sólo se usa para escribir ecuaciones matemáticas, sino que es lo mejor que existe para redactar artículos científicos o libros técnicos, no sólo porque se puede conseguir cualquier expresión, sino por la calidad final (en PDF) del documento. Afortunadamente no vamos a necesitar instalarlo, ni aprenderlo para poner fórmulas en nuestros artículos.

    ¿Cómo funciona LaTeX en SPIP?
     Las fórmulas se teclean en el artículo usando comandos LaTeX
     Spip las envía a un servidor TeX público y éste se las devuelve a spip ya procesadas y en formato imagen.png
     Spip muestra la imagen.png en el artículo y además la guarda en la caché, de forma que si vuelves a necesitar la misma fórmula la saca de la caché para evitar tener que enviarla a procesar de nuevo.

    Por tanto, estamos dependiendo de un server público, que en ocasiones pudiera estar saturado, y que tiene un tamaño predeterminado para los caracteres de las fórmulas. Aunque es suficiente para unas pocas fórmulas, si quieres crear un blog o web que las use a menudo (como la base de datos de ejercicios de matemáticas de esta web) se hace necesario instalar nuestro propio servidor TeX (lo haremos posteriormente, cuando esté más avanzado nuestro manual).

    Pero vayamos al grano:

    Insertar una fórmula entre el texto

    Usaremos la siguiente expresión:
    <math> $ fórmula $ </math>

    Por ejemplo el código siguiente:

      La fórmula <math> $ 1 +\frac{2x}{5} $ </math> siqnifica que ...

    ofrecerá como salida:

     La fórmula  1 + \frac{2x}{5} siqnifica que ...

    Insertar una fórmula centrada

    Usaremos la siguiente expresión:
    <math> $$ fórmula $$ </math>

    Por ejemplo el código siguiente:

      <math> $$ 1 +\frac{2x}{5} $$ </math>

    ofrecerá como salida:

     1 + \frac{2x}{5}

    Varias fórmulas en un artículo

    Si se usan muchas fórmulas en un mismo artículo, pondremos sólo una vez las etiquetas <math> y </math> (por ejemplo al principio y al final del documento), sin embargo sí hay que poner el símbolo $ al principio y final de cada fórmula.
    Por ejemplo el código siguiente:

     Calcula la función derivada de las siguientes funciones:
    <math>
    - a) $f(x) = 2x^5 - 4x^3 + 5x -12$
    - b) $g(x) = \frac{x^2-3x}{2x-5}$
    </math>

    ofrecerá como salida:

    Calcula la función derivada de las siguientes funciones:

     a) f(x) = 2x^5 - 4x^3 + 5x -12
     b) g(x) = \frac{x^2-3x}{2x-5}

    Resumen de comandos LaTeX

     Exponentes, subíndices, fracciones y radicales

    LaTeX   Resultado
    x^3+5x^2 x^3+5x^2
    A_0=x_0+x_1 A_0=x_0+x_1
    \frac{2x}{3} \frac{2x}{3}
    \sqrt{3x^2+5} \sqrt{3x^2+5}
    \sqrt[3]{3x^2+5} \sqrt[3]{3x^2+5}

     Letras griegas y símbolos matemáticos

    LaTeX   Resultado  LaTeX   Resultado
    \alfa \alpha \exists $\exists$
    \beta $\beta$ \infty $\infty$
    \gamma $\gamma$ \forall $\forall$
    \delta $\delta$ \emptyset $\emptyset$
    \epsilon $\epsilon$ \pm $\pm$
    \pi $\pi$ \cup $\cup$
    \sigma $\sigma$ \cap $\cap$
    \omega $\omega$ \leq $\leq$
    \theta $\theta$ \geq $\geq$
    \lambda $\lambda$ \neq $\neq$
    \mu $\mu$ \in $\in$
    \Omega $\Omega$ \notin $\notin$
    \rho $\rho$ \subset $\subset$

     Flechas, espacios, puntos suspensivos, ...

    LaTeX   Resultado  LaTeX   Resultado
    \rightarrow  \rightarrow \ldots \ldots
    \leftarrow \leftarrow \cdots \cdots
    \Rightarrow \Rightarrow \vdots \vdots
    \Leftarrow \Leftarrow \ddots \ddots
    \Longrightarrow \Longrightarrow \: \:espacio\:
    \Longleftarrow \Longleftarrow \bigcup \bigcup
    \longrightarrow \longrightarrow \bigcap \bigcap
    \longleftarrow \longleftarrow
    \leftrightarrow \leftrightarrow
    \Leftrightarrow \Leftrightarrow
    \longleftrightarrow \longleftrightarrow
    \Longleftrightarrow \Longleftrightarrow

     A veces necesitamos escribir algunos caracteres encima de otros:

    \overline{A} \overline{A} \underline{A} \underline{A}
    \bar{B} \bar{B} \underbar{B} \underbar{B}
    \overbrace{a+b} \overbrace{a+b} \underbrace{a+b} \underbrace{a+b}
    \vec{a} \vec{a} \dot{a} \dot{a}

    Para más información puedes visitar la sección LaTeX de esta misma web

  • [10] Redactar artículo - Insertar imágenes y Previsualizar

    Insertar imágenes

    Para insertar una imagen en un artículo se puede usar código html:

     <img src="http://...">


    O mejor aprovechar las ventajas de spip:

    Añadir una imagen


     Cuando estamos redactando el documento, tenemos (arriba-izquierda) la zona: AÑADIR UNA IMAGEN
     Pulsamos sobre Examinar y la buscamos en nuestro disco duro
     Pulsamos sobre Subir

    Añadir imagen - Opciones

     Nos aparece entonces un nuevo panel donde podemos poner Título y Descripción que aparecerán (bajo la imagen) en el artículo. Si rellenas alguno de estos campos, no olvides pulsar después Guardar
     A continuación debemos decirle a spip en qué lugar queremos insertar la imagen y su alineación (izquierda, derecha o centrada). Para ello ponemos el cursor en la parte del artículo donde queramos insertarla y hacemos doble clic sobre una de las tres opciones:

    <img1|left> <img1|center> <img1|right>

    Cuando sean muchas las imágenes que necesitamos incluir en nuestros artículos, es más rápido subirlas todas a la vez.

     Tendremos que hacerlo entonces mediante ftp y ponerlas en la carpeta /ecrire/upload.
     Pulsamos en el triangulito que hay delante de Enviar desde tu ordenador .. en el panel Añadir una imagen
     Pulsamos sobre Instalar todos los documentos
     Elegimos la imagen a insertar
     Pulsamos sobre elegir
     La insertamos igual que hicimos antes

     

    Insertar documentos

    Procedemos de forma análoga a insertar imágenes. La única diferencia es que podemos elegir un icono personalizado para el documento (aunque si es uno de los formatos normales, por ejemplo PDF, spip ya tiene buenos iconos)

    Previsualizar un artículo

    Aunque después de editar un artícuo, cuando pulsamos Guardar spip nos ofrece una aproximación de cómo quedará, la opción de previsualizarlo nos hará verlo exactamente y en su contexto, tal y como quedará al publicarlo.

    La opción de previsualizar no está disponible por defecto, por lo que tendremos que entrar en la configuración y modificarla.
    Configuración del sitio / Opciones avanzadas

    Entonces buscamos el panel Previsualización y lo modificamos

    Además, para que se pueda previsualizar es necesario que el artículo esté Propuesto a la evaluación, pues mientras esté En curso de redacción no se puede previsualizar

  • [09] Redacción de un artículo completo

    Escribo aquí un artículo completo en el que intentaré usar todo lo que puede necesitar un redactor (insertar imágenes, tablas, listas, tipografías, etc.).

    El primer problema que nos surge (normalmente al escribir nuestro primer artículo) es el siguiente:

    Si escribimos

    Las causas que influyeron fueron:
          En primer lugar el clima ...

    Obtenemos:

    Las causas que influyeron fueron:
    En primer lugar el clima ...

    ¿Por qué no respeta el salto de línea? ¿Tengo que escribir códigos html?
    Sí, puedes insertar todos los códigos html que quieras, o mejor aún: puedes usar los Atajos tiopgráficos de SPIP.

    Para obtener el texto:

    Primera línea.
    Línea siguiente.

    Nuevo párrafo

    puedo usar código html:

    o bien, usar atajos tipográficos de spip:

    Primera línea.
    _ Línea siguiente.
    
    Nuevo párrafo

    Es recomendable usar los atajos tipográficos y puedes ontener información sobre los mismos en la propia Ayuda en línea de SPIP, a la que se accede desde el espacio privado.

    Los más usados son:

    Atajo   Resultado Aclaraciones
    _ Salto de línea Guión bajo seguido de espacio
    Nuevo párafo Dejamos una o varias líneas en blanco
    { } cursiva
    {{ }} negrita
    {{{ }}}

    título

    Deja línea en blanco antes y después
    ----
    Línea horizontal de separación

    Pero hay muchos más:

    Link o enlaces

     Hacia sitios externos
    El código La web [Matemáticas IES->http://lubrin.org/mat] producirá:
    La web

     Hacia un artículo de nuestro sitio
    El código Puedes visitar el [Índice->390] de capítulos producirá:
    Puedes visitar el Índice de capítulos

     Hacia un glosario externo (por defecto la wikipedia)
    El código La localidad de [?Lubrín] está situada en ... producirá:
    La localidad de Lubrín está situada en ...

     Hacia un ancla (zona concreta de la página)
    El ancla debe existir en la forma [ancla<-]
    Ponemos un ancla al principio y el enlace entonces quedaría así: Para ir al [principio->#inicio] del presente artículo y se verá:
    Para ir al principio del presente artículo

    Notas a pié de página [1]

     De forma automática [2] el siguiente código:

    Los usuarios de Linux[[En realidad deberíamos llamarle GNU/Linux]] no tenemos problemas de virus.

    producirá:
    Los usuarios de Linux [3] no tenemos problemas de virus.

     Manualmente, donde nosotros elegimos la numeración de la nota.
    El código siguiente:
    Mi número primo[[<13> forzando la numeración de la nota]] preferido ... producirá:
    Mi número primo [13] preferido ...

    Listas

    Listas sin numerar

    - uno
    - dos
    - tres

    Resultado:


     uno
     dos
     tres

    Listas numeradasr

    -# uno
    -# dos
    -# tres

    Resultado:

    1. uno
    2. dos
    3. tres

    Listas ramificadas

    - uno
    -* uno-1
    -* uno-2
    -** uno-2-1

    Resultado:

     uno

    • uno-1
    • uno-2
      • uno-2-1

    <code> , <quote> y <cadre>

    <code>
    texto bajo las etiquetas code
    </code>
    Resultado:

    texto bajo las etiquetas code

    <cadre>
    texto bajo las etiquetas cadre
    </cadre>
    Resultado:

    <quote>
    texto bajo las etiquetas quote
    </quote>
    Resultado:

    texto bajo las etiquetas quote

    Normalmente se suelen definir estilos con css para las tres etiquetas anteriores eligiendo un borde para recuadro, tipografía, fondo, etc.
    Puedes ver este artículo con los formatos predefinidos de spip aquí: lubrin.org/probando_spip/spip.php?article4

    tablas

    El código para una tabla es:

    | {{ columna1}} | {{ columna2}} |{{ columna3}} |
    | fila1-1 | fila1-2 | fila1-3 |
    | fila2-1 | fila2-2 | fila2-3 |
    | fila3-1 | fila3-2 | fila3-3 |

    Onteniéndose el resultado:

    columna1 columna2 columna3
    fila1-1 fila1-2 fila1-3
    fila2-1 fila2-2 fila2-3
    fila3-1 fila3-2 fila3-3

    Consejos:
     si queremos la primera fila resaltada usar {{negritas}}
     No poner espacio trás la última barra vertical de cada fila

    HTML & Atajos Tipográficos de SPIP

    A veces nos pueden surgir problemas cuando SPIP interpreta como atajo tipográfico algo que nosotros no queremos. Veamos un ejemplo:

    Quiero escribir la expresión:

    El conjunto B de números impares = {1, 3, 5, ...}

    Sin embargo si escribo:

    El conjunto B de números impares = {1, 3, 5, ...}


    me mostrará:

    El conjunto B de números impares = 1, 3, 5, ...


    porque las llaves { } las interpreta como el atajo para la cursiva. Debemos decirle a spip que esas llaves no son atajos.
    Para que spip no interprete los atajos hay que usar las etiquetas <html> y </html>. Para conseguir lo deseado en el ejemplo anterior debemos escribir:

    El conjunto B de números impares = <html>{1, 3, 5, ...}</html>

    Puesto que se ha hecho ya demasiado extenso, dejo los funciones avanzadas (insertar imágenes, revisar ortografía, fórmulas matemáticas, etc.) para un posterior artículo.

  • [08] Personalizando la portada en SPIP

    En este artículo vamos a analizar la portada de nuestra web para estar en condiciones de modificarla.

    Veamos la configuración de portada que trae SPIP por defecto, analizando el fichero sommaire.html. Para ello he dejado que se vea parte del código (en colores) en la página de pruebas. Observa las imágenes siguientes (también puedes verlo completo en lubrin.org/probando_spip)

    Los códigos a analizar son:

     Los INCLURE para cabecera, pié de página y secciones

    <INCLURE{fond=inc-entete}{lang}> 
    <INCLURE{fond=inc-pied}{lang}> 
    <INCLURE{fond=inc-rubriques}{lang}>

    Las tres líneas anteriores serán sustuidas por el contenido de los ficheros inc-entete.html, inc-pied.html y inc-rubriques.html (estos ficheros están incluidos en el esqueleto). Por tanto si queremos modificar cabecera, pié o secciones de nuestra portada, tendremos que modificar los ficheros anteriores.

     Los estilos div id=, div class=, ..

    <div id="contenu">
    <div class="contre-encart">
    <div class="encart">
    <div id="navigation">

    Separan las diferentes partes de la portada

     Los BOUCLES

    <B_articles_recents> (Bucle últimos artículos)
    <B_articles> (Bucle resto de artículos)
    <B_breves> (Bucle de breves)
    <B_forums_liens> (Bucle de últimos comentarios)
    <B_syndic> (Bucle de sitios sindicados)

    Si nos interesa, por ejemplo que los sitios sindicados aparezcan en la parte derecha, no tenemos más que quitar el boucle y ponerlo dentro de navigation:

    <div id="navigation">
    ...
    <B_syndic>
        bucles de sitios sindicados
    </B_syndic>
    ...
    </div>  <!-- fin de navigartion -->

    Evidentemente también se pueden eliminar bucles y/o añadir otros es incluso podemos añadir código html en cualquier parte de la página.