SanityCheck 1.0.9

Macros para unificar el formato y estilos de las guías de LibreOffice v.2X.z

Derechos de autor

Este documento tiene derechos de autor © 2024 por el equipo de documentación de LibreOffice. Los colaboradores se listan más abajo. Se puede distribuir y modificar bajo los términos de la GNU General Public License versión 3 o posterior o la Creative Commons Attribution License, versión 4.0 o posterior.

Todas las marcas registradas mencionadas en esta guía pertenecen a sus propietarios legítimos.

Autor	Colaboradores
B.Antonio Fernández	Olivier Hallot

Fuentes

Las macros que componen la extensión aquí descrita son fruto de consultar distintas fuentes las cuales nombro en rasgos generales pues me es imposible detallar. Estas son:

• La propia documentación del lenguaje Basic de los distintos derivados de StarOffice.

• Los libros: Aprendiendo OooBasic de Mauricio Baeza, OpenOffice.org Macros Explained de Andrew Pitonyak y Programmation OpenOffice.org de Bernard Marcelly.

• Consultas a los foros de OpenOffice y LibreOffice y el estudio de otras macros en las extensiones para Libre Office.

Introducción

SanityCheck es una biblioteca de macros para Writer que pretende servir de ayuda para unificar el formato y los estilos de los capítulos y de las guías de LibreOffice.

Aunque algunas tareas se pueden realizar con las herramientas propias de Writer, las macros intentan centralizar las opciones que son específicas para el formato de los capítulos y automatizar algunos procesos que pueden llevar mucho tiempo y ser tediosos.

Como norma de seguridad, trabaje sobre una copia del archivo que vaya a revisar y guarde su trabajo progresivamente.

Utilice las macros preferentemente en los capítulos, antes de ensamblar la guía, pues le será más fácil corregir errores de formato y reducirá el tiempo de ejecución de las macros.

Instalación y características

Las macros están empaquetadas como extensión y su instalación se efectúa como cualquier otra extensión, desde el gestor de extensiones. Si encuentra problemas en la actualización o instalación de una nueva versión, desinstale la versión antigua e instale la nueva versión.

• Están escritas en LO Basic por lo que deberían ser compatibles para cualquier sistema operativo sin necesidad de instalar ninguna dependencia.

• Añade una barra de herramientas (figura 1), así como un menú con nombre LO SanityCheck . Las herramientas también aparecen integradas en la interfaz de usuario En pestañas.

• Están disponibles en español, inglés y portugués, con la posibilidad de agregar otros idiomas añadiendo traducciones al módulo L10n.

• Incorporan plantillas con los estilos propios de las guías (también en los tres idiomas para posibilitar la corrección ortográfica):

• Plantilla de capítulo (para los capítulos individuales).

• Plantilla patrón de documento (para crear un documento patrón y ensamblar la guía o asociarla a una guía completa en formato odt).

• Plantilla de contraportada (para adjuntar a la guía completa).

• Cada diálogo contiene una página de ayuda integrada que aporta información sobre la función de la herramienta y después ejecutar las macros se muestra un resumen de registro cambios.

Macros incluidas

• Disponibilidad de las macros

Las macros están pensadas para el formato específico de las guías y concretamente para aplicarlas a los capítulos de las guías.
Aunque algunas macros se pueden emplear en un patrón de documento o una guía completa, encontrará que varias macros están deshabilitadas por razones de seguridad. Así mismo están muy limitadas para otros documentos ajenos a las guías.

Alternar resaltes

Macro disponible para todo tipo de documento.

Resalta o quita un resalte a los estilos de las guías aplicados en el documento para distinguir fácilmente los estilos y comprobar su correcta aplicación. Es especialmente útil para comprobar si las listas tienen formato directo aplicado.

Asociar plantilla

Macro disponible para todo tipo de documento.

Asocia el documento con una de las plantillas suministradas que contienen los estilos propios de la documentación.

• Es la manera recomendada de trasladar los nuevos estilos a documentos antiguos. Si el documento no contiene los estilos necesarios, algunas macros estarán deshabilitadas.

• Notas

— La plantilla patrón de documento se puede asociar a las guías completas tanto en formado ODM (patrón de documento) como en formato ODT. Esta plantilla contiene los mismos estilos que la de los capítulos pero difiere en los niveles de títulos que se presentan en el índice.
— En otros documentos sólo se puede aplicar la plantilla de capítulos.

Campos

Esta macro solo está disponible para capítulos o guías completas.

Abre un diálogo donde se configuran la mayor parte de las propiedades y campos personalizados del documento que se utilizan en los capítulos.

• Notas

