SanityCheck 1.0.6

Macros para unificar o formato e estilos dos guias do LibreOffice v.2X.z

Direitos autorais

Este documento é protegido por direitos autorais ©2024 pela equipe de documentação do LibreOffice. Os contribuidores estão listados abaixo. Pode ser distribuído e modificado nos termos do GNU General Public License versão 3 ou posterior ou do Creative Commons Attribution License versão 4.0 ou posterior.

Todas as marcas registradas mencionadas neste guia pertencem aos seus legítimos proprietários.

Autor	Colaboradores
B. Antonio Fernández	Olivier Hallot

Fontes

As macros que compõem a extensão aqui descrita são o resultado da consulta de diferentes fontes que nomeio em termos gerais, uma vez que me é impossível entrar em detalhes. Estes são:

• A documentação da LibreOffice Basic e dos diferentes derivados do StarOffice.

• Os livros: Aprendiendo OooBasic por Mauricio Baeza, OpenOffice.org Macros Explained por Andrew Pitonyak e Programmation OpenOffice.org por Bernard Marcelly.

Bem como diversas consultas aos fóruns OpenOffice e LibreOffice e o estudo de outras macros nas extensões para LibreOffice.

Introdução

SanityCheck é uma biblioteca de macros para o Writer que visa ajudar a unificar a formatação e os estilos dos capítulos e guias do LibreOffice.

Embora algumas tarefas possam ser executadas com ferramentas próprias do Writer, as macros tentam centralizar opções específicas do formato do capítulo e automatizar alguns processos que podem ser tediosos e demorados.

Como regra de segurança, trabalhe em uma cópia do arquivo que irá revisar e faça cópias progressivas do seu trabalho.

Utilize macros preferencialmente em capítulos, antes de montar o guia, pois será mais fácil corrigir erros de formatação e reduzirá o tempo de execução das macros.

Instalação e recursos

As macros são empacotadas como uma extensão e instaladas como qualquer outra extensão, a partir do gerenciador de extensões. Se você encontrar problemas para atualizar ou instalar uma nova versão, desinstale a versão antiga e instale a nova versão.

• As macros são escritas em LO Basic portanto devem ser compatíveis com qualquer sistema operacional sem a necessidade de instalação de dependências.

• A extensão adiciona uma barra de ferramentas (1), e um menu chamado LO SanityCheck. Las ferramentas também estan integradas à interface do usuário Em abas.

• As macros estão disponíveis em espanhol, inglês e português, com possibilidade de agregar outros idiomas adicionando traduções ao módulo L10n.

• A extensão incorpora modelos com estilos próprios dos guias (também nos três idiomas para permitir a correção ortográfica):

- Modelo de capítulo (para capítulos individuais).

- Modelo de Documento Mestre (para montar o guia completo).

- Modelo de contracapa (para anexar no final do guia completo).

• Cada caixa de diálogo contém uma página de ajuda integrada que fornece informações sobre a função da ferramenta e, após a execução das macros, um resumo do log de alterações é exibido.

Descrição das macros

Alternar destaque

A macro realça ou desmarca os estilos de guia aplicados no documento para distinguir facilmente os estilos e verificar sua aplicação correta. É especialmente útil para verificar se as listas possuem formatação direta aplicada.

Associar modelo

Associa o documento ao modelo fornecido que contém os estilos próprios da documentação.

• Esta é a forma recomendada de transferir novos estilos para documentos antigos.

• Se o documento não contiver os estilos necessários, algumas macros não funcionarão.

Campos do documento

A macro abre uma caixa de diálogo onde você configura a maioria das propriedades do documento e campos personalizados usados nos capítulos.

• Nota

- Os campos Capítulo X e Título são novos campos. Estes campos são utilizados para definir a propriedade Título do Documento e também para o rodapé.
Seu uso é recomendado para o nome do capítulo na primeira página.
- Os novos campos Colaborador e Editor (introduzidos na versão 24) serão preenchidos automaticamente

Renomear objetos

