L'attribut chunk (segment)

L'attribut chunk permet de contrôler le mode de génération des fichiers de sortie au cours du processus de publication. La plupart des valeurs de l'attribut s'appliquent exclusivement à des rubriques d'assemblage. Ce n'est pas la bonne méthode. La valeur to-content est utilisée pour générer une rubrique publiée unique à partir de rubriques source DITA multiples.

L'élément topicref de la carte DITA contient un attribut chunk qui peut être utilisé pour regrouper les rubriques source DITA lors de la création du document livrable.

L'attribut chunk remplace efficacement le traitement par défaut de l'outil de publication. L'attribut chunk est utilisé pour regrouper des rubriques DITA en une seule rubrique lors de la publication, mais également pour préciser qu'une rubrique DITA doit être divisée en plusieurs rubriques.

L'attribut chunk est également disponible dans l'élément map. Les valeurs définies s'appliquent à l'ensemble des rubriques de la carte DITA.

L'attribut chunk s'applique exclusivement au nœud parent d'un élément topicref ou d'un élément map et sa valeur s'applique au nœud parent et à ses enfants.

L'attribut chunk possède jusqu'à trois parties ou jetons séparés par une espace. Par exemple, un attribut codé ainsi : chunk="select-topic to-content" possède deux jetons : select-topic et to-content.

Il existe trois catégories de jeton :

Jeton de sélection :: Les jetons de sélection sont utilisés exclusivement pour identifier des rubriques imbriquées au sein d'une rubrique ditabase d'assemblage, de sorte que la stratégie de segmentation peut s'appliquer à une rubrique individuelle imbriquée (select-topic), à une famille de rubriques imbriquées (select-branch) ou à l'intégralité de la rubrique d'assemblage(select-document).
Jeton de stratégie: Les jetons de stratégie indiquent si les rubriques référencées doivent être divisées (by-topic) ou fusionnées (by-document).
Jeton de formatage: Les jetons de formatage indiquent si les rubriques référencées doivent être générées en tant que rubrique unique (to-content) ou si elles doivent l'être en tant que rubriques séparées, mais avec une entrée unique dans la table des matières (to-navigation).

Par exemple, une partie de carte DITA présentant la structure suivante :

<topicref href="c_safety.dita" chunk="to-content"> 
  <topicref href="c_electronic_brake_force_distribution.dita"  /> 
  <topicref href="t_child_restraint.dita" /> 
  <topicref href="c_other_restraint_systems.dita" />
</topicref>

sera publiée comme une rubrique HTML unique et le fichier portera le nom suivant : c_safety.html.

Remarque : À l'exception des jetons de formatage, la plupart des attributs chunk valides ne s'appliquent qu'au traitement des rubriques d'assemblage (ditabase). Dans la mesure du possible, il faut éviter d'utiliser des rubriques d'assemblage et préférer le recours aux cartes DITA.