Uso de la comprobación de integridad con documentos DITA
Arbortext Editor amplía la función regular de comprobación de integridad para ofrecer una comprobación de integridad avanzada para los documentos DITA. Si se crea un documento DITA y se selecciona > o se pulsa en el botón Comprobar integridad de la barra de herramientas, se realiza una comprobación de integridad normal inicial en el documento. Una vez finalizada la comprobación de integridad, Arbortext Editor realiza una comprobación de integridad avanzada para detectar incidencias específicas a DITA. Todas las incidencias se indicarán en el Registro de comprobación de integridad. Si la comprobación de integridad avanzada tarda más de unos segundos en completarse, aparece una barra de progreso.
La comprobación de integridad regular verificará los elementos que se puedan validar mediante el tipo de documento asociado con el documento. La comprobación de integridad avanzada verificará los elementos descritos en el estándar DITA, pero no podrá validarse en comparación con el esquema DTD o XML. Por ejemplo, la comprobación de integridad avanzada busca los ficheros que faltan, los formatos de URL incorrectos o inusuales, los valores de atributos inusuales de format y type, el uso de elementos o atributos obsoletos, etc.
Es posible realizar una comprobación de integridad avanzada ya sea en un tema o en un mapa DITA. Para un tema DITA, la comprobación de integridad avanzada sólo se realizará en el tema. Para un mapa DITA, la comprobación de integridad avanzada se realizará no solo en el mapa, sino también en otros mapas o temas DITA a los que se haga referencia en el mapa, en función de la configuración de la preferencia avanzada ditacheckreferences. El contenido DITA al que se haga referencia desde los mapas DITA a los que, a su vez, se haga referencia desde el mapa original se incluye también en la comprobación de integridad avanzada. También es posible seleccionar parte de un mapa DITA y llevar a cabo la comprobación de integridad avanzada en esa parte del mapa. En este caso, la comprobación de integridad regular se llevará a cabo en todo el mapa, pero la comprobación de integridad avanzada sólo se llevará a cabo en la parte seleccionada del mapa.
Cuando comience la comprobación de integridad avanzada, se mostrará el mensaje Se ha iniciado la comprobación de integridad avanzada… en el área de mensajes en la parte inferior de la ventana del Arbortext Editor. A medida que se lleva a cabo la verificación, este mensaje muestra el estado de la comprobación de integridad avanzada. Cuando se complete la verificación, se mostrará el mensaje Se ha completado la comprobación de integridad avanzada. No se han producido errores ni avisos, o bien el mensaje Ha concluido la comprobación de integridad avanzada. Para obtener información detallada, consulte la ventana de mensajes. En este último caso, se mostrará la ventana Registro de comprobación de integridad donde se enumerarán los avisos o los errores relacionados con DITA que se hayan detectado en el documento. Cada error o aviso tendrá un vínculo después del mensaje asociado. Si se pulsa dos veces en el vínculo, el cursor se moverá al lugar del documento asociado donde se haya detectado el error o el aviso. Si en el error o el aviso 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.
La comprobación de integridad avanzada verifica las categorías siguientes de incidencias relacionadas con DITA:
• Problemas de marcador DITA: incidencias como, por ejemplo, el uso de un marcador obsoleto, los valores de atributo no válidos no verificados por el tipo de documento, el uso de etiquetas concebidas para la especialización, etc.
• Problemas de referencia DITA: incidencias como, por ejemplo, valores de atributo href no válidos, valores de atributo format o type inusuales o incorrectos, etc.
Debe tenerse en cuenta que los valores con los que se verifica el atributo format se determinan según la configuración de la preferencia avanzada ditaexpectedformats.
• Problemas de clave y de referencia de clave DITA: incidencias relacionadas con claves y referencias de clave como, por ejemplo, referencias de clave no definidas, nombres de definición de clave no válidos y problemas que resuelvan referencias conkeyref.
En la ventana Registro de comprobación de integridad 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.
• Cerrar: permite cerrar la ventana de mensaje.
El menú Ver tiene las opciones siguientes:
• 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.
• Contraer/Expandir — contrae o expande la entrada actual.
La comprobación de integridad avanzada tiene las siguientes limitaciones:
• Para un mapa DITA, la comprobación de integridad periódica se realiza solo en el mapa, no en los temas ni los mapas DITA a los que se hacen referencia en el mapa original.
• Los temas DITA a los que se hace referencia en otros temas no se incluyen en la comprobación de integridad avanzada.
• Para los mapas DITA que contienen un número elevado de referencias de temas, la comprobación de integridad avanzada puede tardar más en completarse que la comprobación de integridad regular.