Slutföra manifestet för insticksprogrammet

Vi började det här exemplet med att skapa insticksprogrammet och dokumentfiler. Därefter skapade vi toc-filer för att beskriva hur innehållet är organiserat. Det arbete som återstår är att sammanställa allt i en huvudinnehållsförteckning och uppdatera plugin.xml så att den visar huvudinnehållsförteckningen. 

Vi börjar med att skapa filen toc.xml som visar de tre innehållsförteckningar vi skapade till att börja med.  Istället för att ha en href för varje avsnitt använder vi attributet link till att referera till de befintliga toc-filerna.

<toc label="Exempel på onlinehjälp" topic="html/book.html">
	<topic label="Koncept">
		<link toc="toc_Concepts.xml" />
	</topic>
	<topic label="Åtgärder">
		<link toc="toc_Tasks.xml" />
	</topic>
	<topic label="Referens">
		<link toc="toc_Ref.xml" />
	</topic>
</toc>

Sedan uppdaterar vi plugin.xml så att den visar huvudinnehållsförteckningen:

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

Lägg märke till hur attributet primary används.  Om attributet ges värdet sant innebär det att innehållsförteckningen alltid ska visas i navigering, även om inga andra innehållsförteckningar refererar till den.  På det sättet är det säkert att "huvud"innehållsförteckningen alltd visas i listan över avsnitt.  Den visas i den översta listan över böcker eftersom inga andra innehållsförteckningar refererar till den. 
Obs!
Om fler filer har associerats till innehållsförteckningen men inte är med i navigeringen, utan enbart är länkade från andra avsnitt, så måste attributet extradir användas i innehållsförteckningen för att göra de avsnitten tillgängliga för sökmotorn.

Slutligen lägger vi in våra enskilda toc-filer.

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

De toc-filerna kommer inte att visas i den översta listan över böcker eftersom vi inte har angett attributet primary.  Toc-filer som inte har markerats som primära kommer endast att visas i dokumentationswebben om någon annan innehållsförteckning som är primär refererar till dem, eller om det finns en länk till dem från en primär innehållsförteckning.

Det var allt. Om du kopierar insticksprogrammets katalog till plattformens katalog för insticksprogram, startar plattformen och väljer Hjälp->Hjälpavsnitt, så bör ditt exempel visas i listan över böcker. Om du klickar på "Exempel på onlinehjälp", så visas innehållsförteckningens struktur:

Läsare för onlinehjälp med exempel på bokstruktur