Het pluginmanifest voltooien

We zijn dit voorbeeld begonnen met het maken van plugin- en documentbestanden. Vervolgens hebben we TOC-bestanden (inhoudsopgavebestanden) gemaakt om de structuur van de content te beschrijven. Hierna hoeft u alleen nog alle items samen te voegen tot een master-inhoudsopgave en het bestand plugin.xml zo bij te werken dat de master-inhoudsopgave daadwerkelijk wordt aangeleverd. 

Om te beginnen maken we een bestand toc.xml voor aanlevering van de drie TOC-bestanden die we eerder hebben gemaakt. In plaats van voor elk onderwerp een href aan te leveren, gebruiken we het kenmerk link om te verwijzen naar onze bestaande TOC-bestanden.

<toc label="Online Help Sample" topic="html/book.html">
	<topic label="Concepts">
		<link toc="toc_Concepts.xml" />
	</topic>
	<topic label="Tasks">
		<link toc="toc_Tasks.xml" />
	</topic>
	<topic label="Reference">
		<link toc="toc_Ref.xml" />
	</topic>
</toc>

Vervolgens werken we het bestand plugin.xml bij met ons master-inhoudsopgavebestand:

   <extension point="org.eclipse.help.toc">
      <toc file="toc.xml" primary="true" />
    </extension>

Let op het gebruik van het kenmerk primary. Door dit kenmerk in te stellen op true wordt deze inhoudsopgave altijd in de navigatiestructuur afgebeeld, ook al wordt er in geen enkele andere inhoudsopgave naar verwezen. Zo wordt uw "master"-inhoudsopgave gegarandeerd afgebeeld in de lijst met onderwerpen. Deze verschijnt boven in de lijst met boeken omdat hier in geen enkele andere inhoudsopgave naar wordt verwezen. 
Opmerking
: als er meer bestanden aan dit inhoudsopgavebestand zijn gekoppeld die niet in de navigatiestructuur aanwezig zijn, maar slechts hieraan gekoppeld zijn via andere onderwerpen, moet u het kenmerk extradir in het TOC-bestand gebruiken om die onderwerpen beschikbaar te maken in de zoekengine.

Ten slotte leveren we de afzonderlijke inhoudsopgavebestanden aan.

   <extension point="org.eclipse.help.toc">
       <toc file="toc_Concepts.xml" />
       <toc file="toc_Tasks.xml" />
       <toc file="toc_Reference.xml" />
    </extension>

Deze inhoudsopgavebestanden worden niet opgenomen in de toplevel lijst met boeken omdat het kenmerk primary niet is ingesteld. Inhoudsopgavebestanden die niet als primaire bestanden zijn aangewezen, worden alleen in de documentatiestructuur afgebeeld als ernaar wordt verwezen in een primair inhoudsopgavebestand of in een inhoudsopgavebestand dat wordt ingevoegd via een primair inhoudsopgavebestand.

Dat is alles. Als u uw plugindirectory kopieert naar de directory plugins van het platform, het platform start en Help > Inhoudsopgave Help kiest, wordt uw voorbeeld afgebeeld in de lijst met boeken. Als u op "Online Help Sample" klikt, ziet u uw inhoudsopgavestructuur:

Online Help-browser met voorbeeldboekenstructuur