aspell - manual de referência, opções, exemplos de comandos


NOME

aspell - corretor ortográfico interativo

SINOPSE

aspell [options] <command>

DESCRIÇÃO

aspell é um programa utilitário que se conecta à biblioteca Aspell para que possa funcionar como um substituto ispell -a, como um verificador ortográfico independente, como um utilitário de teste para testar Recursos da biblioteca Aspell e como um utilitário para gerenciar os dicionários usados pela biblioteca.

A biblioteca Aspell contém uma interface que permite a outros programas acesso direto às suas funções e, portanto, reduz a complexa tarefa de verificação ortográfica a simples chamadas de biblioteca. A biblioteca padrão não contém listas de palavras do dicionário. Para adicionar dicionários de idiomas, verifique primeiro sua distro em busca de dicionários modificados, caso contrário, procure aqui os dicionários de idiomas básicos http://aspell.net.

As informações a seguir descrevem os comandos e opções usados pelo Aspell Utility.

Esta página de manual é mantida separadamente da documentação oficial, portanto pode estar desatualizada ou incompleta. A documentação oficial é mantida como um manual Texinfo. Veja a entrada ` aspell ' em info para uma documentação mais completa.

COMANDOS

<command> é um dos seguintes:

usage, -?

Envie uma breve mensagem de uso do Aspell Utility para a saída padrão. Este é um breve resumo listando comandos e opções de verificação ortográfica mais comuns.

help

Envie uma mensagem de ajuda detalhada do Aspell Utility para a saída padrão. Esta é uma lista completa mostrando todos os comandos, opções, filtros e dicionários.

version, -v

Imprima o número da versão da biblioteca e utilitário Aspell na saída padrão.

check <file>, -c <file>

Verifique a ortografia de um único arquivo.

pipe, -a

Execute o Aspell no modo de compatibilidade ispell -a.

list

Produzir uma lista de palavras com erros ortográficos a partir da entrada padrão.

[dump] config

Despeje todas as opções de configuração atuais para a saída padrão.

config <key>

Envie o valor atual de <key> para a saída padrão.

soundslike

Emita o equivalente sonoro de cada palavra inserida.

munch

Gere possíveis palavras de raiz e afixos de uma lista de entrada de palavras.

expand [1-4]

Expande os sinalizadores de afixo de cada palavra compactada de afixo inserida.

clean [strict]

Limpa uma lista de palavras de entrada para que cada linha seja uma palavra válida.

munch-list [simple] [single|multi] [keep]

Reduza o tamanho de uma lista de palavras por meio da compactação de afixos.

conv <from> <to> [<norm-form>]

Converte <from> uma codificação <to> em outra.

norm (<norm-map>|<from> <norm-map> <to>) [<norm-form>]

Execute a normalização Unicode.

[dump] dicts|filters|modes

Lista os dicionários, filtros ou modos disponíveis.

dump|create|merge master|personal|repl <wordlist>

despejar, criar ou mesclar uma lista de palavras mestre, pessoal ou de substituição.

OPÇÕES DE DICIONÁRIO

As opções a seguir podem ser usadas para controlar quais dicionários usar e como eles se comportam.

--master=<name>, -d <name>

Nome base do dicionário a ser usado. Se esta opção for especificada, o Aspell usará este dicionário ou morrerá.

--dict-dir=<directory>

Localização da lista de palavras do dicionário principal.

--lang=<string>, -l <string>

Linguagem a ser usada. Segue o mesmo formato da variável de ambiente LANG na maioria dos sistemas. Ele consiste no código de idioma ISO 639 de duas letras e um código de país ISO 3166 opcional de duas letras após um traço ou sublinhado. O valor padrão é baseado no valor da localidade LC_MESSAGES.

--size=<string>

O tamanho preferencial da lista de palavras do dicionário. Isso consiste em um código de dois dígitos descrevendo o tamanho da lista, com valores típicos de: 10=minúsculo, 20=muito pequeno, 30=pequeno, 40=médio-pequeno, 50=médio, 60=médio-grande, 70 =grande, 80=enorme, 90=insano.

--variety=<string>

Qualquer informação extra para distinguir esta variedade de dicionário de outros dicionários que podem ter o mesmo idioma e tamanho.

--jargon=<string>

Use a opção variedade, pois ela substitui o jargão como uma escolha melhor. jargão será removido no futuro.

--word-list-path=<list of directories>

Caminho de pesquisa para arquivos de informações da lista de palavras.

--personal=<file>, -p <file>

Nome de arquivo de lista de palavras pessoais.

--repl=<file>

Nome do arquivo da lista de substituições.

--extra-dicts=<list>

Dicionários extras para usar.

--ignore-accents

Esta opção ainda não está implementada.

VERIFICAR OPÇÕES

Essas opções controlam o comportamento do Aspell ao verificar documentos.

--ignore=<integer>, -W <integer>

Ignore palavras <= <integer> caracteres de comprimento.

--ignore-case, --dont-ignore-case

Ignore maiúsculas e minúsculas ao verificar palavras.

--ignore-repl, --dont-ignore-repl

Ignore os comandos para armazenar pares de substituição.

--save-repl, --dont-save-repl

Salve a lista de palavras de substituição em salvar tudo.

--sug-mode=<mode>

Sugestão <mode>=ultra|rápido|normal|maus ortógrafos

OPÇÕES DE FILTRO

Essas opções modificam o comportamento dos vários filtros.

--add-filter=<list>, --rem-filter=<list>

Adicione ou remova um filtro.

--add-filter-path=<paths>, --rem-filter-path=<paths>

Adicione ou remova caminhos pesquisados por filtros.

--mode=<string>, -e, -H, -t, -n

Define o modo de filtro. Mode é nenhum, url, email, html, tex ou nroff. As opções alternativas de atalho são '-e' para e-mail, '-H' para Html/Sgml, '-t' para Tex ou '-n' para Nroff.

--encoding=<string>

espera-se que a codificação do documento esteja. O padrão depende da localidade atual.

--add-email-quote=<list>, --rem-email-quote=<list>

Adicione ou remova uma lista de caracteres de citação de e-mail.

--email-margin=<integer>

Número de caracteres que podem aparecer antes do caractere de aspas.

--add-html-check=<list>, --rem-html-check=<list>

Adicione ou remova uma lista de atributos HTML para verificar sempre. Por exemplo, olhe dentro das tags alt=.

--add-html-skip=<list>, --rem-html-skip=<list>

Adicione ou remova uma lista de atributos HTML para sempre ignorar durante a verificação ortográfica.

--add-sgml-check=<list>, --rem-sgml-check=<list>

Adicione ou remova uma lista de atributos SGML para sempre verificar a ortografia.

--add-sgml-skip=<list>, --rem-sgml-skip=<list>

Adicione ou remova uma lista de atributos SGML para sempre ignorar durante a verificação ortográfica.

--sgml-extension=<list>

Extensões de arquivo SGML.

--tex-check-comments, --dont-tex-check-comments

Verifique os comentários do TeX.

--add-tex-command=<list>, --rem-tex-command=<list>

Adicione ou remova uma lista de comandos TeX.

OPÇÕES DE PALAVRAS CONJUNTAS

Estes podem ser usados para controlar o comportamento de palavras run-together.

--run-together, --dont-run-together, -C, -B

Considere palavras combinadas válidas.

--run-together-limit=<integer>

Número máximo de palavras que podem ser agrupadas.

--run-together-min=<integer>

Comprimento mínimo de palavras interiores.

OPÇÕES DIVERSAS

Opções diversas que não se enquadram em nenhuma outra categoria.

--conf=<file name>

Arquivo de configuração principal. Este arquivo substitui os padrões globais do Aspell.

--conf-dir=<directory>

Localização do arquivo de configuração principal.

--data-dir=<directory>

Localização dos arquivos de dados de idioma.

--keyboard=<keyboard>

Use este layout de teclado para sugerir possíveis palavras. Esses erros de ortografia acontecem se um usuário acidentalmente pressiona uma tecla ao lado da tecla correta pretendida.

--local-data-dir=<directory>

Localização alternativa de arquivos de dados de idioma. Este diretório é pesquisado antes de data-dir.

--home-dir=<directory>

Local do diretório para arquivos pessoais de lista de palavras.

--per-conf=<file name>

Arquivo de configuração pessoal. Este arquivo substitui as opções encontradas no arquivo de configuração global.

OPÇÕES DE UTILIDADES ASPELL

Essas opções fazem parte do Utilitário aspell e funcionam independentemente da biblioteca.

--backup, --dont-backup, -b, -x

O utilitário aspell cria um arquivo de backup fazendo uma cópia e anexando .bak ao nome do arquivo. Isso se aplica apenas quando o comando é check e o arquivo de backup é criado apenas se ocorrer alguma modificação ortográfica.

--byte-offsets, --dont-byte-offsets

Use deslocamentos de bytes em vez de deslocamentos de caracteres.

--guess, --dont-guess, -m, -P

Crie combinações de raiz/afixo ausentes que não estejam no dicionário no modo pipe.

--keymapping=aspell, --keymapping=ispell

O mapeamento de teclas a ser usado, aspell para o mapeamento padrão ou ispell para usar o mesmo mapeamento que o utilitário Ispell usa.

--reverse, --dont-reverse

Inverta a ordem da lista de sugestões no modo pipe.

--suggest, --dont-suggest

Sugira possíveis substituições no modo de tubo. Se falso, Aspell simplesmente relatará o erro ortográfico e não fará nenhuma tentativa de sugestões ou possíveis correções.

--time, --dont-time

Cronometre o tempo de carregamento e sugira um tempo no modo pipe.

Além disso, o Aspell tentará entender as opções de linha de comando do Ispell para que ele possa funcionar como um substituto para o Ispell. Se o Aspell for executado sem nenhuma opção de linha de comando, ele exibirá uma breve tela de ajuda e sairá.

CONFIGURAÇÃO

Aspell pode aceitar opções por meio de arquivos de configuração globais ou pessoais para que você não precise especificá-los toda vez na linha de comando. O arquivo de configuração global padrão é /etc/aspell.conf ou outro arquivo especificado pela opção --conf e é verificado primeiro. O arquivo de configuração padrão por usuário ~/.aspell.conf localizado no diretório $HOME (ou outro arquivo especificado pela opção --per-conf ) é verificado em seguida e substitui as opções definidas no arquivo de configuração global. As opções especificadas na linha de comando ou por meio de uma variável de ambiente substituem as especificadas por qualquer um dos arquivos de configuração.

Cada linha do arquivo de configuração tem o formato:

option [value]

onde opção é qualquer uma das opções de biblioteca padrão acima sem os hífens iniciais. Por exemplo, a linha a seguir definirá o idioma padrão para o alemão suíço:

lang de_CH

Pode haver qualquer número de espaços entre a opção e o valor, porém só pode haver espaços, ou seja, não há '=' entre o nome da opção e o valor. Os comentários também podem ser incluídos precedendo-os com um '#', pois qualquer coisa entre um '#' e uma nova linha é ignorada. Linhas em branco também são permitidas. O arquivo /etc/aspell.conf é um bom exemplo de como definir essas opções e o Manual do Aspell tem informações mais detalhadas.

VEJA TAMBÉM

aspell-import(1), prezip-bin(1), run-with-aspell(1), word-list-compress(1)

Aspell is fully documented in its Texinfo manual. See the ` aspell ' entry in info for more complete documentation.

APOIAR

O suporte para Aspell pode ser encontrado nas listas de discussão do Aspell. Instruções para ingressar nas várias listas de discussão (e um arquivo delas) podem ser encontradas na página inicial da Aspell em http://aspell.net. Os relatórios de bugs devem ser enviados por meio do GitHub Issues, em vez de serem postados nas listas de discussão.

AUTOR

Esta página de manual foi escrita por Brian Nelson pyro@debian.org baseado no Aspell User's Manual, Copyright © 2002 Kevin Atkinson. Atualizado em novembro de 2006 por Jose Da Silva digital@joescat.com e em dezembro de 2006 por Kevin Atkinson kevina@gnu.org.