A bedolgozó-leírófájl létrehozása

A példát a bedolgozó és dokumentumfájlok létrehozásával kezdtük. Következőnek toc fájlokat hoztunk létre a tartalom elrendezésének leírásához. A feladat hátralevő része, hogy mindent egy elsődleges toc fájlba vonjunk összes és frissítsük a plugin.xml fájlt, hogy valójában biztosítsa az elsődleges toc fájlt. 

Egy toc.xml fájl létrehozásával kezdjük a kezdetben létrehozott három toc biztosítását. Ahelyett, hogy minden témakörhöz biztosítanánk egy href-et, a link attribútumot használjuk a meglévő toc fájlokra hivatkozáshoz.

<toc label="Online Help Sample" topic="html/book.html">
	<topic label="Concepts">
		<link toc="toc_Concepts.xml" />
	</topic>
	<topic label="Feladatok">
		<link toc="toc_Tasks.xml" />
	</topic>
	<topic label="Hivatkozás">
		<link toc="toc_Ref.xml" />
	</topic>
</toc>

Ezután a plugin.xml fájl kerül frissítésre, hogy biztosítsa az elsődleges toc fájlt:

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

Ne feledje el használni az primary attribútumot. Ha az attribútum értéke true, akkor a toc fájlnak mindig meg kell jelennie a navigációban akkor is, ha nem hivatkozik rá másik toc.  Ebben az esetben az "elsődleges" toc garantáltan megjelenik a témakörök lista tetején. A felső szintű könyvek között jelenik meg, mivel nem hivatkozik rá toc. 
Megjegyzés
: Ha több fájl lett hozzárendelve ehhez a toc fájlhoz, de nem található meg a navigációban, hanem csak másik témakör hivatkozik rá, akkor ahhoz, hogy ezek a témakörök rendelkezésre álljanak a keresőmotor számára, az extradir attribútumot kell használni a toc fájlban.

Végül közreadjuk ez egyéni toc fájlokat.

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

Ezek a toc fájlok nem jelennek meg a felső szintű könyvek között, mivel nem állítottuk be az primary attribútumot. A nem elsődlegesként megjelölt toc fájlok csak akkor jelennek meg a dokumentációs weben, ha egy elsődleges toc hivatkozik rájuk, vagy csatolva van egy elsődleges toc fájlhoz.

Ennyi. Ha átmásolja a bedolgozókönyvtárat a platform plugins könyvtárába, elindítja a platformot és kiválasztja a Súgó->Súgótartalom lehetőséget, akkor a példának meg kell jelennie a könyvek listájában. Ha rákattint az "Online súgópélda" lehetőségre, akkor megjelenik a toc struktúra:

Online súgóböngésző példaszerkezettel