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 contribuir con las tres toc que creamos al principio. En vez de proporcionar un atributo href para cada tema, utilizaremos el atributo link para hacer referencia a nuestros archivos toc existentes.

<toc label="Ejemplo de ayuda en línea">
	<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>

Fíjese en el uso 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, porque no ninguna otra toc hará referencia a ella.  

Por último, contribuiremos suministrando 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 solo 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:

Lista de libros con la entrada del ejemplo

 

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 Corp. y otros 2000, 2002.