Le plugin YAML

YAML est un format de fichier simple et néanmoins complet permettant d’éditer des listes de données de manière très aisée.

Pour une présentation de ce format, lire « Je suis fan de YAML ».

YAML est de plus en plus utilisé dans SPIP, par divers plugins (par exemple textwheel, saisies, itérateurs...). Ce plugin permet aux autres plugins d’exploiter ce format, aussi bien en lecture :
— fonction yaml_decode()
— boucle (DATA){source yaml, fichier.yaml}

qu’en écriture :
— fonction yaml_encode()

Son utilisation est on ne peut plus simple.

En PHP

Pour lire des données YAML, il suffit de faire :

include_spip('inc/yaml');
$data = yaml_decode( $contenu_du_fichier_yaml );
var_dump( $data );

Pour transformer un tableau de données (array) en YAML, on fera :

include_spip('inc/yaml');
$yaml = yaml_encode( $tableau );
var_dump( $yaml );

La boucle YAML

Dans un squelette, on utilisera la boucle (DATA) (cela nécessite les itérateurs de SPIP) avec le format yaml :

Boucle :

<BOUCLE_yaml(DATA){source yaml, http://per.sonn.es/Fil.yaml}>
<dt>#CLE</dt>
<dd>[(#VALEUR|print)]</dd>
</BOUCLE_yaml>

Résultat :

name
Fil
sex
F
birthday
1966-08-17
job
Calorifugeur
friends
Maude Guérin, Zohra Robin, Pierre-Yves Philippe, Lauriane Bertin, Jeannine Pichon, Vanessa Michel, Wendy Allard, Sylvie Michaud, Gwenaël Voisin, Paule Mary, Maia Ribeiro, Josianne François, Lucas Fernandes
...

Discussion

2 discussions

Ajouter un commentaire

Avant de faire part d’un problème sur un plugin X, merci de lire ce qui suit :

  • Désactiver tous les plugins que vous ne voulez pas tester afin de vous assurer que le bug vient bien du plugin X. Cela vous évitera d’écrire sur le forum d’une contribution qui n’est finalement pas en cause.
  • Cherchez et notez les numéros de version de tout ce qui est en place au moment du test :
    • version de SPIP, en bas de la partie privée
    • version du plugin testé et des éventuels plugins nécessités
    • version de PHP (exec=info en partie privée)
    • version de MySQL / SQLite / PostgreSQL
  • Si votre problème concerne la partie publique de votre site, donnez une URL où le bug est visible, pour que les gens puissent voir par eux-mêmes.
  • En cas de page blanche, merci d’activer l’affichage des erreurs, et d’indiquer ensuite l’erreur qui apparait.

Merci d’avance pour les personnes qui vous aideront !

Par ailleurs, n’oubliez pas que les contributeurs et contributrices ont une vie en dehors de SPIP.

Qui êtes-vous ?
[Se connecter]

Pour afficher votre trombine avec votre message, enregistrez-la d’abord sur gravatar.com (gratuit et indolore) et n’oubliez pas d’indiquer votre adresse e-mail ici.

Ajoutez votre commentaire ici

Ce champ accepte les raccourcis SPIP {{gras}} {italique} -*liste [texte->url] <quote> <code> et le code HTML <q> <del> <ins>. Pour créer des paragraphes, laissez simplement des lignes vides.

Ajouter un document

Suivre les commentaires : RSS 2.0 | Atom