Comprobación de integridad
Es posible realizar una comprobación de integridad en un documento y, de forma opcional, en todos sus subcomponentes como, por ejemplo, las entidades de fichero. Arbortext Editor verifica que están presentes todos los componentes que requiere el tipo de documento. Mientras se crea y se edita un documento, Arbortext Editor verifica constantemente el contexto de las inserciones y cambios previstos, y proporciona feedback para garantizar que se crea un documento SGML o XML válido. Sin embargo, es posible que sigan faltando algunos elementos obligatorios cuando se intente guardar y salir del documento, porque Arbortext Editor no exige que el documento esté completo. Si faltan elementos obligatorios, se generará una lista con los problemas.
Durante la comprobación de integridad,
Arbortext Editor averigua también si hay problemas con referencias a ID, referencias cruzadas, elementos vacíos y atributos obligatorios que faltan, y verifica la validez de las entidades de gráfico. Para documentos
DITA,
Arbortext Editor realiza una comprobación de integridad avanzada adicional después de completar la comprobación normal completa. La comprobación de integridad avanzada abarca diversas áreas adicionales que son específicas de los documentos DITA. Para obtener más información, consulte la sección sobre el
uso de la comprobación de integridad con documentos DITA.
Ejecución de comprobaciones de integridad
Búsqueda de errores de integridad en los documentos
Use el comando check_completeness con la opción -full para incluir las entidades.
Si el documento está completo, aparecerá un mensaje en la barra de estado para corroborar que no se han encontrado errores. Si INC aparece resaltado en la barra de estado de la parte inferior de la ventana de edición, el documento está incompleto y se abrirá la ventana Registro de comprobación de integridad en la que se mostrarán los errores.
2. Pulse dos veces en el vínculo que se encuentra junto al primer error que figura en la ventana Registro de comprobación de integridad.
El cursor se desplazará a la ubicación del error en el documento.
3. Si fuera necesario, corrija el error.
4. Repita el proceso para error incluido en la lista.
Ventana Registro de comprobación de integridad
Los mensajes de comprobación de integridad aparecen en la ventana Registro de comprobación de integridad. Los mensajes se dividen en las categorías siguientes:
• Errores de integridad: errores de verificación de contexto como, por ejemplo, elementos fuera de contexto o elementos obligatorios que faltan
• Errores de marcador: distintos errores en los que el marcador es incorrecto como, por ejemplo, etiquetas o atributos no declarados, atributos duplicados, valores de atributo no válidos, atributos obligatorios faltantes, nombre de PI no válido, entidades de fichero no resueltas, elementos vacíos, etc.
• Errores de referencia a entidad: referencias a entidades y anotaciones no declaradas
• Errores de ID y de referencia a ID: indica del número de referencias de ID faltantes y de las ID definidas varias veces.
• Errores de esquema: todas las restricciones de identidad para los tipos de esquema XML
• Errores de marcadores de tabla: marcador de tabla incorrecto que impide que Arbortext Editor pueda reconocer el marcador como una tabla, por ejemplo una fila sin etiquetas de celdas
• Avisos de marcadores de tabla: marcador de tabla incorrecto que puede provocar incidencias con la tabla, pero no impide que Arbortext Editor pueda reconocer el marcador como una tabla
• Avisos de Schematron: avisos notificados por el Schematron por defecto del tipo de documento
Debe tenerse en cuenta que los documentos DITA tienen categorías adicionales.
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.
Posibles incidencias de la comprobación de integridad
Debe tenerse en cuenta las incidencias potenciales siguientes al utilizar la función de comprobación de la integridad:
• Si ha aplicado un
mapa de alias al documento, los nombres de elemento del panel serán los alias.
• Es posible que se produzca un error del analizador al utilizar
Equation Editor para una ecuación que aparentemente es correcta. Esto puede suceder porque, al incorporar el fragmento de tipo de documento matemático dentro de otro tipo de documento, el tipo de documento de destino puede tener un modelo de contenido que admita que no haya contenido. Para obtener más información, consulte
Integración de Equation Editor en un tipo de documento.
• Si el documento SGML contiene entidades de fichero no creadas en Arbortext Editor o entidades editadas en otros programas, no se normalizarán al guardar el documento. La normalización añade etiquetas desestimadas para que los pares de etiquetas estén completos. Al no normalizarse las entidades de fichero, pueden producirse errores de contexto o integridad al intentar editarlas dentro del documento. Para garantizar que un documento está normalizado e íntegro, elija la opción Leer como: Importar SGML al abrir el documento desde el cuadro de diálogo Abrir.