Exemple

DITA (Darwin Information Typing Architecture) est un langage XML utilisé dans la rédaction de documents techniques. Soit la procédure DITA suivante (respirationCirculaire.xml) :

1
<?xml version="1.0" encoding="UTF-8"?>
2
<!DOCTYPE task PUBLIC "-//OASIS//DTD DITA Task//EN" "http://docs.oasis-open.org/dita/v1.1/OS/dtd/task.dtd">
3
<task>
4
    <title>La respiration circulaire</title>
5
<taskbody>
6
<steps>
7
	<step>
8
		<cmd>Commencez à souffler dans votre instrument.</cmd>
9
	</step>
10
	<step>
11
		<cmd>Quand vous arrivez à bout de souffle, gonflez légèrement les joues tout en continuant à souffler, afin de constituer une réserve d'air.</cmd>
12
	</step>
13
	<step>
14
		<cmd>En inspirant brièvement par le nez, expulsez l'air en vidant les joues.</cmd>
15
	</step>
16
	<step>
17
		<cmd>Une fois les poumons à nouveau remplis, reprenez une expiration normale.</cmd>
18
	</step>
19
</steps>
20
</taskbody>
21
</task>

Un schéma XML, défini par exemple dans le langage DTD, permet de contrôler la structuration d'un document XML. Soit la DTD suivante (task.dtd, simplifiée par rapport à DITA) :

1
<!ELEMENT task (title, taskbody)>
2
<!ELEMENT title (#PCDATA)>
3
<!ELEMENT taskbody (context, steps, result?)>
4
<!ELEMENT context (#PCDATA)>
5
<!ELEMENT steps (step+)>
6
<!ELEMENT step (cmd, substeps*)>
7
<!ELEMENT cmd (#PCDATA | keyword)*>
8
<!ELEMENT keyword (#PCDATA)>
9
<!ELEMENT substeps (steps*)>
10
<!ELEMENT result (#PCDATA)>

La procédure précédente est valide par rapport à ce schéma. Notons que l'élément racine (task) n'est pas précisé dans la DTD mais au niveau de la déclaration du type de document (DOCTYPE) dans le fichier XML.

Les templates XSL suivants permettent de transformer la procédure au format HTML :

1
<xsl:template match="task">
2
	<h1><xsl:value-of select="title/text()"/></h1>
3
	<xsl:apply-templates select="taskbody"/>
4
</xsl:template>
5
6
<xsl:template match="taskbody">
7
	<xsl:apply-templates select="context"/>
8
	<ol>
9
		<xsl:for-each select="steps/step">
10
			<xsl:apply-templates select="."/>
11
		</xsl:for-each>
12
	</ol>
13
	<xsl:apply-templates select="result"/>
14
</xsl:template>
15
16
<xsl:template match="step">
17
	<li>
18
		<xsl:apply-templates select="cmd"/>
19
		<xsl:if test="substeps">
20
			<ol>
21
				<xsl:for-each select="substeps/step">
22
					<xsl:apply-templates select="."/>
23
				</xsl:for-each>
24
			</ol>
25
		</xsl:if>
26
	</li>
27
</xsl:template>
respirationCirculaire.html
DITA permet également de répertorier les procédures dans une map (techniquesEtendues.map) :
1
<?xml version="1.0" encoding="UTF-8"?>
2
<!DOCTYPE map PUBLIC "-//OASIS//DTD DITA Map//EN" "http://docs.oasis-open.org/dita/dtd/map.dtd">
3
<map>
4
    <title>Les techniques de jeu étendues</title>
5
    <topicref href="pianoPrepare.xml"/>
6
    <topicref href="slapTongue.xml"/>
7
    <topicref href="respirationCirculaire.xml"/>
8
</map>
Par ailleurs, la procédure peut être référencée dans une autre map (techniquesImpro.map) :
1
<?xml version="1.0" encoding="UTF-8"?>
2
<!DOCTYPE map PUBLIC "-//OASIS//DTD DITA Map//EN" "http://docs.oasis-open.org/dita/dtd/map.dtd">
3
<map>
4
    <title>Les techniques d'improvisation</title>
5
    <topicref href="respirationCirculaire.xml"/>    
6
    <topicref href="musiqueModale.xml"/>
7
    <topicref href="gammeParTons.xml"/>
8
</map>
À l'aide de deux transformations XSL différentes, ces maps pourraient être publiées au format HTML d'une part, sous la forme d'une liste de liens vers chacune des procédures ; et au format PDF d'autre part, dans une publication où toutes les procédures sont les unes à la suite des autres :
techniquesEtendues.html
techniquesImpro.pdf