Date de publication: le jeudi 31 mars 2011 à 18h00
Dernière modification: par Pascal BOYER le jeudi 31 mars 2011 à 18h03

05/07/2007 11:14

versions 3.9, 3.10, 4.x (à relire)

The XML block datatype supports the following tags / elements:
Le datatype Bloc XML supporte les balises suivantes:

• Headings/ Titres
• Bold text/ Texte gras
• Italic text/ Texte italique
• Unformatted text/ Texte non formaté
• Lists/ Listes
• Tables/ Tableaux
• Hyperlinks/ Hyperliens
• Anchors/ Ancres
• Object embedding/ Insertion d'objets
• Custom tags/ Balises personnalisées
• Paragraphs/ Paragraphes

Headings / Titres

Headings/titles can be added by making use of either the "h" or the "header" tag. The "level" parameter controls the size/level of the heading, it must be a number between 1 and 6. The optional "class" parameter allows the use of a desired CSS class. The optional "anchor_name" parameter makes it possible to add an anchor to the heading.
On ajoute des en-têtes/titres avec les balises h ou header et le paramètre level, dont la valeur varie de 1 à 6, indique la taille (le niveau) de l'en-tête (ou du titre). Le paramètre optionnel class permet d'utiliser une classe CSS souhaitée et le paramètre optionnel anchor_name de lier une ancre au titre.

Usage:
Utilisation:

<h [level=""] [class=""] [anchor_name=""] [custom_parameter="" [...] ]>Example</h>

ou

<header [level=""] [class=""] [anchor_name=""] [custom_parameter="" [...] ]>Example</header>

The custom parameters are optional. Their names must be specified using the CustomAttributes[]array in the [header] block within an override for the "content.ini" configuration file. When used, a custom parameter will be available as a template variable with the same name as it was specified in the tag itself.
Les paramètres personnalisés sont optionnels et leur nom doit être défini dans le tableau CustomAttributes[]  de la section [header] du fichier de configuration de surcharge de content.ini. Lorsqu'il est utilisé, un tel paramètre est disponible en tant que variable de template dont le nom est identique à celui spécifié dans la balise même.

By default, the specified levels are increased by one. In other words, a level 1 header in the XML block will become a level 2 header (H2) in the resulting HTML. The reason for this is because the H1 tag is reserved for the name / main title of the content object. The headings inside the XML block will thus become subheadings of the main title. This behavior can be changed by creating an override template for the "/content/datatype/view/ezxmltags/header.tpl" template (it can not be controlled from within an configuration file).
Par défaut, les niveaux indiqués sont incrémentés de 1, c'est à dire qu'un titre de niveau 1 dans le bloc XML devient un titre de niveau 2 dans le code HTML résultant. Ceci est dû au fait que le niveau 1 est réservé au titre/nom principal de l'objet de contenu. Les titres du bloc XML deviennent donc des sous-titres du titre principal. Cependant, ce comportement peut être modifié en créant une surcharge du template /content/datatype/view/ezxmltags/ header.tpl (il n'est pas possible de contrôler ce comportement à partir d'un fichier de configuration).

Bold text / Texte gras

Bold text can be achieved by using one of the following tags: "b", "bold" or "strong". The optional "class" parameter allows the use of a desired CSS class.
Il est possible de mettre du texte en gras avec les balises b ou strong et le paramètre optionnel class permet d'utiliser une classe CSS souhaitée.

Usage:
Utilisation:

<b [class=""] [custom_parameter="" [...] ]>Bold text.</b>

ou

<bold [class=""] [custom_parameter="" [...] ]>Bold text.</bold>

ou

<strong [class=""] [custom_parameter="" [...] ]>Bold text.</strong>

The custom parameters are optional. Their names must be specified using the CustomAttributes[]array in the [strong] block within an override for the "content.ini" configuration file. When used, a custom parameter will be available as a template variable with the same name as it was specified in the tag itself.
Les paramètres personnalisés sont optionnels et leur nom doit être défini dans le tableau CustomAttributes[] de la section [strong]du fichier de configuration de surcharge de content.ini. Lorsqu'il est utilisé, un tel paramètre est disponible en tant que variable de template dont le nom est identique à celui spécifié dans la balise même.

