Actualización de referencias DITA
Arbortext Editor permite actualizar todas las referencias de un documento DITA. La operación de actualización de referencias permite realizar las siguientes actualizaciones:
• Verificaciones y actualizaciones (si fuese necesario) de los atributos de los elementos DITA que hacen referencia a otros documentos para comprobar que dichas referencias son las más actualizadas
Se incluyen los atributos href, type, format, scope y navtitle. Debe tenerse en cuenta que esta función no actualiza los atributos keyref o conkeyref. También se debe tener en cuenta que el atributo navtitle no se puede aplicar en caso de documentos DITA 2.0.
• Cambio de las rutas absolutas de los ficheros en relativas (si fuera posible) en función del URI base, el directorio del documento DITA y las carpetas incluidas en la ruta de referencias DITA, así como en la ruta de gráficos
• Actualización del texto de la vista previa de los vínculos
Las referencias se pueden actualizar para un tema o mapa DITA mediante la opción de menú > . Es posible también seleccionar parte de un tema o mapa DITA y sólo realizar la operación de actualización de referencias en la parte deseada mediante la opción de menú > . Asimismo, la referencia se puede actualizar para un solo elemento en un tema o mapa DITA si se pulsa con el botón derecho del ratón en dicho elemento y se selecciona Actualizar referencia en el menú de accesos directos de la ventana de edición.
Para un tema DITA, la operación de actualización de referencias sólo se realizará en el tema. Para un mapa DITA, la operación de actualización de referencias se realizará no sólo en el mapa, sino también en otros mapas o temas DITA a los que se haga referencia en el mapa. El contenido DITA al que se haga referencia en los mapas DITA a los que, a su vez, se haga referencia en el mapa original se incluye también en la operación de actualización de referencias.
Cuando se inicia la operación de actualización de referencias, se mostrará el mensaje Actualizando referencias: comprobando documento. Se han comprobado n elementos en el área de mensajes en la parte inferior de la ventana de Arbortext Editor y se actualizará para mostrar el estado de la operación de actualización de referencias. Cuando la actualización esté completa, se mostrará el mensaje Actualización de documento completa: sin cambios en n documentos con n elementos o el mensaje Actualización de documento completa: n cambios en n documentos con n elementos. En este último caso, aparecerá la ventana Actualizar mensajes de referencias en la que se mostrarán los cambios realizados por la operación, así como los avisos o errores que se detectaron durante la operación. Aparecerá un VÍNCULO tras cada mensaje. Si se pulsa dos veces en el VÍNCULO, el cursor se desplazará al lugar del mensaje en el documento asociado. Si en el mensaje se muestra información sobre un documento al que se hace referencia en un mapa DITA, dicho documento se abrirá en una ventana nueva de Arbortext Editor.
En la ventana Actualizar mensajes de referencias se incluyen dos menús y un menú de accesos directos.
En el menú Fichero se incluyen las opciones siguientes:
• Guardar: permite guardar el contenido de la ventana de mensaje en un fichero .xml. Si es la primera vez que se guarda desde que se abrió la ventana, se pedirá que se seleccione un nombre de fichero de salida.
• Guardar como — guarda el contenido en un fichero con otro nombre.
• Guardar como HTML: permite guardar el contenido en un fichero .htm.
• Imprimir: permite imprimir una versión publicada de la ventana de mensaje. La salida impresa mostrará la información especificada en el menú Ver.
• Borrar anterior: permite borrar todo el contenido de la ventana del mensaje excepto el contenido de la última operación de actualización de referencias.
• Despejar todo: permite borrar todo el contenido de la ventana de mensaje.
• Cerrar: permite cerrar la ventana de mensaje.
El menú Ver tiene las opciones siguientes:
• Contexto de código: si se activa esta opción, en la ventana de mensaje se muestra información contextual relacionada con el código situado cerca del punto donde se ha producido el problema (por ejemplo, un seguimiento de pila Java).
• Marcas de hora: si se activa esta opción, en la ventana de mensaje se muestra información de marcas de hora.
• ID de mensaje: si se activa esta opción, se muestra las ID de mensaje (si las hay) asociadas a las entradas del mensaje. Un ejemplo de ID de mensaje es A123456.
• Visualización: permite determinar el tipo de contenido que se debe mostrar en la ventana de mensaje:
◦ Mensajes — muestra toda la información (mensajes, avisos y errores).
◦ Avisos — sólo muestra los avisos y los errores. Esta es la opción por defecto.
◦ Errores — sólo muestra los errores.
• Tamaño de fuente: se proporcionan dos opciones para cambiar el tamaño de fuente de la ventana de mensaje:
◦ Aumentar — aumenta el tamaño de la fuente de pantalla.
◦ Reducir — reduce el tamaño de la fuente de pantalla.
El menú de accesos directos aparece al pulsar con el botón derecho del ratón dentro de la ventana de mensajes. El menú tiene las opciones siguientes:
• Copiar — copia la región seleccionada en el portapapeles. Esta opción sólo está disponible cuando se pulsa dentro de una región seleccionada.
• Seguir vínculo: al pulsar con el botón derecho del ratón en un VÍNCULO de la ventana de mensaje y seleccionar esta opción, se muestra el documento vinculado con el cursor situado en la ubicación adecuada del documento de origen. Esta opción no tiene ningún efecto cuando no hay vínculos en la ventana de mensaje.
• Suprimir — oculta el mensaje actual. Para ver los mensajes ocultos, elija > > .
• Contraer/Expandir — contrae o expande la entrada actual.