Nous avons commencé cet exemple par la création de notre plug-in et des fichiers de document. Ensuite nous avons créé des fichiers de table des matières pour décrire l'organisation du contenu. Reste à rassembler le tout dans une table des matières principale et à mettre à jour le fichier plugin.xml pour réellement générer une table des matières.
Il faut d'abord créer un fichier toc.xml pour ajouter les trois tables des matières générées initialement. Au lieu d'indiquer un argument href pour chaque rubrique, vous pouvez utiliser l'attribut link afin de faire référence aux fichiers TDM existants.
<toc label="Exemple d'aide en ligne"> <topic label="Concepts"> <link toc="toc_Concepts.xml" /> </topic> <topic label="Tâches"> <link toc="toc_Tasks.xml" /> </topic> <topic label="Référence"> <link toc="toc_Ref.xml" /> </topic> </toc>
Il s'agit ensuite de mettre à jour le fichier plugin.xml pour générer la table des matières principale :
<extension point="org.eclipse.help.toc"> <toc file="toc.xml" primary="true" /> </extension>
Vous remarquez que l'attribut primary est employé. Si vous lui accordez la valeur true, la table des matières doit toujours apparaître dans la navigation, même si aucune autre table n'y fait référence. De cette façon, l'affichage de la table des matières "principale" est garanti dans la liste des rubriques. Elle apparaît dans la liste de niveau supérieur vu qu'aucune autre table n'y fait référence.
Vous ajoutez enfin les fichiers TDM individuels.
<extension point="org.eclipse.help.toc"> <toc file="toc_Concepts.xml" /> <toc file="toc_Tasks.xml" /> <toc file="toc_Reference.xml" /> </extension>
Ces fichiers n'apparaissent pas dans la liste de niveau supérieur des ouvrages car l'attribut primary n'a pas été défini. Les fichiers TDM non désignés comme primaires apparaîtront uniquement dans la documentation en ligne si une autre table principale ou liée à une table principale y fait référence.
C'est terminé. Si vous copiez votre répertoire de plug-in dans le répertoire plugins de la plateforme, démarrez cette dernière et choisissez Aide ->Contenu de l'aide, vous devez voir l'exemple suivant apparaître dans la liste d'ouvrages :
Si vous cliquez sur "Exemple d'aide en ligne", vous verrez la structure de votre table des matières.