Italic text / Texte italique

Italic/emphasized text can be achieved by using one of the following tags: "i", "em" or "emphasize". The optional "class" parameter allows the use of a desired CSS class.
Il est possible de mettre du texte en italique avec les balises i, em ou emphasize et le paramètre optionnel class permet d'utiliser une classe CSS souhaitée.

Usage:
Utilisation:

<i [class=""] [custom_parameter="" [...] ]>Emphasized text.</i>

ou

<em [class=""] [custom_parameter="" [...] ]>Emphasized text.</em>

ou

<emphasize [class=""] [custom_parameter="" [...] ]>Emphasized text.</emphasize>

The custom parameters are optional. Their names must be specified using the CustomAttributes[]array in the [emphasize] block within an override for the "content.ini" configuration file. When used, a custom parameter will be available as a template variable with the same name as it was specified in the tag itself.
Les paramètres personnalisés sont optionnels et leur nom doit être défini dans le tableau CustomAttributes[] de la section [emphasize]du fichier de configuration de surcharge de content.ini. Lorsqu'il est utilisé, un tel paramètre est disponible en tant que variable de template dont le nom est identique à celui spécifié dans la balise même.

Unformatted text / Texte non formaté

The "literal" tag can be used to output unformatted text, for example program source code, HTML code, XML content, etc. Everything that is inside an a literal block will be rendered in the same way (character by character) as it is within the literal tags (the text will be output using the HTML PRE tags). The optional "class" parameter allows the use of a desired CSS class.
La balise literal permet de créer du texte non formaté. Par exemple, pour du code de programmation, du code HTML, du contenu XML, etc... Tout ce qui est inséré dans un bloc literal est retourné/affiché de la même manière (au caractère près) que s'il est placé à l'intérieur des balises literal (le texte résultant sera produit en utilisant les balises HTML pre). Le paramètre optionnel class permet d'utiliser une classe CSS souhaitée.

Usage:
Utilisation:

<literal [class=""] [custom_parameter="" [...] ]>Example<\literal>

