Uso de vínculos con documentos DITA
Los temas DITA tienen dos tipos de vínculos diferentes. En el cuerpo del tema, se puede usar el elemento xref para insertar referencias cruzadas o vínculos en línea. En la parte related-links del tema, se puede usar el elemento link para insertar vínculos. Los vínculos relacionados también se generan a partir de una tabla de relaciones al publicar un mapa DITA. Una xref puede vincularse con un tema, con elementos dentro de un tema y con documentos externos. Un link sólo puede hacer referencia a temas y documentos externos, y no a elementos dentro de un tema.
En el Administrador de recursos se incluye una ficha Vínculo/Referencia cruzada que permite buscar documentos en un sistema de ficheros, en un CMS o en Internet para usarlos como destino para un vínculo. La ficha también permite buscar dentro de un documento para localizar elementos específicos con los que se desee vincular. Una versión sin anclar de la ficha Vínculo/Referencia cruzada está disponible desde el cuadro de diálogo Modificar atributos, el mapa del documento y la vista por columnas, para modificar los vínculos existentes.
Si se inserta una referencia cruzada o un vínculo en un tema DITA,
Arbortext Editor recupera tanto el título como la descripción breve del destino del vínculo, si están disponibles, y muestra dicha información en la vista de edición. De este modo, se podrá determinar si el texto generado será suficiente para el vínculo o si es necesario crear texto para el vínculo. El texto de vínculo mostrado viene precedido por un diamante negro con fondo gris (
). Si no hay ningún título disponible para el destino del vínculo, el mensaje
El destino no tiene título; el texto de vínculo debe crearse aparecerá como texto de la vista previa.
Para crear el texto de una referencia cruzada o un vínculo en lugar de usar texto generado, se puede borrar fácilmente el texto vínculo de la vista previa. Al pulsar con el puntero del ratón en el texto de vista previa o mover el cursor al texto de vista previa, éste se seleccionará por completo. Cuando el texto de vista previa está seleccionado, se podrá borrar o se puede comenzar a escribir para introducir el texto del vínculo creado o de descripción. También se pueden utilizar las opciones del menú de accesos directos de la ventana de edición Usar texto de vínculo creado manualmente y Usar texto de vínculo generado para alternar entre ambos tipos de texto. Es posible usar la función de actualización de referencias para volver a mostrar el texto de vista previa borrado o actualizar el texto de vista previa.
La vista previa sólo está disponible para referencias locales a documentos DITA. Arbortext Editor intenta recuperar la información de título en primer lugar del elemento navtitle, luego del elemento title y, por último, del elemento searchtitle de un tema DITA. El texto de la descripción se recupera del elemento shortdesc.
Se debe tener en cuenta que el texto de vista previa del vínculo que se muestra en la vista de edición no se utiliza al publicar un documento. El proceso de publicación utiliza texto de vínculo creado u obtiene información de título y descripción de los destinos de vínculos en el momento de la publicación.