Carnet Wiki

Migrer un thème Zpip vers SPIPr

Version 5 — 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é en quelque sorte 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->http://contrib [ici->http://contrib .spip.net/Difference-entre-Zcore-et-Zpip-v1-x], et le framework Z est présenté [dans cet autre article->http://spipr [ici->http://spipr .nursit.com/framework-z].

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. habillage.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. 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="];[" /> dans paquet.xml ou 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.