5.5 Spell Check
Spell Check é o recurso que o programa DMHelp oferece para que todas as palavras do seu documento sejam verificadas se estão corretamente digitadas (ou "soletradas").
Para você utilizar este recurso deve entender, primeiro, como o programa DMHelp funciona.
Quando você solicita a conversão do documento (Form 5.3 Jobs), em primeiro lugar o programa DMHelp constrói uma "cópia" do seu documento na memória. Somente após isso serão geradas as saídas desejadas.
Essa "cópia" do seu documento fica na memória até a próxima conversão.
É nesse o momento que você deve executar o Spell Check.
Antes de executá-lo você deve, em primeiro lugar, especificar quais são os dicionários disponíveis. Faça isso em Form 5.4.4 Dictionaries onde você observará:
Após isso você deve especificar quais desses dicionários serão utilizados. Faça isso em Form 5.3 Jobs onde você observará:
Na imagem acima, nenhum dicionário está selecionado, ou seja, dessa maneira, mesmo cadastrados em Form 5.4.4 Dictionaries, nenhum dicionário seria utilizado. Selecione, portanto, os dicionários desejados.
Serão considerados, para o Spell Check, os dicionários cadastrados e selecionados e, além desses, mais um, que é o arquivo com mesmo nome do seu documento, mas com a extensão .DIC. Por exemplo, se seu documento se chamar MyManual.dmh será considerado que o arquivo MyManual.DIC também será um dicionário utilizado para o Spell Check. É óbvio que se esse arquivo não existir não será pesquisado (e nem será gerada mensagem de erro).
Muito bem, com o seu documento na memória do programa DMHelp e mais os dicionários, cadastrados, você pode ativar o Spell Check de duas maneiras:
Menu->Job->Spell Check (ou pressione a tecla F7)
ou
em Form 5.3 Jobs pressione Button: Spell Check
A partir daí, cada palavra do seu documento será pesquisada em cada dicionário cadastrado e selecionado (e mais o "MyManual.dic"). Caso não seja encontrada em nenhum deles, ao final do processo será exibida juntamente com as demais palavras não encontradas.
Se as palavras não encontradas estiverem corretamente digitadas, para que não apareçam mais você as deve incluir em pelo menos um dos dicionários. Se esse for o caso você pode simplesmente incluí-las nos dicionários adequados e executar o Spell Check novamente, sem a necessidade de reconverter o seu documento, já que o mesmo continua na memória. Você pode "copiar" e "colar" as palavras não encontradas (exibidas no Form 5.2 Mensagens) nos seus dicionários, para simplificar essa atualização.
Se as palavras não encontradas não estiverem corretamente digitadas, você deverá corrigir o arquivo fonte (ou os arquivos fontes) e executar nova conversão para reconstruir o documento na memória do programa DMHelp.
Palavras nos Dicionários
Um dicionário é um arquivo no formato texto com qualquer extensão (normalmente .DIC).
As palavras nos dicionários devem ser digitadas uma por linha sem espaços antes e nem depois das mesmas. Essas palavras não precisam estar em ordem alfabética.
Organização dos Dicionários
Existem vários dicionários para que você possa organizá-los como bem entender.
Utilize, por exemplo, um para cada idioma, outros com palavras especiais que você utilize em diversos documentos, etc.
Utilize o dicionário específico do seu documento ("MyManual.dic") para armazenar as palavras que somente aparecem neles como códigos específicos, por exemplo.
Comentários nos Dicionários
Como a pesquisa somente é feita em linhas com apenas uma palavra, você pode comentar os seus dicionários como desejar.
|
- Códigos especiais
__hc_n
_capa
_comments
_final
_index
// Letras especiais
î
ï
ñ
ò
ó
ô
|
Note que "- Códigos especiais" e "// Letras especiais" não serão pesquisados pois contém espaços.
Palavras do seu documento
São consideradas "palavras do seu documento" os conjuntos de caracteres contíguos da tabela abaixo.
Observe que o caractere "-" faz parte da tabela para "capturar" palavras como self-service, por exemplo. Vale notar que, por essa razão, se ocorrer "-" sozinho (por exemplo "- tópico ...") ele será considerado como uma palavra e, então, "-" deverá ser cadastrado em algum dicionário (sem as aspas, é lógico).
|
Legenda:
|
Palavras com dígitos
Como se observa na tabela acima os dígitos não compõem palavras. Assim, por exemplo, bana3nada será considerada como duas palavras (bana e nada) a serem pesquisadas.
O mesmo ocorre com todos os caracteres que não compõem palavras, mas "embebidos" nas mesmas (por exemplo: bana@nada, bana+;nada, etc).
Conversões parciais
Se você executar o Spell Check antes de converter algum documento não aparecerá nenhuma palavra, pois não existe nenhum documento na memória do programa DMHelp.
Se você iniciar uma conversão e, por exemplo, interrompê-la pressionando a tecla Esc (escape), seu documento ficará "parcialmente" carregado na memória e, somente por isso, se você executar o Spell Check, somente as palavras carregadas serão verificadas.
Palavras "inexistentes"
|
O dia da semana que este manual foi convertido foi: <fi k=DT DTFM={%dddd}>.
|
|
O dia da semana que este manual foi convertido foi: Segunda.
|
No exemplo acima, o resultado exibe o dia da semana por extenso e ele também será pesquisado nos dicionários, mesmo não constando do seu documento.
Assim, caso você perceba que o Spell Check informou uma palavra aparentemente "inexistente" em seu documento, pesquise os comandos que geram palavras (como acima), corrija-os se for o caso (que não é no exemplo acima), ou inclua a palavra indicada em um dos seus dicionários.
Comandos e atributos
Os nomes de comandos, nomes de macros, nomes de página, nomes de atributos, etc. não são pesquisados, ou seja, somente são pesquisadas as palavras que vão aparecer nos arquivos de saída.
Dicionários disponíveis
Em:
...\DMHelp\Dictionaries
existem alguns dicionários à sua disposição.
Vale lembrar que esses dicionários não estão completos pois foram construídos apenas como exemplo.