Esta macro permite renomear seções, quadros, tabelas, imagens e índice com padrão para cada objeto e numeração consecutiva de acordo com a ordem de aparecimento no documento.

Verificar estilos

• A macro verifica se os estilos usados nos capítulos seguem os padrões dos templates para evitar estilos externos aos guias (geralmente estilos de templates anteriores).

• A macro percorre o documento e marca os parágrafos com estilo externos na documentação com um comentário e destaca estilos de caracteres externos com fundo preto e fonte amarela.

• A macro substitui estilos de parágrafo anteriores aos guias da versão 24 por suas contrapartes atualizadas, alguns com nomes incorretos (transição para o novo modelo) e o estilo de caractere MenuPath por Ênfase forte (remanescentes de versões mais antigas).

• A macro permite eliminar estilos externos quando eles não são aplicados ao documento.

• Nota

Macros não podem fazer tudo. O trabalho do revisor é substituir os estilos extranos ao modelo pelos corretos e eliminá-los do documento

Limpeza de formato direto

• Texto: limpa a formatação direta aplicada a fragmentos ou strings de texto.

• Parágrafos: Elimina a formatação direta, incluindo marcadores ou numeração, aplicada a parágrafos normais e também limpa a formatação direta de listas não ordenadas.

• Parágrafos Numerados: Neste caso, a macro remove a formatação direta aplicada às listas ordenadas e reinicia a numeração sempre que possível, adicionando um comentário aos parágrafos onde a numeração pode precisar ser reiniciada.

• Nota:

Para que a macro redefina corretamente a numeração, cada lista deve ser precedida pelo estilo de parágrafo Body Text, List Intro. Em muitos casos, o estilo antes das listas é Corpo de texto. A macro altera o estilo dos parágrafos anteriores as listas para o estilo Body Text, List intro após uma mensagem de confirmação.

Ajuste de tabelas

Através de uma caixa de diálogo, esta macro permite percorrer as tabelas do documento e aplicar o estilo de tabela LO User Guides às tabelas com dados ou otimizar o posicionamento de conteúdo nas tabelas. Você pode editar o documento enquanto la caixa de diálogo estiver aberta.

Ajuste de figuras

Esta macro não possui diálogo inicial, ela roda com as configurações ideais para os quadros e imagens. Na caixa de diálogo de registro (8), você pode acessar a macro Percorrer imagens.

• La macro aplica a âncora e a formatação apropriadas às imagens, aos quadros que as contêm e às legendas.

• Obtém o texto da legenda para aplicar-lo à la descrição ao quadro e a imagem.

• Insira comentários em:

- Imagens cuja proporção no é proporcional.

- Imagens que foram recortadas com Writer.

- Legendas mal formadas (possíveis erros na modificação de uma legenda já inserida).

Percorrer imagens

Tal como acontece com as tabelas, você pode navegar pelas imagens através de uma caixa de diálogo que mostra informações sobre as imagens e pode editar o documento e algumas propriedades das imagens e quadros para corrigir erros. Observe que não modifica a legenda dos quadros, apenas sua descrição.

Info

Abre una caixa de diálogo informacional de la versiao (figura 10)

Limitações, problemas conhecidos e dicas

Modelos

As macros para verificação de estilos e limpeza de formatação direta baseiam-se diretamente nos estilos dos modelos fornecidos.

Para que as macros funcionem corretamente, os capítulos devem ter o modelo apropriado.

São fornecidos modelos para os idiomas português, espanhol e inglês, mas serão visualizados apenas os modelos correspondentes ao idioma da interface.

Estilos

Problemas com nomes de estilos:

Em alguns documentos, devido à pressa para publicar a nova versão, foram criados estilos de parágrafo com nomes semelhantes (mas não iguais) como deveriam ser. Isso ocorre em alguns capítulos do guia do Writer 24.2. Por exemplo, em vez de Corpo de texto, List Intro tem o estilo Body Text List Intro aplicado (observe que este nome não contém vírgula)

Solução:

