HTML5 dans SPIPr

Publié le : 23 mars 2015 – par Cerdic

9 votes

Documentation source : http://spipr.nursit.com/html5

Sommaire

HTML5
DocType et support multinavigateurs
Structure des pages
Micro-data
Résumés d’objets
Listes d’objets
Notes

HTML5

SPIP 3 prend en charge nativement certaines parties de HTML5 :

il est possible d’activer le support de HTML5 dans le formulaires pour profiter des type de champs enrichis, de la vérification de champ obligatoire dans le navigateur etc.
l’API History de HTML5 est utilisée pour prendre en charge l’historique de navigation y compris avec les liens ajax.

Avec SPIPr, l’utilisation de HTML5 est généralisée, avec notamment l’utilisation du DocType HTML5, des balises HTML5 pour structurer le contenu de la page de façon plus sémantique, et le recours aux micro-data pour faciliter le référencement.

DocType et support multinavigateurs

Le doctype du squelette est par défaut le doctype HTML5 [1].

<!DOCTYPE HTML>

La prise en charge des vieux navigateurs est assurée par :

l’appel au script HTML5 Shiv dans le <head> du squelette qui permet la prise en charge des nouvelles balise HTML5 dans les vieux navigateurs ;
la pose d’une classe sur <html> qui permet de cibler en CSS les différentes versions de IE ainsi que de prendre en compte l’absence ou la présence de js. Les classes disponibles sont :
- ie6, ie7, ie8, ie9 posées chacune si la page est vue sous IE6, IE7, IE8 ou IE9 ;
- lte7, lte8, lte9 posées si la page est vue sous une version d’IE inéfieure ou égale à 7, 8 ou 9.

Structure des pages

Le contenu principal des pages (bloc content) est structuré comme suit :

<article|section>
	<header class="cartouche">
		Titre et meta informations de la page
	</header>

	<div class="main">
		Contenu principal
	</div>

	<footer>
		PS et Notes
	</footer>

	<aside>
		Portfolio, documents, pétition, commentaires... 
	</aside>
</article|section>

Le <header> présente le Titre enrichi de ses sur-titre et sous-titre éventuels, ainsi que les meta-informations comme les auteurs, la date de publication, le nombre de commentaires, de signatures, les tags :

<header class="cartouche">
	<p class="surtitre">surtitre éventuel</p>
	<h1><span>Titre</span>
		<small class="soustitre">Soustitre</small>
	</h1>
	<p class="publication"><time pubdate="pubdate" datetime="xx"><i class="icon-calendar"></i> date</time><span class="authors"><span class="sep">, </span><i class="icon-user"></i> par X, Y, Z</span></p>
	<div class="postmeta">
		<span class="comments"><span class="sep">|</span><a href="#comments" title="3 commentaires"><i class="icon-comment"></i> 3</a>
		</span>
		<span class="tags">
			<span class="sep">|</span>
			<ul class="inline">
				<li><a class="label" href="/mot1"><i class="icon-tag"></i> Tag pour cette page</a></li>
			</ul>
		</span>
	</div>
</header>

Micro-data

Les micro-data sont issues d’une convention de balisage HTML qui permet d’ajouter une couche sémantique au contenu. Elles permettent à des outils et aux moteurs de recherche de mieux comprendre et analyser la structure de la page et d’y repérer des informations du type :

actualité
événement
personne
lieu
produit...

Le site http://schema.org/ présente les convention les plus utilisées et supportées.

Ce balisage qui améliore le référencement est utilisé lorsqu’il est pertinent : par exemple les listes d’événements sont balisées au moyen de http://schema.org/Event

Résumés d’objets

Une convention de nommage et de markup unifié est utilisé pour le résumé d’objets. Un résumé est une présentation courte du contenu d’un objet éditorial.

Chaque résumé d’objet est généré par un squelette rangé dans le dossier inclure/resume/ (pas d’accent pour le nom de dossier). Le nom du squelette correspond au type de l’objet au sens SPIP (article, breve, site..).
Le plugin Z-Core propose les résumés correspondant aux objets natifs de SPIP :

 inclure/
 	 resume/
 	 	 article.html
 	 	 breve.html
 	 	 comment.html
 	 	 mot.html
 	 	 rubrique.html
 	 	 site.html
 	 	 syndic_article.html

Les résumés ont tous un markup unifié. Voyons l’exemple de l’article, le plus complet :

