Homogénéiser le vocabulaire : « plugins », « extensions », etc.
Le vocabulaire désignant les « trucs qu'on ajoute à SPIP » ne facilite pas la compréhension et gagnerait à être homogénéisé. Reprenons :
Après avoir installé SPIP, on peut le compléter avec :
- un « thème » qui est grosso modo une feuille de style CSS (et ses fichiers graphiques), disponible sous cette forme ou sous forme de fichier zip prêt à l'emploi, dit « plugin »
- un jeu de « squelettes » plus ou moins complet, qui est constitués de fichiers générant le site public, généralement html, mais incluant parfois un thème et disponible sous la forme d'un dossier ou sous forme de fichier zip prêt à l'emploi, dit « plugin »
- de « plugins » qui ajoutent des fonctionnalités à SPIP, mais pas seulement, distribués sous forme de fichier zip prêt à l'emploi, dit « plugin »
- il faut aussi mentionner les « extensions », qui sont en fait des « plugins » et « squelettes » (faut pas oublier la « dist »), mais nommées différemment car distribuées d'office avec SPIP
Pour ne rien simplifier, les répertoires à la racine d'un projet SPIP, s'ils portent les mêmes noms ont un rôle qui ne correspond par tout à fait :
-
/themes
: contient des « thèmes » mais uniquement sous forme de « plugins » et uniquement Z-compatible ! -
/squelettes
: contient des fichiers de tout type (mais jamais de « squelettes » ou « thèmes » distribués sous forme de « plugins » !) et pas seulement des squelettes, contrairement à ce que son nom laisse entendre. C'est le répertoire des surcharges ultimes, pour tout, squelettes, thèmes css, mais aussi pour construire les pages de l'interface d'administration, si, j'vous jure... -
/plugins
: contient des « plugins » qui peuvent être des « plugins », « thèmes » et « squelettes » -
/extensions
: contient les « extensions », c'est-à-dire les « plugins » et « squelettes » distribués avec SPIP
C'est beaucoup trop compliqué à expliquer !
Je suggère vivement qu'on adopte des termes différents pour désigner les « trucs qu'on ajoute » et leur nature.
Par exemple, on pourrait alors expliquer de façon moins confuse, que SPIP est complété par 4 types d'« extensions », terme générique pour désigner tout ce qu'on ajoute à SPIP, ie. tout ce qui étend SPIP :
- « thème »
- « squelettes »
- « plugins »
- « plugins du core » ou « plugins verrouillés » ou ?
les répertoires correspondants seraient :
- -
/themes
: plutôt au singulier, puisqu'on n'en utilise qu'un seul à la fois, non ?- Remarque : la notion de « thème » n'existant pas dans SPIP puisqu'elle est pour l'instant propre à Z, il n'y a pas lieu de la documenter ni d'en prévoir le sous-répertoire. -
/squelettes
: historique, conservé pour rétrocompat, mais à réserver aux squelettes -
/squelettes-dist
: comme d'hab -
/plugins
: comme d'hab -
/plugins-dist
: pour remplacer l'actuel /extensions
et
-
/perso
: dossier de surcharge ultime (qui fonctionnerait donc comme notre actuel dossier /squelettes)
_Voir discussion initiale sur la liste spip-dev :
- message initial : http://permalink.gmane.org/gmane.comp.web.spip.devel/61791
- dans le fil : http://comments.gmane.org/gmane.comp.web.spip.devel/61762_