Ayla's learning materials Matériel pédagogique d'Ayla
Public

Elements, attributes and hierarchyÉléments, attributs et hiérarchie

Four notions are enough to read an XML document: elements, attributes, empty elements and hierarchy.

Elements and tags

The element <seg>Install the pump.</seg> in three parts: the opening tag, the content between the tags, and the closing tag, with the three together labelled as one element; between the tags comes the text itself, which a tool shows and which gets edited as text, and inside a tag comes a description of that text, which makes the file work
Figure 2. The parts of an element, and the distinction that matters most when you open a file.
  • <seg> is the opening tag;
  • </seg> is the closing tag;
  • the text between the two is the element’s content.

Whether text appears inside a tag or between two tags decides what that text is. Between the tags comes the text itself: a segment waiting to be translated, a translation already made, a term in a glossary. A tool puts that on screen, and it gets edited as text. A tag gives a description of it instead: its language, its date, the unit it belongs to. That description makes the file work, and it stays as it is. Both have their exceptions: an HTML alt, from the previous chapter, lives inside a tag and does get translated, while an XLIFF <note> comes between tags but is a message to you rather than text to work on.

Attributes

Simplified excerpt from a TMX file:

<tu tuid="41" creationdate="20240915T093000Z">
    <tuv xml:lang="en-CA">
        <seg>Install the pump on a level surface.</seg>
    </tuv>
</tu>

tuid, creationdate and xml:lang are attributes.TMX fixes the date format: year, month, day, a T, then the time in universal time and a Z. 20240915T093000Z reads as 15 September 2024 at 9:30 UTC. Here the text to translate lies between the tags and the metadata metadatamétadonnée datadonnées Structured information that describes, identifies, or provides context for other data. In a marked-up document or translation format, metadata may indicate the language, author, creation date, file type, segment identifier, translation status, subject field, or origin of the content. Metadata may be stored in elements or attributes. It is generally distinguished from the main content to be translated, although some metadata values may themselves require localization.Information structurée qui décrit, identifie ou contextualise d'autres données. Dans un document balisé ou un format de traduction, les métadonnées peuvent indiquer la langue, l'auteur, la date de création, le type de fichier, l'identifiant d'un segment, son état de traduction, le domaine ou la provenance du contenu. Elles peuvent être stockées dans des éléments ou dans des attributs. On les distingue généralement du contenu principal à traduire, même si certaines de leurs valeurs peuvent elles-mêmes devoir être localisées. (identifier, date, language) goes in the attributes. That split is common, and XML does not require it: the standard gives the two forms no particular meaning, and a format can perfectly well keep its metadata in child elements. TBX does.

Empty elements

An element with no content is written as a single tag, closed with a slash:

<ph id="3"/>

ph is short for placeholder.The name comes from XLIFF, where <ph> stands for something in the original document that has no text of its own. TMX has a <ph> too, but there it has the original code as its content instead of standing empty. You will meet empty elements mostly inside segments, where they stand in for whatever the original document had at that spot and is not text: a line break, an image, an automatic field. In HTML HyperText Markup Language (HTML)langage HTML (HTML) markupbalisage The markup language of web pages: a vocabulary of elements laid down by a standard, marking headings, paragraphs, links, images and the rest, which a browser renders.Langage de balisage des pages web : un vocabulaire d'éléments fixé par une norme, qui marque les titres, les paragraphes, les liens, les images et le reste, et qu'un navigateur affiche. , <br> and <img> do the same job.

Hierarchy

Elements nest inside one another and form a tree: each element can contain other elements, its children.

<tu>
    <tuv xml:lang="en-CA">
        <seg>Install the pump on a level surface.</seg>
    </tuv>
    <tuv xml:lang="fr-CA">
        <seg>Installez la pompe sur une surface plane.</seg>
    </tuv>
</tu>

A translation unit translation unit (TU)unité de traduction (UT) CAT toolsTAO A record that associates a source-language segment with its target-language equivalent, usually together with relevant metadata.Enregistrement qui associe un segment de la langue source à son équivalent dans la langue cible, généralement accompagné de métadonnées. (tu) contains its language variants (tuv, translation unit variant), which each contain their segment segmentsegment CAT toolsTAO A portion of translatable content that a CAT tool treats as a discrete unit for translation, alignment, storage and match retrieval.Portion de contenu à traduire qu'un outil de TAO traite comme une unité distincte aux fins de traduction, d'alignement, de stockage et de recherche de correspondances. (seg). This nesting is what lets rich structures be represented in a plain text file that machines and humans can both read. Figure 1, on the previous page, draws exactly this nesting.

Written alternately in EN and FR, translation partly generated in both directions. Rédigé en alternance en EN et en FR, traduction en partie générée dans les deux sens. Updated 2026-08-30

Quatre notions suffisent pour lire un document XML : les éléments, les attributs, les éléments vides et la hiérarchie.

Éléments et balises

L'élément <seg>Install the pump.</seg> en trois parties : la balise ouvrante, le contenu entre les balises et la balise fermante, les trois formant ensemble un élément ; entre les balises vient le texte lui-même, celui qu'un outil affiche et qui se modifie comme du texte, et dans une balise une description de ce texte, qui fait fonctionner le fichier
Figure 2. Les parties d'un élément, et la distinction qui compte le plus quand vous ouvrez un fichier.
  • <seg> est la balise ouvrante ;
  • </seg> est la balise fermante ;
  • le texte entre les deux est le contenu de l’élément.

