Personalización de la generación de ID de DITA
En Arbortext Editor se incluye la capacidad para generar los ID de los elementos en documentos DITA. Estos ID se generan en función del título, texto e información del elemento a partir del documento actual. Por defecto, se adjunta un número hexadecimal de ocho dígitos a el ID según la fecha y hora actuales (por ejemplo, DITAAuthoringOverview-030963B9). Es probable que estos ID sean exclusivos en un conjunto de documentos DITA. Los ID de DITA se generan mediante la función generate_id. Si se activa la opción en el fichero de configuración de tipo de documento (.dcf) para el tipo de documento, los ID también se podrán introducir de forma manual.
Los ID de DITA se pueden generar de la siguiente forma:
• Seleccione >
• Seleccione el botón Generar ID de la barra de herramientas
• Seleccione el botón Generar ID del cuadro de diálogo Modificar atributos, de la pantalla de atributos de mapa del documento, de columna de atributos de modificación de la vista por columnas o la columna ID de la vista por columnas
• Cree un nuevo tema DITA desde la ficha Tema nuevo del Administrador de recursos
• Guarde el tema DITA creado a partir de uno de los ficheros de plantilla de los tipos de documento DITA
En este caso, Arbortext Editor genera automáticamente un ID para el tema cuando se guarda por primera vez el documento.
Por defecto, los ID no se muestran en las columnas de la vista por columnas ni en el Administrador de recursos. Los ID se muestran en la vista de edición y el cuadro de diálogo Modificar atributos.
Un ID existente se puede modificar en las siguientes ubicaciones:
• Cuadro de diálogo Modificar atributos
• Pantalla de atributos de mapa del documento
• Columna de atributos de modificación de la vista por columnas
• Columna ID de la vista por columnas
Se puede introducir un ID actualizado o utilizar el botón Generar ID para generar un ID nuevo. Si se intenta cambiar un ID existente mediante el botón Generar ID, se le pedirá al usuario que confirme que desea reemplazar el ID existente. Si se introduce un ID nuevo de forma manual, este mensaje no aparecerá.
Es posible personalizar el comportamiento de generación de ID por defecto de documentos DITA de la manera siguiente:
• Defina la opción ditahideids en off.
De este modo se permitirá la visualización de las ID en el explorador del Administrador de recursos y se mostrará la opción ID en la ficha Tema nuevo del Administrador de recursos.
• Defina la opción generateuniqueid en off.
De esta forma se acortarán los ID por defecto al eliminar la cadena hexadecimal adjunta al ID.
• En el fichero de configuración del tipo de documento (.dcf) para un tipo de documento DITA, defina el atributo dialogHidden o screenHidden del elemento AttributeOptions en true para el atributo id de DITA.
De este modo se ocultará el atributo id en los cuadros de diálogo y vistas de Arbortext Editor.
• En el fichero .dcf, defina el atributo assignId del elemento Options en no.
De esta forma, se impide a los usuarios modificar las ID generadas automáticamente.
• En la categoría Columnas del cuadro de diálogoPreferencias, active la casilla de la columna ID
De este modo, se mostrará la columna ID de la vista por columnas para un mapa DITA. También se puede cambiar el orden en el que se muestra la columna ID en el cuadro de diálogo.