Carnet Wiki

syntaxes spécialisées

Version 3 — October 2011 JLuc

Cette page vise à recenser les syntaxes spécialisées utilisées ici ou là dans l’écosystème spip.
Ayant par nature la caractéristique d’être ’“hors spip”, le risque est qu’elles se multiplient dans l’ignorance l’une de l’autre, entrainant éparpillement et difficultés d’apprentissage.

Cette connaissance peut faciliter le choix d’une syntaxe spécialisée lorsqu’il y en a besoin d’une au cours d’un développement, éviter d’avoir des syntaxes différentes à chaque fois, faciliter la maintenance et éventuellement la mutualisation du code pour le développeur, et faciliter l’apprentissage pour l’usager.

SPIP

Les raccourcis d’origines, particulièrement ceux simplifiés, tels [->aut21], [->art23], [->article23],[->23] etc sont déjà, en quelque sorte, des syntaxes spécialisées.

Spip Lettres

Il est possible de personnaliser les lettres en faisant référence aux champs extra de l’abonné ou aux arguments passés par l’API hors_abo avec :
-   %%champ%%
-   %%champ|valeur sinon%%
-   %%valeur avant (#champ|filtre ou valeur sinon) valeur après%%

Saisies, formidable
-  fichiers yaml : pour la description totale d’une saisie
-  chaine composée d’une liste de lignes de couples cle|valeur : pour...
-  formitable utilise ce même format pour décrire les associations id_champ_formidable|nom_champ_table

Couteau Suisse
-  [[%blocs_slide%]][[->%blocs_millisec% millisecondes]] : animer vos blocs dépliables à la manière d’un “glissement”

SVP

Dans son analyse des fichiers XML décrivant un plugin, SVP utilise une syntaxe inspirée des raccourcis spip pour les liens, mais restrictive différente :

<auteur>&#91;Didier A  confirmer  : 
&lt; code><auteur>&#91;Didier , JLuc -> http://www.ouhpla.net]</auteur>

: cette séquence n’est pas bien décryptée par SVP.
_ Il faut indiquer:

 <auteur>Didier, &#91;JLuc->http://www._ Il vaudrait mieux :
_ <code> <auteur>Didier, &#91;JLuc->http://www.ouhpla.net]</auteur> 


ou
<auteur>[Didier->http://www.ouhpla.net], [JLuc->http://www.ouhpla.net]</auteur> _ suivant ce qu’on veut exprimer