Please note that in the example above, the slash is in the wrong way within the tag that terminates the literal block. This was done in order to make the tag appear on the documentation page (since we're using literal tags to make code blocks). In other words, it should be terminated with a frontslash instead of a backslash.
Retenez que dans l'exemple ci-dessus, le slash ("\") dans la blise literal fermante n'est pas dans le bon sens. C'est un fait exprès afin que la balise apparaisse dans ce document mais dans la réalité il doit être dans l'autre ("/").

The custom parameters are optional. Their names must be specified using the CustomAttributes[] array in the [literal] block within an override for the "content.ini" configuration file. When used, a custom parameter will be available as a template variable with the same name as it was specified in the tag itself.
Les paramètres personnalisés sont optionnels et leur nom doit être défini dans le tableau CustomAttributes[] de la section [literal]du fichier de configuration de surcharge de content.ini. Lorsqu'il est utilisé, un tel paramètre est disponible en tant que variable de template dont le nom est identique à celui spécifié dans la balise même.

Lists / Listes

It is possible to create lists in the same way as in HTML by making use of the "ol", "ul" and "li" tags. In order to use optional custom parameters, their names must be specified using the CustomAttributes[] array in the [ol], [ul], [li] blocks within an override for the "content.ini" configuration file. When used, a custom parameter will be available as a template variable with the same name as it was specified in the tag itself.
Les balises ol, ul et li sont employées, exactement comme en HTML, pour créer des listes. Les paramètres personnalisés sont optionnels et leur nom doit être défini dans le tableau CustomAttributes[] des sections [ol], [ul]et [li]du fichier de configuration de surcharge de content.ini. Lorsqu'il est utilisé, un tel paramètre est disponible en tant que variable de template dont le nom est identique à celui spécifié dans la balise même.

The lists can be nested. The optional "class" parameter allows the use of a desired CSS class. The following examples demonstrate the usage of ordered and unordered lists.
Les listes peuvent être imbriquées et le paramètre optionnel class permet d'utiliser une classe CSS souhaitée. Les exemples suivants illustrent la création de listes ordonnées et non ordonnées.

Ordered lists / Listes ordonnées

<ol [class=""] [custom_parameter="" [...] ]>
<li [class=""] [custom_parameter="" [...] ]>Element 1</li>
<li [class=""] [custom_parameter="" [...] ]>Element 2</li>
<li [class=""] [custom_parameter="" [...] ]>Element 3</li>
</ol>

Unordered lists / Listes non ordonnées

<ul [class=""] [custom_parameter="" [...] ]>
<li [class=""] [custom_parameter="" [...] ]>Element 1</li>
<li [class=""] [custom_parameter="" [...] ]>Element 2</li>
<li [class=""] [custom_parameter="" [...] ]>Element 3</li>
</ul>

Tables / Tableaux

Tables can be created in the same way as in HTML using "table", "tr", "th" and "td" tags. In order to use optional custom parameters, their names must be specified using the CustomAttributes[] array in the [table], [tr], [th], [td] blocks within an override for the "content.ini" configuration file. When used, a custom parameter will be available as a template variable with the same name as it was specified in the tag itself.
Tout comme en HTML, les balises table, tr, th et td servent à créer des tableaux. Les paramètres personnalisés sont optionnels et leur nom doit être défini dans le tableau CustomAttributes[] des sections [table], [tr], [th]et [td]du fichier de configuration de surcharge de content.ini. Lorsqu'il est utilisé, un tel paramètre est disponible en tant que variable de template dont le nom est identique à celui spécifié dans la balise même.

The tables can be nested.
Il est possible de créer des tableaux imbriqués.

Usage:
Utilisation:

<table [class=""] [border=""] [width=""] [custom_parameter="" [...] ]>
...
</table>

The "class", "border" and "width" parameters are optional. The "class" parameter can be used to assign a desired CSS class. The "border" parameter can be used to set a border (number of pixels). The "width" parameter can be used to control the table width (either 0-100% or number of pixels). Table content should be written according to normal HTML table syntax with "tr", "th" and "td" tags, see below.
Les paramètres class, border et width sont optionnels et le paramètre class permet d'utiliser une classe CSS souhaitée. Le paramètre border sert à définir, en pixel, la taille d'une bordure. Quant au paramètre width il contrôle la largeur du tableau (soit entre 0 et 100% soit en nombre de pixel). Le contenu d'un tableau doit être écrit en respectant la syntaxe HTML des tableaux et avec les balises tr, th et td comme indiqué ci-dessous.

Table rows / Lignes du tableau

Table rows can be created in the same way as in HTML:
Les lignes d'un tableau sont créées de la même manière qu'en HTML:

<tr [class=""] [custom_parameter="" [...] ]>Table row content goes here.</tr>

The "class" parameter can be used to set the desired CSS class.
Le paramètre class permet d'utiliser une classe CSS souhaitée.

Table headers / En-tête du tableau

Table headers can be created in the same way as in HTML:
Les en-têtes du tableau sont créés de la même manière qu'en HTML:

<th [class=""] [width=""] [rowspan=""] [colspan=""] [custom_parameter="" [...] ]>Example.</th>

All parameters are optional. The "class" parameter can be used to set the desired CSS class. The "width" parameter can be used to set the width (either as percentage or number of pixels). The "rowspan" and "colspan" parameters are the same as in HTML.
Tous les paramètres sont optionnels et le paramètre class permet d'utiliser une classe CSS souhaitée. Le paramètre width contrôle la largeur de la cellule d'en-tête (soit en pourcentage soit en nombre de pixel). Quant aux paramètres rowspan et colspan ils remplissent le même rôle qu'en HTML.

Table data/cell / Cellules/données du tableau

Table data/cells can be created in the same way as in HTML:
Les données et cellules du tableau sont créées de la même manière qu'en HTML:

<td [class=""] [width=""] [rowspan=""] [colspan=""] [custom_parameter="" [...] ]>Example.</td>

All parameters are optional. The "class" parameter can be used to set the desired CSS class. The "width" parameter can be used to set the width (either as percentage or number of pixels). The "rowspan" and "colspan" parameters are the same as in HTML.
Tous les paramètres sont optionnels et le paramètre class permet d'utiliser une classe CSS souhaitée. Le paramètre width contrôle la largeur de la cellule (soit en pourcentage soit en nombre de pixel). Quant aux paramètres rowspan et colspan ils remplissent le même rôle qu'en HTML.

Hyperlinks / Hyperliens

Hyperlinks can be inserted by making use of the "a" or the "link" tags.
Les hyperliens sont créés à l'aide des balises a ou link.

Usage:
Utilisation:

<a href="" [view=""] [target=""] [ class=""] [title=""] [id=""] [custom_parameter="" [...] ]>Example.</a>

ou

<link href="" [view=""] [target=""] [ class=""] [title=""] [id=""] [custom_parameter="" [...] ]>Example.</link>

The "href" parameter is required and it must be set to a valid address (either external or internal).
Le paramètre obligatoire href doit contenir une adresse web valide (qui peut être externe ou interne).

The "view" parameter will only have effect when used together with internal links (see below). This parameter makes it possible to specify the view that will be used when the node (or object) which the internal link points to is shown. By default, the system always uses the "full" view to show the contents of internal links.
Le paramètre view n'aura d'effet que s'il est utilisé conjointement à un lien interne (voir ci-dessous). Ce paramètre permet de spécifier la vue qui sera utilisée pour afficher le noeud (ou l'objet) pointé par le lien interne. Par défaut, le système a toujours recours à la vue full pour afficher les contenus pointés par les liens internes.

