Utilisez l’élément <table> lorsque vous avez besoin de créer un tableau plus grand ou plus complexe que celui que vous pouvez créer avec l’élément <simpletable>. Si vous avez besoin d’un titre ou d’une légende pour votre tableau, ou de plus d’une ligne d’en-tête, utilisez l’élément <table>.
Les éléments contenus dans l’élément <table> comprennent :
<title>
Élément contenant le texte du titre ou de la légende d’un élément <table>. Un élément <table> ne peut contenir qu’un seul élément <title>.
<tgroup>
Élément contenant le contenu principal d’un élément <table>. L’élément <tgroup> contient les éléments <colspec>, <thead> et <tbody>. Un élément <table> peut contenir un ou plusieurs éléments <tgroup>.
<colspec>
Élément fournissant des informations sur les colonnes d’un élément <table>. Les spécifications des colonnes sont définies à l’aide des attributs colname (le nom de la colonne), colnum (l’ordre dans lequel la colonne apparaît) et colwidth (la largeur relative de la colonne).
<thead>
Élément contenant l’en-tête dans un élément <table>. L’élément <thead> peut contenir un ou plusieurs éléments <row> et est facultatif.
<tbody>
Élément contenant les rangées du corps dans un élément <table>. L’élément <tbody> peut contenir un ou plusieurs éléments <row>.
<row>
Élément contenant une rangée de cellules dans un élément <table>. L’élément <row> contient un ou plusieurs éléments <entry>.
<entry>
Élément contenant une seule cellule dans un élément <table>. L’élément <entry> contient le texte d’une cellule dans l’élément <table>, qui doit être encadré par un élément <p> selon les meilleures pratiques.
Cette leçon couvrira les bases de l’utilisation de l’élément <table>. Pour mettre en évidence les différences entre les éléments <table> et <simpletable>, vous utiliserez le même exemple de contenu pour votre exercice <table> que celui utilisé pour votre exercice <simpletable>.
Figure 2. Exemple d’une <table> dans un format visuel
Continuez d’utiliser le fichier leçon2/l_concept_images_tableaux_debut.dita pour ajouter l’élément <table>.
Remarque :
Si vous utilisez un éditeur DITA, certains éléments enfants de l’élément <table> seront automatiquement insérés au fur et à mesure que vous travaillerez sur les exemples.
Cette vidéo montre une autre façon de créer un tableau avec DITA en utilisant l’assistant de tableau oXygen XML Editor. Les exercices vous montrent comment créer un tableau en utilisant le code DITA.
Pratique
Après l’élément <simpletable>, ajoutez un élément <table> tel que présenté dans l’élément suivant :
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE concept PUBLIC "-//OASIS//DTD DITA Concept//EN" "concept.dtd">
<concept id="concept_images_tables">
<title>Croissance et développement du caneton</title>
<conbody>
...
</simpletable>
<table>
</table>
</conbody>
</concept>
À l’intérieur de l’élément <table>, ajoutez un élément <title> et ajoutez-y du contenu tel que présenté dans l’exemple suivant :
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE concept PUBLIC "-//OASIS//DTD DITA Concept//EN" "concept.dtd">
<concept id="concept_images_tables">
<title>Croissance et développement du caneton</title>
<conbody>
...
<table>
<title>Développement typique du canard colvert</title>
</table>
</conbody>
</concept>
L’élément <title> est optionnel, mais il vous permet d’ajouter du contexte à votre tableau, tout comme il le fait pour les images lorsqu’il est utilisé dans l’élément <fig>.
Après l’élément <title>, ajoutez l’élément <tgroup> tel que présenté dans l’exemple suivant :
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE concept PUBLIC "-//OASIS//DTD DITA Concept//EN" "concept.dtd">
<concept id="concept_images_tables">
<title>Croissance et développement du caneton</title>
<conbody>
...
<title>Développement typique du canard colvert</title>
<tgroup cols="2">
</tgroup>
...
</conbody>
</concept>
L’élément <tgroup> contient le corps de la table. Le nombre de colonnes de la table est défini à l’intérieur de l’élément <tgroup> à l’aide de l’attribut cols. Dans l’exemple que vous avez ajouté, cols= »2″ montre que cette table contiendra deux colonnes.
Un seul élément <table> peut contenir plus d’un élément <tgroup>, ce qui est utile si vous avez besoin de montrer plus d’un tableau avec des en-têtes ou un nombre de colonnes différents sous le même titre.
À l’intérieur de l’élément <tgroup>, ajoutez deux éléments <colspec> et ajoutez-y du contenu tel que présenté dans l’exemple suivant :
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE concept PUBLIC "-//OASIS//DTD DITA Concept//EN" "concept.dtd">
<concept id="concept_images_tables">
<title>Croissance et développement du caneton</title>
<conbody>
...
<tgroup cols="2">
<colspec colname="c1" colnum="1" colwidth="1.0*"/>
<colspec colname="c2" colnum="2" colwidth="1.0*"/>
...
</conbody>
</concept>
L’élément <colspec> permet de configurer les colonnes de votre tableau et de spécifier les informations les concernant (comme leur nom, leur séquence et leur largeur) à l’aide d’attributs. Dans l’exemple que vous avez ajouté, l’attribut colname a été utilisé pour nommer vos colonnes « c1 » et « c2 » et l’attribut colnum a été utilisé pour désigner l’ordre dans lequel ces colonnes apparaissent.
L’attribut facultatif colwidth peut être utilisé pour contrôler les proportions des largeurs de colonnes. Dans l’exemple que vous avez ajouté, l’attribut colwidth est le même pour chaque colonne, ce qui signifie qu’elles s’afficheront avec la même largeur.
Après le dernier élément <colspec>, ajoutez l’élément <thead> tel que présenté dans l’exemple suivant :
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE concept PUBLIC "-//OASIS//DTD DITA Concept//EN" "concept.dtd">
<concept id="concept_images_tables">
<title>Croissance et développement du caneton</title>
<conbody>
...
<colspec colname="c2" colnum="2" colwidth="1.0*"/>
<thead>
</thead>
...
</conbody>
</concept>
L’élément <thead> contient les éléments associés à l’en-tête du tableau. Contrairement à l’élément <sthead> dans un élément <simpletable>, l’élément <thead> dans un élément <table> peut contenir plus d’une ligne d’en-tête.
À l’intérieur de l’élément <thead>, ajoutez l’élément <row> tel que présenté dans l’exemple suivant :
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE concept PUBLIC "-//OASIS//DTD DITA Concept//EN" "concept.dtd">
<concept id="concept_images_tables">
<title>Croissance et développement du caneton</title>
<conbody>
...
<thead>
<row>
</row>
...
</concept>
L’élément <row> contient les éléments associés à une ligne de tableau.
À l’intérieur de l’élément <row>, ajoutez deux éléments <entry> et ajoutez-y du contenu tel que présenté dans l’exemple suivant :
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE concept PUBLIC "-//OASIS//DTD DITA Concept//EN" "concept.dtd">
<concept id="concept_images_tables">
<title>Croissance et développement du caneton</title>
<conbody>
...
<row>
<entry><p>Âge</p></entry>
<entry><p>Étape importante</p></entry>
...
</concept>
Chaque élément de la rubrique <entry> correspond à une seule cellule d’une ligne du tableau. Dans l’exemple que vous avez ajouté, chaque élément <entry> suit la meilleure pratique consistant à encadrer le texte par un élément <p>.
Après l’élément <thead>, ajoutez l’élément <tbody> tel que présenté dans l’exemple suivant :
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE concept PUBLIC "-//OASIS//DTD DITA Concept//EN" "concept.dtd">
<concept id="concept_images_tables">
<title>Croissance et développement du caneton</title>
<conbody>
...
</thead>
<tbody>
</tbody>
...
</conbody>
</concept>
L’élément <tbody> est pour le corps principal de la table. Suivant la même structure que l’élément <thead>, l’élément <tbody> peut contenir des éléments de type <row> avec des éléments de type <entry> à l’intérieur de ceux-ci.
À l’intérieur de l’élément <tbody>, ajoutez un élément <row> et ajoutez-y du contenu avec des éléments <entry> et leur texte tel que présenté dans l’exemple suivant :
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE concept PUBLIC "-//OASIS//DTD DITA Concept//EN" "concept.dtd">
<concept id="concept_images_tables">
<title>Croissance et développement du caneton</title>
<conbody>
...
<tbody>
<row>
<entry><p>7 semaines</p></entry>
<entry><p>Première tentative de vol</p></entry>
</row>
...
</concept>
Après l’élément <row> que vous venez d’ajouter, ajoutez deux autres rangées et ajoutez-y du contenu tel que présenté dans l’exemple suivant :
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE concept PUBLIC "-//OASIS//DTD DITA Concept//EN" "concept.dtd">
<concept id="concept_images_tables">
<title>Croissance et développement du caneton</title>
<conbody>
...
</row>
<row>
<entry><p>12 à 14 semaines</p></entry>
<entry><p>Atteinte du poids adulte</p></entry>
</row>
<row>
<entry><p>1 an</p></entry>
<entry><p>Capable de reproduction</p></entry>
</row>
...
</concept>
L’élément <tbody> peut contenir un ou plusieurs éléments <row>.
Comparez votre fichier leçon2/l_concept_images_tableaux_debut.dita avec le fichier d’exemple leçon2/l_concept_images_tableaux.dita.
Pratique
Ouvrez le fichier leçon2/l_concept_images_tableaux_exercice_debut.dita et utilisez-le pour convertir en DITA le contenu suivant :
Utilisez l’image d’exemple leçon2/images/configuremieux1.png pour cet exercice.
Soutenir le marketing avec un contenu technique
La communication technique et la communication marketing ont longtemps occupé les extrémités opposées du spectre des contenus. Le stéréotype est que la communication technique est lourde en texte, dense et mal formatée alors que la communication marketing est brillante, belle et sans contenu. À partir de là, le débat ne fait que s’intensifier : Communication marketing contre communication technique : les stéréotypes
Communication marketing
Communication technique
Conception ou automatisation ?
Conception
Automatisation
Quel degré de détail ?
Aussi peu que possible
Autant que possible
Impact présumé sur les recettes
Beaucoup
Aucun
Objectif principal
Persuader les gens d’acheter
Informer les gens
Donnez aux gens une interface conviviale qui leur permet de réduire rapidement leurs options et de choisir celle qu’ils veulent. Il n’est pas nécessaire d’exposer tous les champs de la base de données, mais seulement ceux qui aident les gens à restreindre leurs choix.
La liste de produits sur la droite se met à jour au fur et à mesure que vous faites des sélections sur la gauche
Comparez votre fichier leçon2/l_concept_images_tableaux_exercice_debut.dita avec l’exemple de fichier leçon2/l_concept_images_tableaux_exercice.dita.