A macro substitui alguns desses estilos pelos corretos, mas não consegue lidar com todos os erros. Corrija manualmente os estilos afetados.

Problema com estilos de caracteres:

Ao limpar estilos de caracteres personalizados, o Writer não atualiza seu status e eles continuam a aparecer como aplicados mesmo que não sejam realmente aplicados.

Solução:

Uma vez que o documento tenha sido limpo de um estilo de caractere, ele deve ser salvo e recarregado para que o Writer possa atualizar o status do estilo e, como não está em uso, pode ser excluído.

Limpeza do formato direto de parágrafos

A macro não consegue distinguir que tipo de formatação direta foi aplicada a um parágrafo, portanto elimina toda formatação direta: recuo, numeração, espaçamento, etc.

Conselhos:

Use a macro Alternar destaque antes de limpar a formatação direta de parágrafos para uma verificação visual.

Uma comparação com um PDF do capítulo que você está atualizando pode ser muito útil.

Limpeza do formato direto de números (listas ordenadas)

A sequência de numeração nas listas ordenadas poderá ser interrompida por imagens, avisos, notas ou sugestões.

Ao limpar o formato, a sequência de numeração é perdida e a numeração torna-se contínua. As macros tentam reiniciar a numeração, mas não é fácil distinguir onde reiniciar-las. Embora a macro avise sobre pontos onde pode ser reiniciada, a macro não é infalível.

Conselho:

Use a macro Alternar destaque antes de limpar a formatação direta do parágrafo para uma verificação visual e revise a numeração após executar a macro.

Tabelas

Os estilos de tabela personalizados não se aplicam ou funcionam como estilos de parágrafo ou caractere, portanto, mesmo se você aplicar o estilo LO User Guides, provavelmente precisará ajustar a tabela para divisão de página, se necessário, e aplicar uma formatação mais apropriada usando a caixa de diálogo Propriedades da tabela do Writer.

Quadros

Quando as figuras são ajustadas, os quadros se adaptam automaticamente à maior largura do texto ou imagem. Em alguns casos, os quadros ocupam toda a largura do texto da página.

Problema:

O problema pode ser devido a um formato corrompido no arquivo original.

Solução:

1. Crie um novo documento usando o modelo fornecido.

2. Selecione todo o texto do documento afetado e copie-o sobre o novo documento.

3. Trabalhe no novo documento.

Imagens

Em alguns casos, a macro insere um comentário nas imagens que não é compreensível.

Problema:

O LibreOffice usa muitos decimais para a proporção das imagens (pode usar pixels) e as macros usam uma regra de três com base nas dimensões das imagens e às vezes a operação realizada pelo LibreOffice não coincide com a realizada pelas macros.

Você pode encontrar um comentário avisando sobre um problema de dimensionamento e a porcentagem de largura e altura forem iguais na página Recortar da caixa de diálogo Propriedades da imagem.

Solução:

Aumente ambas ou uma das porcentagens em uma unidade e você não receberá o aviso.

Legendas das figuras

Em alguns casos, a macro insere um comentário de legenda mal formado que não é compreensível.

Problema:

A macro obtém o texto da legenda e remove o texto “Figura” com base nos dois pontos e no espaço da sequência.

Ao editar a legenda diretamente, há momentos em que o espaço após os pontos é esquecido.

Solução:

Corrija a legenda e execute a macro novamente.

Problema:

Em casos isolados pode-se encontrar o aviso de legenda mal formada e a legenda estava bem formada. Isto pode ser devido a uma formatação estranha na figura, por exemplo imagens com uma moldura dentro da moldura da legenda (quadros aninhados).

Solução:

1. Reconstrua a figura copiando apenas a imagem e colando-a em outro parágrafo (certifique-se de copiar apenas a imagem)

2. Insere uma nova legenda.

Sobre a tradução

Se você leu até aqui, terá visto muitos erros de vocabulário e gramaticais.

Este documento foi traduzido do espanhol com o Google (algumas correções feitas por mim).

Lamento que meu português seja tão ruim, mas espero que este documento seja compreensível.