The "target" parameter can be used to control how the target URL should be opened (inside the existing/active browser window/tab or within a new window/tab). The "class" parameter can be used to specify a CSS class that should be used when the link is rendered. The "title" parameter can be used to specify a short title text (will be shown when the pointer is hovering over the link). The "id" parameter is for assigning unique identifiers.
Le paramètre target permet de définir la façon dont doit s'ouvrir l'URL cible (dans la fénêtre active du navigateur ou dans une nouvelle fenêtre ou nouvel onglet, etc...). Le paramètre class permet d'utiliser une classe CSS souhaitée pour l'affichage du lien. Le paramètre title permet de spécifier un court texte qui sera affiché dans une bulle lorsque le pointeur de la souris survolera le lien. Enfin, le paramètre id sert à asigner des identifiants uniques.

The custom parameters are optional. Their names must be specified using the CustomAttributes[] array in the [link] block within an override for the "content.ini" configuration file. When used, a custom parameter will be available as a template variable with the same name as it was specified in the tag itself.
Les paramètres personnalisés sont optionnels et leur nom doit être défini dans le tableau CustomAttributes[] de la section [link]du fichier de configuration de surcharge de content.ini. Lorsqu'il est utilisé, un tel paramètre est disponible en tant que variable de template dont le nom est identique à celui spécifié dans la balise même.

Internal links / Liens internes