Selon qu’un texte apparaît dans une balise ou entre deux balises, sa nature n’est pas la même. Entre les balises vient le texte lui-même : un segment à traduire, une traduction déjà faite, un terme dans un glossaire. Un outil l’affiche, et il se modifie comme du texte. Une balise donne plutôt une description de ce texte : sa langue, sa date, l’unité à laquelle il appartient. Cette description fait fonctionner le fichier et ne se touche pas. Les deux ont leurs exceptions : un alt HTML, vu au chapitre précédent, est dans une balise et se traduit bel et bien, tandis qu’un <note> XLIFF vient entre des balises mais s’adresse à vous au lieu d’être du texte à traiter.

Attributs

Extrait simplifié d’un fichier TMX :

<tu tuid="41" creationdate="20240915T093000Z">
    <tuv xml:lang="en-CA">
        <seg>Install the pump on a level surface.</seg>
    </tuv>
</tu>

tuid, creationdate et xml:lang sont des attributs.TMX impose le format des dates : année, mois, jour, un T, puis l’heure en temps universel et un Z. 20240915T093000Z se lit « le 15 septembre 2024 à 9 h 30 UTC ». Ici, le texte à traduire est entre les balises et les métadonnées metadatamétadonnée datadonnées Structured information that describes, identifies, or provides context for other data. In a marked-up document or translation format, metadata may indicate the language, author, creation date, file type, segment identifier, translation status, subject field, or origin of the content. Metadata may be stored in elements or attributes. It is generally distinguished from the main content to be translated, although some metadata values may themselves require localization.Information structurée qui décrit, identifie ou contextualise d'autres données. Dans un document balisé ou un format de traduction, les métadonnées peuvent indiquer la langue, l'auteur, la date de création, le type de fichier, l'identifiant d'un segment, son état de traduction, le domaine ou la provenance du contenu. Elles peuvent être stockées dans des éléments ou dans des attributs. On les distingue généralement du contenu principal à traduire, même si certaines de leurs valeurs peuvent elles-mêmes devoir être localisées. (identifiant, date, langue) sont dans les attributs. C’est une répartition fréquente, que XML n’impose pas : la norme n’attribue aucun sens particulier aux deux formes, et un format peut parfaitement ranger ses métadonnées dans des éléments enfants. TBX le fait.

Éléments vides

Un élément sans contenu s’écrit d’une seule balise, fermée par une barre oblique :

<ph id="3"/>

ph est l’abréviation de l’anglais placeholder.Le nom vient de XLIFF, où <ph> tient la place de quelque chose qui, dans le document d’origine, n’a pas de texte propre. TMX a aussi un <ph>, mais il contient le code d’origine au lieu de rester vide. Vous rencontrerez surtout des éléments vides à l’intérieur des segments, où ils remplacent ce que le document d’origine avait à cet endroit et qui n’est pas du texte : un saut de ligne, une image, un champ automatique. En HTML HyperText Markup Language (HTML)langage HTML (HTML) markupbalisage The markup language of web pages: a vocabulary of elements laid down by a standard, marking headings, paragraphs, links, images and the rest, which a browser renders.Langage de balisage des pages web : un vocabulaire d'éléments fixé par une norme, qui marque les titres, les paragraphes, les liens, les images et le reste, et qu'un navigateur affiche. , <br> et <img> jouent le même rôle.

Hiérarchie

Les éléments s’imbriquent les uns dans les autres et forment un arbre : chaque élément peut contenir d’autres éléments, ses enfants.

<tu>
    <tuv xml:lang="en-CA">
        <seg>Install the pump on a level surface.</seg>
    </tuv>
    <tuv xml:lang="fr-CA">
        <seg>Installez la pompe sur une surface plane.</seg>
    </tuv>
</tu>

Une unité de traduction translation unit (TU)unité de traduction (UT) CAT toolsTAO A record that associates a source-language segment with its target-language equivalent, usually together with relevant metadata.Enregistrement qui associe un segment de la langue source à son équivalent dans la langue cible, généralement accompagné de métadonnées. (tu) contient ses variantes de langue (tuv, translation unit variant), et chaque variante son segment segmentsegment CAT toolsTAO A portion of translatable content that a CAT tool treats as a discrete unit for translation, alignment, storage and match retrieval.Portion de contenu à traduire qu'un outil de TAO traite comme une unité distincte aux fins de traduction, d'alignement, de stockage et de recherche de correspondances. (seg). C’est cette imbrication qui permet de représenter des structures riches dans un simple fichier texte, interprétable à la fois par les machines et par les humains. La figure 1, à la page précédente, dessine exactement cette imbrication.

Written alternately in EN and FR, translation partly generated in both directions. Rédigé en alternance en EN et en FR, traduction en partie générée dans les deux sens. Mise à jour 2026-08-30

Sources

Sources

Spotted an error? Une erreur ?

Language, content, a broken link: tell me what you saw and I will fix it. Langue, contenu, lien brisé : dites-moi ce que vous avez vu et je corrige.

Sending opens your mail app with the report addressed to me. L'envoi ouvre votre application de courriel avec le signalement déjà adressé à moi.