Carnet Wiki

Guide du rédacteur

Version 6 — Janvier 2010 Déesse A.

Essai de sensibilisation des rédacteurs au bon usage des balise Typographiques
et aux risques d’utiliser du HTML lors de la rédaction de leurs articles


SPIP autorise l’insertion de balises Le langage utilisé par spip permet techniquement d’inclure des codes HTML dans les textes saisis .
Mis à part le cas particulier du [modèle text->http://www.spip.net/fr_article3715.html] appliqué à un document Cependant , l’interraction entre le HTML, ces insertions ne bénéficient d’aucune analyse , ajouté et les propres raccourcis typographiques de SPIP doit être entièrement géré à la main ce qui nécessite des précautions importantes pour éviter de perturber les propres insertions HTML de SPIP .

Ces possibilités offrent des ouvertures certaines au niveau de la mise en pagge. Ces possibilités offrent des ouvertures certaines dans la mise en page , mais Cependant on évitera de les utiliser sans raisons raison impérieuses :

  • elles Elles ne sont pas sans risques et, sous une apparence «  correcte  » peuvent cacher des incorrections graves grâves du contenu conenu de la page qui ne permettent pas d’affirmer que le «  rendu  » sera le même pour les clients HTTP  ;
    -* le Le site a une identité, définie lors de sa conception. Utiliser des séquences codes «  HTML personnelles  » InLine casse cette identité et l’unité éditoriale du site ;
    -* en insérant du HTML En utilisant de tels codes , on peut très facilement détruire les efforts faits par l’équipe de SPIP et le concepteur pour faciliter au maximum l’accessibilité l’accessibilié du site aux handicapés...
  • SPIP utilise parfois le contenu d’un texte non pour le transmettre tel quel mais pour ces propres opérations (tri, filtrage, affichage en tant qu’attribut de balise ou d’arguments Javascript ). javascript . Dans ce cas, le HTML ajouté perturbe fortement la mise en page.

On utilisera ces possibilités avec la plus extreme prudence...

D’autre part, l’imbrication des différents éléments de typographie peut apporter des surprises...


Texte encadré par les balises <html>... </html>

Encadrer une portion de texte par les balises < tt>html</tt > force html revient à demander à SPIP à le transmettre de reproduire «  tel quel au client HTTP  » le contenu , sans appliquer les règles de mise en page de SPIP interpreter le contenu . Ce texte Les codes HTML sera contenus seront donc interprété interpreté tels quels par l’explorateur WEB utilisé par le client HTTP .

Cette possibilité Ceci sera essentiellement utilisée essenciellement utilisé pour insérer inclure dans un le code d’un article un texte HTML pré-existant une page ou une partie de page html déjà existante .

SPIP ne vérifie pas le contenu entre ces balises. Celui-ci Celui ci doit donc être correct et, idéalement si possible , écrit en XHTML.

Texte encadré par les balises <code> ...

Dans ce cas, ce le texte est traduit par SPIP de sorte pour que le ce qui soit affiché ne soit pas interprété par l’explorateur su client HTTP le visualise mais visualisé tel quel.

Ceci ne sera jamais utilisé dans le rédaction normale d’articles.

Pour des articles Eventuellement , lors d’articles techniques, notamment ceux rédigés par le WebMaster, cela permettra de citer des portions de code sans qu’elles soient interprétées [interpretées[[ceci  (…)" id="nh1">1].
Pour des articles sans contenu technique, cette possibilité n’offre pas d’intérêt.

Insertion Génération de HTML


html «  in line  »

SPIP autorise l’insertion de permet d’inclure directement des balises HTML dans le corps du texte [2]

Cela permet certes d’ajouter de la couleur et d’autres effets typographiques, mais peut casser complètement la structure de la publication. Ceci permet certe d’ajouter de la couleur et d’autres effets typographiques , mais peut casser complètement la structure de la publicatiion On respectera donc scrupuleusement les règles ci dessous [3].

  1. Ne jamais utiliser d’autres balises que <span
  2. Tout <span> ouvert doit être fermé avant :
    • le Le prochain double retour à la ligne,
      -** le Le prochain symbole simbole de liste (-* -**,-#,-##,...),
      )
      -** la La prochaine barre verticale de définition de colonne dans un tableau ;
      -# Les les <span> inserés ne doivent pas être à cheval sur les balises SPIP de typographie [4] ;
      -# Indépendamment -#indépendamment du code HTML inséré, on évitera tout toute enchevètrement de balises différentes
       [différentes [[ une (…)" id="nh5">5]
       ;
  3. Ne jamais utiliser de balises <html> dans :
    • les titres,
    • les noms d’auteur.

-# ne jamais utiliser de balises <html> dans :

    • Les titres
    • Les noms d’auteur