Velocity est un framework de templating de texte. Il permet, à partir d’un template et de données, de générer un texte.
Pour rappel, un document JSON, XML ou même HTML est, à la base, un document texte. Et la nouvelle PSL permet de générer un PDF à partir d’une page HTML.
La documentation officielle est là.
Parmi les choses remarquables, sont à noter :
## les commentaires qui commencent par 2 dièses /!\ ils génèrent souvent des problèmes d'interprétation
## l'affectation de variable
#set( $nombre = "2" )
## les IF en multiligne /!\ ça génère des sauts de lignes dans le document final
#if( $var = "toto" )
la variable est bien toto
#else
la variable n'est pas toto
#end
## le même IF en monoligne
#if( $var = "toto" )la variable est bien toto#{else}la variable n'est pas toto#end
## les macros alias les fonctions réutilisables comme celle-ci qui permet de formatter un nombre sur deux chiffres
#macro( formaterNombre $i )#if( $i<10 )0#{end}$i#end
#set( $nombreFormatte = "#formaterNombre( $nombre )" )