Carnet Wiki

Migrer un thème Zpip vers SPIPr

Version 7 — Mars 2015 tcharlss

Notes pour migrer un thème Zpip vers SPIPr.

Rappelons que SPIPr est une évolution de Zpip, et que leurs thèmes ne sont pas compatibles. Zpip a été séparé en 2 entités : d’un côté le « moteur » Z-core et de l’autre le squelette SPIPr. Les différences sont expliquées en détail dans cet article, et le framework Z est présenté dans cet autre article.

On trouve aussi des notes concises sur la migration directement dans le repertoire de SPIPr : http://zone.spip.org/trac/spip-zone/browser/_squelettes_/spipr-dist/trunk/migration.txt.

1. images/

Renommer le dossier images en img.

2. theme.css

Renommer habillage.css en theme.css et le placer dans le dossier css/ (à créer si nécessaire).
Dedans, changer toutes les occurences de images/xxx.ext en img/xxx.ext.

3. body.html

Éditer body.html et faire les changements suivants :

  • Encapsuler le tout dans une balise <body>
  • #ENV{type}#ENV{type-page}
  • fond=navigationfond=aside
  • fond=entetefond=header
  • fond=piedfond=footer
  • fond=contenufond=content
  • fond=inclure/barre-navfond=inclure/nav

Ajouter le filtre navbar_responsive pour la barre de navigation : [(#INCLURE{fond=inclure/nav,env}|navbar_responsive)]

4. plugin xml ou plugin .xml & paquet.xml
Pour que le thème soit détecté par le sélecteur de Zengarden, ajouter si nécessaire la balise <utilise nom="spipr" compatibilite="];&#91;" /> dans paquet.xml et &lt;utilise id="spipr" compatibilite="];&#91;" /> plugin.xml.


À partir de là, le thème devrait être fonctionnel avec SPIPr, mais il reste sans doute à peaufiner quelques détails dans theme.css.

Sur la zone, les thèmes compatibles SPIPr sont rangés dans le répertoire http://zone.spip.org/trac/spip-zone/browser/_themes_/spipr/v1

À voir également : l’article sur l’écriture de thèmes SPIPr.