Wiki

Cours: Les commentaires dans un Template

Syntaxe eZ publish d'un commentaire dans un Template

Depuis: 3.4 Doc Site |

Commentaires

Comme la plupart des langages de programmation, les commentaires peuvent être utilisés pour ajouter des explications, descriptions, etc.

Les commentaires d'un template ne sont pas affichés dans le résultat (X)HTML final généré par eZ publish.

Les parties commentées de texte/code d'un template ne seront pas interprétées par le moteur de Template.

Il n'existe qu'un seul moyen d'ajouter des commentaires dans un template : il s'agit d'encapsuler la partie à commenter entre les caractères "{*" et "*}".

En fait, un commentaire n'est autre que du code "Template" eZ publish, excepté que les accolades sont accompagnées par un astérisque. Il est possible de commenter à la fois une seule ou plusieurs lignes. L'emboîtement de commentaires n'est pas supporté. En d'autres termes, il n'est pas possible de commenter un commentaire.
Les exemples suivants indiquent comment utiliser les commentaires :

Commentaire d'une simple ligne
{* Ceci est un commentaire. *}

Ceci ne produira aucun résultat visible.

Commentaire de plusieurs lignes
{* Ceci est un commentaire
 
 
  qui se poursuit
  quelques lignes plus bas
  dans le fichier template. *}

Ceci ne produira aucun résultat visible.

Emboîtement de commentaires
{* {* L'emboîtement de commentaires n'est pas supporté! *} Ce texte sera affiché. *}

La ligne suivante sera alors affichée :

Ce texte sera affiché.