SPIP - Documentation technique : mise en conformité
Vous avez pu lire mes 2 précédents articles (ici et ici) sur la Documentation technique d’un plugin en se servant des chaînes de langue offerte par SPIP.
Si vous avez été attentif, vous avez pu lire que j’utilisais les label sous la forme label_champ
et label_champ_explication
...
Oui mais...
Avec cette solution, quand on utilise la Fabrique pour réaliser notre plugin, on devait intervenir quasi systématiquement dans les formulaires d’édition des objets pour changer explication_champ
en label_champ_explication
...
Long et parfois fastidieux. Cela peut ocassionner des erreurs, des oublis.
Mise en conformité selon les règles de SPIP
Le but de cette nomenclature est d’être le plus générique possible et de pouvoir se greffer à tout plugin aisément.
Alors, je vais rectifier un peu le tir pour que nous n’ayons plus à changer les chaînes de langue pour les explications.
Un plugin est déjà sur la zone avec le proof of concept de mes 2 précédents articles.
J’ai pu le tester, le mettre à l’épreuve...
De là, en découle mon virage sur les chaînes de langue.
La mise en application
Si on désire avoir cette documentation technique dans un moindre effort, on va respecter les chaînes de langue générées par la Fabrique.
De ce fait, lorsqu’on crée une chaîne, on la construira sur cette mécanique :
label_champ
documentation_champ
explication_champ
correspondance_champ
export_champ
Les 2 dernières chaînes de langue sont ici pour vous illustrer l’utilisation sur d’autres besoins documentaires.
Prochaine étape
Je vais modifier dans peu de temps le plugin sur la zone pour prendre en compte le raisonnement que j’ai eu jusqu’à maintenant et respecter la nomenclature de SPIP (et de la Fabrique).
Je reviens vers vous très rapidement avec les modifications dudit plugin.
Derniers commentaires
# Le 19 octobre à 13:09, par nico
En réponse à : MagicMirror², ma configuration personnalisée
# Le 25 septembre à 12:01, par Teddy Payet
En réponse à : Un Nouveau Chapitre : Mon Admission dans un MBA en Intelligence Artificielle et Data Innovation
# Le 25 septembre à 11:20, par vY
En réponse à : Un Nouveau Chapitre : Mon Admission dans un MBA en Intelligence Artificielle et Data Innovation
# Le 21 juin à 13:49, par Teddy Payet
En réponse à : Home Assistant : Routine le matin avant l’école
# Le 21 juin à 10:47, par Teddy Payet
En réponse à : Ma domotique open source
# Le 16 juin à 17:15, par Eric
En réponse à : Ma domotique open source