I dette eksempel startede vi med at oprette plugin- og dokumentfiler. Derefter oprettede vi indholdsfortegnelsesfiler, som beskriver organiseringen af indholdet. Det hele skal nu samles i en masterindholdsfortegnelse, og plugin.xml skal opdateres, så det faktisk leverer masterindholdsfortegnelsen.
Det starter med, at der skal oprettes en toc.xml, som skal levere de tre indholdsfortegnelser, vi startede med at oprette. I stedet for at stille en href til rådighed for hvert emne, skal du bruge attributten link til at referere til de eksisterende indholdsfortegnelsesfiler (toc).
<toc label="Eksempel på onlinehjælp" topic="html/book.html"> <topic label="Begreber"> <link toc="toc_Concepts.xml" /> </topic> <topic label="Opgaver"> <link toc="toc_Tasks.xml" /> </topic> <topic label="Reference"> <link toc="toc_Ref.xml" /> </topic> </toc>
Derefter skal plugin.xml opdateres, masterindholdsfortegnelsesfilen leveres:
<extension point="org.eclipse.help.toc"> <toc file="toc.xml" primary="true" /> </extension>
Bemærk brugen af attributten primary. Hvis denne attribut angives til true, skal indholdsfortegnelsen altid vises i navigationen, også selvom den ikke refereres til af nogen anden indholdsfortegnelse. På denne måde sikres det, at denne "master"-indholdsfortegnelse altid vises i emnelisten. Den vises på øverste boglisteniveau, da ingen andre indholdsfortegnelser refererer til den.
Bemærk:
Hvis der er flere filer knyttet til denne indholdsfortegnelse, men de er ikke til stede i navigationen, men blot linket fra andre emner, skal attributten extradir bruges i indholdsfortegnelsen for at gøre emnerne tilgængelige for søgeprogrammet.
Til sidst skal de enkelte indholdsfortegnelsesfiler leveres.
<extension point="org.eclipse.help.toc"> <toc file="toc_Concepts.xml" /> <toc file="toc_Tasks.xml" /> <toc file="toc_Reference.xml" /> </extension>
Disse indholdsfortegnelsesfiler vises ikke i boglisten over øverste niveau, fordi attributten primary ikke er angivet. De indholdsfortegnelsesfiler, der ikke er defineret som primære, vises kun i dokumentationswebben, hvis de refereres til fra en anden indholdsfortegnelse, som er en primær indholdsfortegnelse, eller som er linket ind via en primær indholdsfortegnelse.
Hvis du kopierer plugin-biblioteket til platformens plugins-bibliotek, starter platformen og vælger Hjælp->Hjælp - indhold, vises eksemplet i listen over bøger. Hvis du klikker på "Eksempel på onlinehjælp", vises indholdsfortegnelsens struktur: