Exposé : création de map

Notion de Maps DITA

D’un point de vue conceptuel
- Une mise en relation et un ordonnancement de topics
- Une structure d’usage où l’on s’intéresse à la cohérence de topics entre eux
De fait :
- La structure de topics nécessaire à la réalisation de publications
- Des structures de production pour des groupes d’information homogène (Ex. « getting started »)
En pratique :
- Un document qui contient des références vers des topics
- Les références peuvent être organisées de manière à définir les relations entre topics
  - Définition d’une structure hiérarchique
    - Des topics peuvent ne contenir que des titres (« prêts à être maintenus »)
  - Définition de tables d’association
- En tant que structure d’usage, la <map > définit :
  - Le contexte dans lequel les topics vont être lus : audience, plate-forme, relations
  - La cohérence des titres et autres Métadonnées
    - Possibilité de surcharge de l’information contenue dans un topic

Les Maps comme outil de production de publication

Les maps pointent vers les topics à inclure dans la publication
- Possibilité de définir des sous-maps réutilisables dans d’autres maps
Les maps pointent vers du contenu DITA
- Egalement du contenu non-DITA
  - Traitement du « Legacy Data »
  - Nécessité de personnaliser le processus de production pour le contenu non-DITA
La même map résoud différents objectifs :
- Générer de l’information de navigation
- Ajouter des liens
- Assembler pour publier comme un tout

Maps et organisation de contenus

La navigation n’est pas définie par le processus de rédaction
Avec une map, il devient possible :
- D’inclure des topics à plusieurs endroits (tâche répétitive dans une séquence de tâches, par exemple)
- D’utiliser (réutiliser) un même jeu de topics, avec des maps différentes, pour des besoins liés à :
  - Organisation de l’information orientée fonctionnalités vs tâches
  - Différenciation selon publics spécifiques
  - Gestion publication imprimée versus publication en ligne
- Construire une navigation qui fait appel à des topics extérieurs ou dans d’autres formats

Maps et liens

La map ne touche pas aux contenus, mais intervient sur la relation entre eux
La map décrit différents types de relations
- Relations hiérarchiques, du type parent/enfant,
- Relations de séquencement et regroupement de contenus
- Relation par table d’association
Les mises en relation sont :
- Directes (URI)
- Indirectes (basées sur des tables de clés/valeurs)

Exemples Map

<map xml:lang=" fr ">
    <title>Mon livre de cuisine</title>
    <topicref href=" introduction.dita "/>
    <topicref href=" recettes.dita ">
        <topichead>
            <topicmeta>
                <navtitle>Entrées - tartinables </navtitle>
            </topicmeta>
            <topicref href=" tartinablebutternut.dita "/>
        </topichead>
        <topichead>
            <topicmeta>
                <navtitle>Plats</navtitle>
            </topicmeta>
            <topicref keyref=" couscousvert "/>
            <topicref href=" quicheendives.dita "/>
            <topicref href=" viandeVolailleNoire.dita "/>
        </topichead>
    </topicref>
</map>

Outils pour structurer une DITA map

Dans l’architecture DITA
- La map dérive du topic de base
- La map est spécialisable
  - Voir DITA 4 Publishing et la notion de book
Contient :
- Titre et Métadonnées
- <topicref > : référence de topic ou de map
  - Références spécialisées :
    - <mapref >, <topicsetref <topichead ><topicgroup > (pour réutilisation)
- Hiérarchisation des références
- Tableaux de relations entre topics

Références de topics

Références avec attributs :
- @href ou @keyref = localisation
- @processing-role = que faire de ce qui est référencé
Eléments de caractérisation :
- Verbalisation : @navtitle, @searchtitle, @linktext, @shortdesc
- Nature : @format, @type
Métadonnées : attributs et éléments
Réutilisation : @id et @conref
Relations : supplément de structure, avec attribut collection-type pour grouper les topics

Exemples de références de topics

Topicref local :
- <topicref href ="concept.dita"/>
- <topicref keyref ="concept"/>
Topicref externe :
- <topicref href ="http://xml.coverpages.org/dita.html" scope ="external"> <shortdesc>DITA at The XML Cover Pages</ shortdesc> </topicref>
Topicref local non-DITA :
- <topicref href ="readme.html" format =" tml"> <linktext> Readme </linktext> <shortdesc >The readme file</ shortdesc> </ topicref>

Hiérarchies de topics

Imbriquer les références de topics pour créer des hiérarchies
Créer une navigation hiérarchisée, parties/chapitres/sections dans les livres, liens parents/enfants
Utiliser <navref>, <anchor> et l’attribut anchorref pour agréger le contenu à la publication (publication Eclipse)
Utiliser <topichead> pour les rubriques de navigation ou les titres sans contenu d’accompagnement
Les hiérarchies permettent de définir la navigation, les séquences d’impression, ainsi que les relations

Cas d’utilisation des maps

Publication de topics (<topicref>)
Réutilisation de topics déjà organisés (<mapref>)
Mise en relation de topics sans modifier les contenus
Modification des contenus réutilisés
« late binding » via des clés d’association
- Permet de changer les clés en fonction du contexte
Définition de configuration de publication
- Filtrage et signalement