Udfyld plugin-manifest

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:

Onlinehjælpebrowser med eksempel på bogstruktur