Introducción a las referencias de contenido DITA
La referencia de contenido DITA (conref) permite incluir el contenido de un elemento de un documento DITA en otro documento DITA. Cuando se incluye contenido de otro documento mediante una referencia de contenido, el contenido incluido reemplaza al que tuviera el elemento que hace la referencia. Una excepción a esto es la combinación de atributos desde los elementos de referencia y a los que se hace referencia, que se soporta en el documento resuelto para cambiar el estilo y para la publicación del documento.
Las referencias de contenido se basan en elementos, de modo que el elemento al que se hace referencia debe coincidir con el que contiene la referencia. El contenido al que se hace referencia puede verse en el documento, pero no es posible editarlo. Para poder efectuar cambios debe modificar la fuente original de la referencia. Arbortext Editor permite usar el Administrador de recursos para localizar contenido al que hacer referencia en los documentos. Si en el documento no hay actualmente ningún elemento de referencia válido, el Administrador de recursos inserta automáticamente un nuevo elemento vacío en el documento que será el destino de la referencia de contenido.
Las referencias de contenido se definen por medio de un atributo en el tipo de documento. El atributo se define en el fichero de configuración de tipo de documento (.dcf). En los documentos DITA, el atributo conref está disponible para la mayoría de los elementos DITA y se usa como atributo de referencia de contenido.
En el atributo de referencia de contenido, la cadena que se refiere a un elemento de un tema DITA tiene el formato siguiente:
[[ruta/]nombre_fichero][#ID_tema[/ID_elemento]]
[[ruta/]nombre_fichero] es una referencia opcional al fichero que contiene la referencia. Puede ser un nombre de fichero absoluto o relativo, y puede incluir componentes de ruta. Si no se especifica un nombre de fichero, se supone que la referencia se encuentra en el documento actual. Si no se especifica un nombre de fichero absoluto, la referencia de contenido se resuelve con la ruta de referencias DITA.
ID_tema/ID_elemento es una ruta de navegación de atributos de ID dentro de un documento. ID_tema es el identificador del elemento tema DITA (o de la especialización de un tema, como Concept, Task o Reference) que contiene el elemento referenciado. ID_elemento es el identificador del elemento del tema que se reutiliza, por ejemplo un párrafo o un elemento de lista. Ambos son obligatorios para las referencias de contenido dentro de los temas. Si se omite ID_elemento, la referencia abarca todo el tema. Si se omiten ID_tema e ID_elemento, la referencia es al primer tema del fichero.
En el atributo de referencia de contenido, la cadena que se refiere a un elemento de un mapa DITA tiene el formato siguiente:
[[ruta/]nombre_fichero][#ID_elemento_mapa]
En las referencias a elementos de mapas DITA sólo es necesario el ID del elemento. Si se omite ID_elemento_mapa, la referencia abarca todo el mapa. Si se omite nombre_fichero, la referencia es a un elemento del documento actual.
Por ejemplo, supongamos que un elemento párrafo DITA contiene la referencia de contenido siguiente:
<p conref=”C:\DITA content\releases.dita#product/version”></p>
El atributo conref indica que el contenido del elemento p debe incluirse desde el elemento p con el ID version, que es un elemento secundario del elemento tema con el ID product, que se encuentra en el documento releases.dita. El documento releases.dita de la referencia contendría los elementos siguientes: