Completar el manifiesto del conector

En este ejemplo hemos empezado creando el conector y los archivos de documentos. Luego hemos creado los archivos toc que describen la organización del contenido. Ahora nos queda la tarea de juntarlo todo para formar una tabla de contenido (toc) maestra y actualizar nuestro archivo plugin.xml para que la toc maestra pase a ser una contribución real. 

Empezamos por crear un archivo toc.xml para añadir las tres toc que creamos al principio.  En lugar de proporcionar un atributo href para cada tema, utilizaremos el atributo link para hacer referencia a nuestros archivos toc existentes.

<toc label="Online Help Sample" topic="html/book.html">
	<topic label="Conceptos">
		<link toc="toc_Concepts.xml" />
	</topic>
	<topic label="Tareas">
		<link toc="toc_Tasks.xml" />
	</topic>
	<topic label="Consulta">
		<link toc="toc_Ref.xml" />
	</topic>
</toc>

Después actualizamos el archivo plugin.xml para contribuir con nuestra toc maestra:

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

Observe la utilización del atributo primary.  Cuando este atributo se establece en true, se está indicando que la toc siempre debe aparecer en la navegación, aunque ninguna otra toc haga referencia a ella. De esta forma, queda garantizado que nuestra toc "maestra" siempre figurará en la lista de temas.  Aparecerá en la lista de libros de nivel superior, ya que ninguna otra toc hará referencia a ella. 
Nota
: si existían más archivos asociados a esta toc que no estaban presentes en la navegación, sino sólo enlazados desde otros temas, para que esos temas estuvieran disponibles para el motor de búsqueda deberíamos utilizar el atributo extradir en la toc.

Por último, suministraremos nuestros archivos toc individuales.

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

Estos archivos toc no figurarán en la lista de libros de nivel superior porque no hemos establecido el atributo primary.  Los archivos toc que no se hayan designado como primarios sólo aparecerán en la documentación Web si se les hace referencia desde alguna toc que sea primaria o si están enlazados mediante una toc primaria.

Esto es todo. Si copia el directorio del conector en el directorio plugins de la plataforma, inicie la plataforma y elija Ayuda->Contenido de la ayuda, y verá el ejemplo en la lista de libros. Si pulsa en "Ejemplo de ayuda en línea", verá la estructura de la tabla de contenido:

Navegador de la ayuda en línea con la estructura de libros de ejemplo

Copyright IBM Corporation y otros 2000, 2003.