— Los campos Capítulo X y Título están deshabilitados en guías completas.
— Los campos Colaborador y Editor, introducidos a partir de la versión 24, se rellenan automáticamente

Renombrar Objetos

Esta macro solo está disponible para los capítulos de las guías.

Permite renombrar las secciones, marcos, imágenes, tablas, objetos OLE y el índice con un patrón estándar para cada objeto y una numeración consecutiva según el orden de aparición en el documento.

• Nota

En la nueva versión de los capítulos, la sección COPYRIGHT debe estar incluida dentro de la sección DISPLAYAREA.
— Al renombrar las secciones la sección SEC_COPYRIGHT se desplaza automáticamente al inicio de SEC_DISPLAYAREA

Verificar estilos

Macro disponible para todo tipo de documento.

• Comprueba que los estilos empleados en los capítulos sigan los estándares de la plantilla para evitar estilos ajenos a las guías (generalmente estilos de plantillas anteriores).

• Recorre el documento y marca los párrafos con estilo ajeno a la documentación con un comentario y resalta los estilos de carácter ajeno con fondo negro y letra amarilla.

• Sustituye los estilos de párrafo anteriores a las guías de la versión 24 por sus correspondientes actualizados, algunos con nombre incorrecto (transición a la nueva plantilla) y el estilo de carácter MenuPath por Destaque mayor (restos de versiones antiguas).

• Permite la eliminación de estilos ajenos cuando no están aplicados en el documento.

• Nota

Las macros no pueden hacerlo todo. La labor del revisor consiste en sustituir los estilos ajenos a la plantilla por los correctos y eliminarlos del documento

Limpieza de formato directo

Esta macro solo está disponible para los capítulos de las guías.

• Texto: limpia el formato directo aplicado a fragmentos o cadenas de texto. Al ejecutarla las numeraciones de las listas ordenadas se vuelven consecutivas en todo el documento por lo es recomendable marcar también la limpieza de Párrafos numerados.

• Párrafos: Elimina el formato directo incluido el de bolos o numeraciones aplicado a párrafos normales y limpia también el formato directo de las listas no ordenadas.

• Párrafos Numerados: En este caso, la macro elimina el formato directo aplicado a listas ordenadas y reinicia las numeraciones siempre que es posible, añadiendo un comentario a los párrafos en que puede que la numeración necesite un reinicio.

• Notas

Para que la macro reinicie correctamente las numeraciones, toda lista debe estar precedida por el estilo de párrafo Body Text, List Intro. En muchos casos el estilo anterior a las listas es Cuerpo de texto.
La macro cambia automáticamente el estilo de los párrafos anteriores a las listas cuando tienen aplicado el estilo Cuerpo de texto.

Revisión de tablas

Macro disponible para todo tipo de documento

Mediante un diálogo permite recorrer las tablas del documento y aplicar el estilo de tablas LO User Guides a tablas con datos u optimizar el espaciado en las tablas de posiciónar el contenido. Se puede editar el documento mientras el diálogo está abierto.

Ajuste de figuras

Esta macro solo está disponible para los capítulos de las guías.

Esta macro no tiene un diálogo inicial, se ejecuta con los ajustes óptimos para los marcos e imágenes. Desde el diálogo de registro (figura 8) se puede acceder a la macro Recorrer imágenes.

• Aplica el ancla y formato adecuado a las imágenes, a los marcos que las contienen y a las leyendas.

• Obtiene el texto de la leyenda para aplicarlo a la descripción del marco e imagen.

• Inserta comentarios en:

- Imágenes cuya relación de aspecto está desproporcionada.

- Imágenes que han sido recortadas con Writer.

- Leyendas mal formadas (posibles fallos en la modificación de una leyenda ya insertada).

Recorrer imágenes

Macro disponible para todo tipo de documento

Al igual que ocurre con las tablas se pueden recorrer las imágenes mediante un diálogo que muestra información sobre las imágenes y se puede editar el documento y algunas propiedades de las imágenes y marcos para corregir errores. Tenga en cuenta que no modifica la leyenda de los marcos, sólo su descripción.

Info

Abre un diálogo con la información de la versión (figura 10)

Limitaciones, problemas conocidos y recomendaciones

Plantillas

Las macros para verificar estilos y limpiar el formato directo están basadas directamente en las plantillas suministradas. Para que las macros funcionen correctamente, los capítulos tienen que tener aplicada la plantilla adecuada.

Se suministran plantillas para los idiomas Español, Inglés y portugués, pero solo se verán las plantillas correspondientes al idioma de la interfaz.

Las macros determinan el tipo de documento en función del nombre de archivo y seleccionan la plantilla adecuada para aplicar a los capítulos o a las guías completas (tanto en formato odm como en formato odt). En otros documentos solo se puede asociar la plantilla de capítulos.