<article class="entry article hentry">
	<strong class="h3-like entry-title"><a href="..." rel="bookmark">(logo)Titre<span
		class="read-more hide"><i class="icon-chevron-right" title="lire la suite de &laquo;Titre&raquo;"></i></span></a></strong>
	<p class="publication"><time pubdate="pubdate" datetime="xxx"><i class="icon-calendar"></i> date</time><span class="authors"><span class="sep">, </span><i class="icon-user"></i> par X, Y, Z</span></p>
	<div class="introduction entry-content">introduction courte...</div>
	<p class="postmeta">
		<span class="comments">
		<span class="sep">|</span>
		<a  href="...#comments" class="nb_commentaires" title="3 commentaires"]>[<i class="icon-comment"></i> 3</a>
		</span>
		<span class="signatures">
		<span class="sep">|</span>
		<a  href="...#petition" class="nb_signatures" title="2 signatures"><i class="icon-ok-circle"></i> 2</a>
		</span>
	</p>
</article>

Ce markup a plusieurs éléments communs avec le header du contenu de la page d’un objets : informations de publication, meta-données. Certains objets utilisent un conteneur <section> quand il est plus adapté que <article>. Ce conteneur porte toujours une classe du nom de l’objet SPIP (ici article).

Ce markup peut être enrichi des micro-data quand cela est pertinent.

Les résumés d’objet sont autonomes et peuvent ainsi être appelé au besoin dans un squelette, comme dans l’exemple ci-dessous :

<h2>Un article seul</h2>
<BOUCLE_art(ARTICLES){!par date}{0,1}>
	#INCLURE{fond=inclure/resume/article,id_article}
</BOUCLE_art>

Listes d’objets

Les résumés d’objets peuvent également être utilisés pour construire des listes d’objets. Le markup utilisé par convention dans SPIPr est le suivant :

<div class="liste articles">
	<h2>Une liste par defaut</h2>
	<ul class="liste-items">
		<li class="item-header">Une liste par defaut</li>
	<BOUCLE_art2(ARTICLES){!par date}{0,5}{id_auteur=1}>
		<li class="item">#INCLURE{fond=inclure/resume/article,id_article}</li>
	</BOUCLE_art2>
	</ul>
</div>

Il est possible de modifier la présentation des listes au moyen de 3 classes short, long et thumb qui permettent de visualiser le résumé dans une version respectivement courte, longue ou en vignette.

La classe modificatrice peut être posée sur les conteneurs .item, .liste-items, ou .liste. Dans ce dernier cas elle influe également sur l’espacement laissé après la liste. Toutes les listes sont visibles dans une page de démonstration spip.php?page=demo-listes [2].

Liste courte

<div class="liste short articles">
	<h2>Une liste courte</h2>
	<ul class="liste-items short">
		<li class="item-header">Une liste courte</li>
	<BOUCLE_art3(ARTICLES){!par date}{0,5}{id_auteur=1}>
		<li class="item">#INCLURE{fond=inclure/resume/article,id_article}</li>
	</BOUCLE_art3>
	</ul>
</div>

Liste longue

<div class="liste long articles">
	<h2>Une liste longue</h2>
	<ul class="liste-items">
		<li class="item-header">Une liste longue</li>
	<BOUCLE_art1(ARTICLES){!par date}{0,5}{id_auteur=1}>
		<li class="item">#INCLURE{fond=inclure/resume/article,id_article,coupe=3000}</li>
	</BOUCLE_art1>
	</ul>
</div>

Liste de vignettes

<div class="liste articles">
	<h2>Une liste de 3 vignettes</h2>
	<div class="row-fluid liste-items">
		<BOUCLE_artt(ARTICLES){!par date}{0,3}{id_auteur=1}>
			<div class="span4"><div class="item thumb">#INCLURE{fond=inclure/resume/article,id_article}</div></div>
		</BOUCLE_artt>
	</div>
</div>

Listes mixtes

Il est aussi possible de mélanger plusieurs présentations d’objet au sein d’une même liste. Dans l’exemple ci-dessous, le premier article a une présentation long, le second une présentation par défaut, et les suivants une présentation short :

<div class="liste articles">
	<h2>Une liste mixte</h2>
	<ul class="liste-items">
		<li class="item-header">Une liste mixte</li>
	<BOUCLE_art0(ARTICLES){!par date}{0,5}{id_auteur=1}>
		<li class="item[ (#COMPTEUR_BOUCLE|alterner{long,'',short,short,short})]">#INCLURE{fond=inclure/resume/article,id_article}</li>
	</BOUCLE_art0>
	</ul>
</div>

5 ans 1 an 3 mois Sans limite

par date

Aucune discussion

Ajouter un commentaire

Avant de faire part d’un problème sur un plugin X, merci de lire ce qui suit :

Désactiver tous les plugins que vous ne voulez pas tester afin de vous assurer que le bug vient bien du plugin X. Cela vous évitera d’écrire sur le forum d’une contribution qui n’est finalement pas en cause.
Cherchez et notez les numéros de version de tout ce qui est en place au moment du test :
- version de SPIP, en bas de la partie privée
- version du plugin testé et des éventuels plugins nécessités
- version de PHP (exec=info en partie privée)
- version de MySQL / SQLite
Si votre problème concerne la partie publique de votre site, donnez une URL où le bug est visible, pour que les gens puissent voir par eux-mêmes.
En cas de page blanche, merci d’activer l’affichage des erreurs, et d’indiquer ensuite l’erreur qui apparaît.

Merci d’avance pour les personnes qui vous aideront !

Par ailleurs, n’oubliez pas que les contributeurs et contributrices ont une vie en dehors de SPIP.

Qui êtes-vous ?

Nom [Se connecter]

Courriel (non publié)

Pour afficher votre trombine avec votre message, enregistrez-la d’abord sur gravatar.com (gratuit et indolore) et n’oubliez pas d’indiquer votre adresse e-mail ici.

Ajoutez votre commentaire ici

Texte de votre message

Ce champ accepte les raccourcis SPIP {{gras}} {italique} -*liste [texte->url] <quote> <code> et le code HTML <q> <del> <ins>. Pour créer des paragraphes, laissez simplement des lignes vides.

Prévenez-moi de tous les nouveaux commentaires de cette discussion par email

Ajouter un document

Extensions autorisées : gif, jpg, png

Suivre les commentaires : |