La syntaxe complète d’une balise de langue est la suivante :
<:prefixe:code{param=valeur}|filtre{params}:>
– Le préfixe est également appelé "module".
– l’ensemble prefixe:code
est parfois appelé item de langue
Paramètres
Les balises de langue peuvent recevoir des paramètres qui seront insérés dans les valeurs au moment de la traduction. Les paramètres sont alors écrits dans les fichiers de langue entre signe arobase (@
).
Un chaine de langue pourrait donc être définie par :
'creer_fichier'=>'Créer le fichier @fichier@ ?',
Passage des paramètres
On passe ce paramètre comme indiqué :
<:documentation:creer_fichier{fichier=tete_de_linote.txt}:>
Filtrage des balises de langue
L’intérêt est assez faible, mais il est possible de passer les codes de langue dans les filtres exactement comme les balises de SPIP, par exemple :
<:documentation:longue_description|couper{80}:>
Balises de langue dynamiques
On peut utiliser des valeurs dynamiques pour le module et/ou l’item de langue, ce qui évite d’utiliser la fonction _T. On emploie alors un préfixe =
item dynamique
Au lieu d’écrire [(#VAL{module}|concat{:,#GET{item}}|_T)]
on peut écrire :
<:module:{=#GET{item}}:>
module ET item dynamiques
Au lieu d’écrire [(#GET{module}|concat{:,#GET{item}}|_T)]
, on peut écrire :
<:{=#GET{module}:#GET{item}}:>