Ahora que tenemos nuestros archivos de contenido de ejemplo, podemos crear un archivo de tabla de contenido (toc). El archivo toc define los puntos de entrada clave situados en los archivos de contenido HTML, y para ello correlaciona la etiqueta de un tema con una referencia de uno de los archivos HTML.
Las aplicaciones que se estén migrando a la plataforma pueden reutilizar la documentación existente empleando el archivo toc para definir puntos de entrada en la documentación.
Un conector puede tener uno o más archivos toc. Nuestra documentación de ejemplo está organizada en tres categorías principales: conceptos, tareas y consulta. ¿Cómo haremos que los archivos toc representen esta estructura?
Podríamos crear un solo archivo toc de gran tamaño o bien crear un archivo toc aparte para cada categoría de contenido principal. Esta decisión debe tomarse en función de cómo colaboren los equipos de documentación. Si cada categoría es propiedad de un autor distinto, sería preferible mantener aparte los archivos toc de cada categoría. Esto no viene impuesto por la arquitectura de la plataforma.
En este ejemplo, crearemos un archivo toc por cada categoría principal de contenido. Cuando hay un número pequeño de archivos, puede no ser necesario tener un archivo toc aparte para cada categoría. Construiremos este ejemplo como si tuviéramos muchos archivos o como si cada categoría de contenido fuese propiedad de autores distintos.
Los archivos tienen este aspecto:
<toc label="Conceptos"> <topic label="Concept1" href="doc/concepts/concept1.html"> <topic label="Concept1_1" href="doc/concepts/concept1_1.html"/> <topic label="Concept1_2" href="doc/concepts/concept1_2.html"/> </topic> </toc>
<toc label="Tareas"> <topic id="plainTasks" label="Materias básicas"> <topic label="Task1" href="doc/tasks/task1.html"/> <topic label="Task2" href="doc/tasks/task2.html"/> </topic> <topic id="funTasks" label="Materias divertidas" > <topic label="Task3_1" href="doc/tasks/task3_1.html"/> <topic label="Task3_2" href="doc/tasks/task3_2.html"/> </topic> </toc>
<toc label="Consulta"> <topic label="Ref1" href="doc/ref/ref1.html"/> <topic label="Ref2" href="doc/ref/ref2.html"/> </toc>
Un tema puede ser un simple enlace con el contenido. Por ejemplo, "Task1" proporciona un atributo label y un atributo href que enlaza con el contenido. Un tema también puede ser un agrupamiento jerárquico de subtemas que no tenga ningún contenido propio. Por ejemplo, el tema "Materias divertidas" solo tiene un atributo label y subtemas, pero no tiene ningún atributo href. Los temas también pueden hacer las dos cosas. El tema "Concept1" tiene un atributo href y subtemas.