It is possible to create internal links (to other nodes and objects) by making use of the "eznode://" and the "ezobject://" notation. The internal links will be created dynamically based on the node/object ID numbers. In other words, if a node is moved, the link(s) will point to the new location(s) and thus they will not be broken.
Il est possible de créer des liens internes (vers d'autres noeuds ou objets) avec les syntaxes eznode:// ou ezobject:// qui créeront dynamiquement le lien interne en se basant sur le numéro de ID du noeud ou de l'objet. Donc, si un noeud est déplacé, le lien pointera vers le nouvel emplacement et restera donc valide.

Link to a node / Lien vers un noeud

A link to a node can be created either by specifying the target node's ID number or the node path. The following examples demonstrate how an internal link to node number 128 can be created.
Un lien pointant vers un noeud est créé en spécifiant soit le numéro de ID du noeud cible soit sont chemin. Les exemples suivants illustrent comment créer un lien interne vers le noeud 128:

<a href="eznode://128">Example.</a>

ou

<link href="eznode://128">Example.</link>

The following examples demonstrate how an internal link to a node located at "products/computers/example" can be created.
Les exemples suivants illustrent la création d'un lien interne vers un noeud dont le chemin est products/computers/example:

<a href="eznode://products/computers/example">Example.</a>

ou

<link href="eznode://products/computers/example">Example.</link>

Link to an object / Lien vers un objet

The following examples demonstrate how an internal link to object number 1024 can be created.
Les exemples suivants illustrent comment créer un lien interne vers l'objet 1024:

<a href="ezobject://1024">Example.</a>

ou

<link href="ezobject://1024">Example.</link>

When object linking is used, the destination address will be generated using the main node assignment of the target object.
Lorsqu'on crée un lien vers un objet, l'adresse de destination est générée en utilisant l'affectation du noeud principal de l'objet cible.

Alternate views / Vues alternatives

The "view" parameter can be used together with both "eznode://" and "ezobject://" links. It makes it possible to display the specified node (if object, its main node will be used) using a specific view instead of the default "full" view. The following example shows how to create an internal link that (when clicked/followed) brings up node number 1024 using the "line" view.
Le paramètre view peut être utilisé avec les deux syntaxes eznode:// et ezobject:// et permet d'afficher le noeud indiqué (pour un objet, c'est son noeud principal qui sera utilisé) par le biais d'une vue spécifique plutôt que par le biais de la vue par défaut full. Les exemples suivants illustrent la création d'un lien interne qui, lorsqu'on clique dessus, affiche le noeud 1024 en utilisant la vue line:

<a href="eznode://1024" view="line">Example (as line).</a>

Anchors / Ancres

The "anchor" tag makes it possible to insert HTML anchors inside the XML block. The inserted anchors will work like standard HTML anchors.
La balise anchor permet d'insérer des ancres HTML dans un bloc XML qui fonctionnent de la même manière que les ancres HTML standards.

Usage:
Utilisation:

<anchor name="" [custom_parameter="" [...] ] />

The "name" parameter must be set to a unique identifier for the anchor. Anchors can be reached by appending the hash character (#) followed directly by the name of the anchor that the browser should jump to. Example: http://www.example.com/hobbies#music
Le paramètre name doit contenir un identifiant unique assigné à l'ancre. Il est possible de rechercher une ancre en ajoutant, à la fin d'un URI, le symbole dièse (#) suivi du nom de l'ancre. Cela aura pour effet d'afficher, dans le navigateur, le texte à partir de la position de l'ancre. Par exemple: http://www.example.com/hobbies#music

The custom parameters are optional. Their names must be specified using the CustomAttributes[] array in the [anchor] block within an override for the "content.ini" configuration file. When used, a custom parameter will be available as a template variable with the same name as it was specified in the tag itself.
Les paramètres personnalisés sont optionnels et leur nom doit être défini dans le tableau CustomAttributes[] de la section [anchor]du fichier de configuration de surcharge de content.ini. Lorsqu'il est utilisé, un tel paramètre est disponible en tant que variable de template dont le nom est identique à celui spécifié dans la balise même.

Object embedding / Insertion d'objets

The "embed" tag makes it possible to insert an arbitrary content object directly in the XML block. It can for example be used to embed images.
Avec la balise embed il devient possible d'insérer dans le bloc XML n'importe quel contenu d'objet. Cela permet d'insérer, par exemple, des images.

Usage:
Utilisation:

<embed href="" [class=""] [view=""] [align=""] [target=""] [size=""] [id=""] [custom_parameter="" [...] ] />

Custom tags / Balises personnalisées

In addition to the default tags described above, the "XML block" datatype makes it possible to use custom tags. A custom tag can be used both as a block or an inline element. Custom tags must be specified using the "AvailableCustomTags[]" array in the [CustomTagSettings] block within an override for the "content.ini" configuration file. When the XML is rendered, the contents of a custom tag will be replaced by a custom template. The name of the template must be specified using the "name" parameter.
En plus des balises présentes par défaut et décrites ci-dessus, le datatype XML bloc permet l'usage de balises personnalisées. Ces dernières peuvent être employées aussi bien en tant qu'élément block qu'en tant qu'élément inline. Les balises personnalisées doivent être définies dans le tableau AvailableCustomTags[]de la section [CustomTagSettings]du fichier de configuration de surcharge de content.ini. Lors du rendu du XML (???), le contenu d'une balise personnalisée est remplacé par un template personnalisé dont le nom doit être affecté au paramètre name.

Example of usage:
Exemple d'utilisation:

<custom name="template_name" [custom_parameter="value" [...] ]>
The quick brown fox jumps over the lazy dog.
</custom>

The custom tag in the example above will be replaced by a template called "template_name.tpl". This template must be located in the following directory within the current design: "/templates/content/datatype/view/ezxmltags/" (or one of the fallback designs). It is also possible to create an override template. The contents of the tag will be available in the "$content" variable within the inserted template. The custom parameters are optional. Their names must be specified using the CustomAttributes[] array within an override for the "content.ini" configuration file. When used, a custom parameter will be available as a template variable with the same name as it was specified in the tag itself.
Dans l'exemple ci-dessus, la balise personnalisée sera remplacée par un template appelé template_name.tplsitué dans le répertoire /templates/content/datatype/view/ezxmltags/ du design courant (ou d'un design de replis). Il est également possible de créer une surcharge de ce template. Le contenu de la balise sera disponible dans le template inséré via la variable $content. Les paramètres personnalisés sont optionnels et leur nom doit être défini dans le tableau CustomAttributes[] du fichier de configuration de surcharge de content.ini. Lorsqu'il est utilisé, un tel paramètre est disponible en tant que variable de template dont le nom est identique à celui spécifié dans la balise même.

Paragraphs / Paragraphes

Paragraphs can be added by making use of either the 'p' or the 'paragraph' tag.
Les paragraphes sont créés au moyen des balises p ou paragraph.

The optional 'class' parameter allows the use of a desired CSS class. If you do not specify the class parameter, the paragraph will be displayed in a natural way (without tags) in the administration interface. To create a non-classified paragraph, you can simply press 'Enter' key twice.
Le paramètre optionnel class permet d'utiliser une classe CSS souhaitée. Si vous ne spécifiez pas ce paramètre, le paragraphe sera affiché de façon naturelle (sans balise) dans l'interface d'administration. Pour créer un paragraphe assigné d'aucune classe CSS il vous suffit d'appuyer deux fois sur la touche Enter de votre clavier.

Usage:
Utilisation:

<p [class=""] [custom_parameter="" [...] ]>Example</p>

ou

<paragraph [class=""] [custom_parameter="" [...] ]>Example</paragraph>

By default, the system will use 'p' tag in the resulting XHTML code. This behavior can be changed by creating an override template for the '/content/datatype/view/ezxmltags/paragraph.tpl'.
Par défaut, le système utilise la balise p dans le code XHTML résultant. Ce comportement peut être modifié en créant une surcharge du template /content/datatype/view/ezxmltags/ paragraph.tpl

The custom parameters are optional. Their names must be specified using the CustomAttributes[] array in the [paragraph] block within an override for the "content.ini" configuration file. When used, a custom parameter will be available as a template variable with the same name as it was specified in the tag itself.
Les paramètres personnalisés sont optionnels et leur nom doit être défini dans le tableau CustomAttributes[] de la section [paragraph]du fichier de configuration de surcharge de content.ini. Lorsqu'il est utilisé, un tel paramètre est disponible en tant que variable de template dont le nom est identique à celui spécifié dans la balise même.

Commentaires