Estilos

Problemas con Nombres de estilos:

En algunos documentos, debido a las prisas por publicar la nueva versión se han creado estilos de párrafo con nombres similares (pero no iguales) a los que deben ser. Esto ocurre en algunos capítulos de la guía de Writer 24,2. Por ejemplo en lugar de Body Text, List Intro tiene aplicado el estilo Body Text List Intro (sin la coma)

Solución:

La macro sustituye esos estilos por los correctos, pero no puede controlar todos los errores. Corrija manualmente los estilos afectados.

Problema con estilos de carácter:

Al limpiar los estilos de carácter personalizados, Writer no actualiza su estado, y continúan apareciendo como aplicados aunque realmente no lo estén.

Solución:

Una vez limpio el documento de un estilo de carácter, se debe guardar y recargar el documento y para que Writer actualice su estado y al no estar en uso se puede eliminar.

Problemas con estilos de lista:

Al aplicar un formato directo de lista a un párrafo con un estilo de lista personalizado en ciertas ocasiones L.O. sobrescribe el formato personalizado y es muy complicado devolver el formato adecuado al estilo de lista personalizado.

Solución

Aplicar de nuevo la platilla corrige este problema.

Limpieza de formato directo de Párrafos

La macro no puede distinguir que tipo de formato directo se ha aplicado a un párrafo, por lo que elimina todo el formato directo, sea de sangría, de numeración o bolos, espaciado etc.

Consejo:

Use la macro Alternar resalte antes de limpiar el formato directo de los párrafos para una comprobación visual.
Una comparación con un pdf del capítulo que esté actualizando puede serle de gran utilidad.

Limpieza de formato directo de Numeraciones (listas ordenadas)

Las secuencia de numeración en listas ordenadas puede estar interrumpida por imágenes, avisos, notas o sugerencias.

Al limpiar el formato, la secuencia de numeración se pierde y la numeración se vuelve continua. Las macros intentan reiniciar la numeraciones pero no es fácil distinguir dónde reiniciarlas. Aunque la macro avisa de puntos donde se podría reiniciar, no es infalible.

Consejo:

Use la macro Alternar resalte antes de limpiar el formato directo de los párrafos para una comprobación visual y revise las numeraciones antes y después de ejecutara la macro.

Tablas

Los estilos personalizados de las tablas no se aplican ni funcionan como los estilos de párrafo o de carácter, por lo que aunque aplique el estilo LO User Guides, es muy probable que tenga que ajustar la tabla para la división entre páginas, si fuera necesario y aplicar un formato más adecuado mediante el diálogo Propiedades de la tabla de Writer.

Marcos

Al ajustar las figuras, los marcos se adaptan automáticamente a la anchura mayor del texto o de la imagen. En algunos casos, los marcos se ajustan a la anchura total del texto de la página.

Problema:

El problema puede ser debido a un formato viciado en el archivo original.

Solución:

1. Cree un nuevo documento con la plantilla suministrada.

2. Seleccione todo el texto del documento afectado y cópielo sobre el nuevo documento.

3. Trabaje sobre el nuevo documento.

Imágenes

En algunos casos, la macro inserta un comentario en imágenes que no es comprensible.

Problema:

LibreOffice emplea muchos decimales para la relación de aspecto de las imágenes, (es posible que utilice los píxeles) y las macros utilizan una regla de tres basada en las dimensiones de las imágenes y a veces no coincide la operación realizada por LibreOffice con la realizada por las macros.

Si encuentra un comentario avisando de un problema de escala y el porcentaje de anchura y altura son los mismos en la página Recortes del diálogo Propiedades de la imagen,

Solución:

Aumente una unidad de ambos o uno de los porcentajes y no recibirá el aviso o borre el comentario.

Leyendas de las figuras

En algunos casos la macro inserta el comentario «Leyenda mal formada» no comprensible.

Problema:

Para aplicar las descripciones a imágenes y marcos, la macro obtiene el texto de la leyenda y se basa en los dos puntos y el espacio de la secuencia «Figura: ».

Al editar la leyenda directamente, a veces, se olvida el espacio posterior a los puntos.

Solución:

Corrija la leyenda y vuelva a ejecutar la macro.

Problema:

En casos aislados puede encontrado el aviso y la leyenda esta bien formada.

Esto puede ser debido a un formato extraño en la figura, por ejemplo imágenes con un doble marco (marcos anidados).

Solución:

1. Reconstruya la figura copiando solo la imagen y pegándola en otro párrafo (asegúrese de copiar solo la imagen).

2. Inserte una nueva leyenda.

3. Corrija las referencias a la figura dentro del texto del documento.