Lisäosan ilmoituksen tekeminen valmiiksi

Tämä esimerkki aloitettiin luomalla omat lisäosa- ja asiakirjatiedostot. Seuraavaksi luotiin sisällysluettelotiedostot, jotka kuvaavat sisällön rakennetta. Jäljellä on enää kaiken kokoaminen pääsisällysluetteloon ja plugin.xml-tiedoston päivitys, jotta pääsisällysluettelo tulee käyttöön. 

Ensin luodaan toc.xml-tiedosto, joka lisää aluksi luodut kolme sisällysluetteloa. Sen sijasta, että kullekin aiheelle olisi href-määrite, viittaamme aiempiin sisällysluettelotiedostoihin link-määritteellä.

<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>

Sen jälkeen päivitetään plugin.xml-tiedosto, jotta pääsisällysluettelo saadaan käyttöön:

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

Huomaa primary-määritteen käyttö. Jos tämän määritteen arvoksi määritetään "true", sisällysluettelon pitäisi aina näkyä siirtymisnäkymässä, vaikka mikään muu sisällysluettelo ei viittaisi siihen. Tällä tavoin "pääsisällysluettelo" on aina näkyvissä aiheluettelossa. Se näkyy kirjojen ylätasolla, koska mikään muu sisällysluettelo ei viittaa siihen. 
Huomautus
: Jos tähän sisällysluetteloon on liitetty useampia tiedostoja, mutta ne eivät ole siirtymisnäkymässä, vaan linkitettyinä muista aiheista, näiden aiheiden saatavuus hakutoiminnossa edellyttää extradir-määritteen käyttöä sisällysluettelossa.

Lopuksi lisätään yksittäiset sisällysluettelotiedostot.

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

Nämä sisällysluettelotiedostot eivät näy kirjojen ylätason luettelossa, koska primary-määritettä ei ole määritetty. Ne sisällysluettelotiedostot, joita ei ole määritetty ensisijaisiksi, näkyvät dokumentaatiossa vain, jos niihin viittaa jokin sisällysluettelotiedosto, joka on ensisijainen tai johon on linkki ensisijaisesta sisällysluettelosta.

Siinä kaikki. Jos kopioit lisäosahakemiston ympäristön lisäosahakemistoon, aloita ympäristö ja valitse Ohje->Ohjehakemisto. Esimerkin pitäisi tulla näkyviin kirjaluettelossa. Jos valitset vaihtoehdon "Online Help Sample", seuraava sisällysluettelorakenne tulee näkyviin:

Käytönaikainen ohjeselain, jossa on kirjarakenteen malli