preconv - Online na nuvem

PROGRAMA:

NOME

preconv - converte a codificação de arquivos de entrada para algo que GNU troff entende

SINOPSE

pré-conv [-dr.] [-e codificação] [arquivos ...]
pré-conv -h | --Socorro
pré-conv -v | --versão

É possível ter espaços em branco entre os -e opção de linha de comando e seu parâmetro.

DESCRIÇÃO

pré-conv lê arquivos e converte sua (s) codificação (ões) em um formato GNU troff(1) pode processar,
enviar os dados para a saída padrão. Atualmente, isso significa caracteres ASCII e
'\ [uXXXX]' entidades, onde 'XXXX' é um número hexadecimal com quatro a seis dígitos,
representando um código de entrada Unicode. Normalmente, pré-conv deve ser invocado com o -k e -K
opções de Groff.

OPÇÕES

-d Emita mensagens de depuração para erro padrão (principalmente a codificação usada).

-Dcodificação
Especifique a codificação padrão se tudo falhar (veja abaixo).

-ecodificação
Especifique a codificação de entrada explicitamente, substituindo todos os outros métodos. Isso corresponde
para Groff's -Kcodificação opção. Sem esta opção, pré-conv usa o algoritmo
descrito abaixo para selecionar a codificação de entrada.

--Socorro
-h Imprimir mensagem de ajuda.

-r Não adicione solicitações .lf.

--versão
-v Imprimir o número da versão.

USO

pré-conv tenta encontrar a codificação de entrada com o seguinte algoritmo.

1. Se a codificação de entrada foi explicitamente especificada com a opção -e, use-o.

2. Caso contrário, verifique se a entrada começa com um Byte Order Mark (BOM, veja abaixo).
Se encontrado, use-o.

3. Finalmente, verifique se há um conhecido codificação etiqueta (veja abaixo) no primeiro
ou segunda linha de entrada. Se encontrado, use-o.

4. Se tudo falhar, use uma codificação padrão fornecida com a opção -D, pela corrente
locale ou 'latin1' se o local estiver definido como 'C', 'POSIX' ou vazio (nessa ordem).

Observe que o Groff programa suporta um GROFF_ENCODING variável de ambiente que é
eventualmente expandido para opção -k.

Byte Order Mark
O padrão Unicode define o caractere U + FEFF como a marca de ordem de bytes (BOM). No outro
Por outro lado, o valor U + FFFE não é garantidamente um caractere Unicode. Isso permite detectar
a ordem de bytes dentro do fluxo de dados (big-endian ou low-endian), e o MIME
as codificações 'UTF-16' e 'UTF-32' exigem que o fluxo de dados comece com U + FEFF.
Da mesma forma, o fluxo de dados codificado como 'UTF-8' pode começar com um BOM (para facilitar o
conversão de e para UTF-16 e UTF-32). Em todos os casos, a marca de ordem de byte é não parte
dos dados, mas parte do protocolo de codificação; em outras palavras, pré-conva saída de não
contê-lo.

Observe que U + FEFF não no início dos dados de entrada realmente são emitidos; tem então o
significado de um caractere de 'espaço sem quebra de largura zero' - algo não necessário normalmente em
Groff.

Codificação Tags
Editores que suportam mais de uma codificação de caractere precisam de tags na entrada
arquivos para marcar a codificação do arquivo. Embora seja possível adivinhar a codificação de entrada correta
com a ajuda de algoritmos heurísticos para dados que representam uma maior quantidade de
linguagem natural, ainda é apenas um palpite. Além disso, todos os algoritmos falham facilmente para
entrada que é muito curta ou não representa uma linguagem natural.

Por estas razões, pré-conv suporta a convenção de tag de codificação (com algumas restrições) como
utilizado pelo GNU Emacs e XEmacsGenericName (e provavelmente outros programas também).

Tags de codificação em GNU Emacs e XEmacsGenericName são armazenados nos chamados Envie o Variáveis. pré-conv
reconhece a seguinte forma de sintaxe que deve ser colocada em um comentário troff no primeiro
ou segunda linha.

- * - tag1: value1; tag2: value2; ... - * -

A única tag relevante para pré-conv é 'codificação' que pode assumir os valores listados abaixo.
Aqui está um exemplo de linha que diz Emacs para editar um arquivo no modo troff e usar o latin2 como
sua codificação.

. \ "- * - modo: troff; codificação: latin-2 - * -

A lista a seguir fornece todas as tags de codificação MIME (minúsculas ou maiúsculas) suportadas por
pré-conv; esta lista está embutida em código na fonte.

big5, cp1047, euc-jp, euc-kr, gb2312, iso-8859-1, iso-8859-2, iso-8859-5,
iso-8859-7, iso-8859-9, iso-8859-13, iso-8859-15, koi8-r, us-ascii, utf-8, utf-16,
utf-16be, utf-16le

Além disso, a seguinte lista codificada de outras tags é reconhecida, o que eventualmente
mapear para valores da lista acima.

ascii, chinês-big5, chinês-euc, chinês-iso-8 bits, cn-big5, cn-gb, cn-gb-2312,
cp878, csascii, csisolatin1, cirílico-iso-8bit, cirílico-koi8, euc-china, euc-cn,
euc-japão, euc-japan-1990, euc-coreia, grego-iso-8bit, iso-10646 / utf8,
iso-10646 / utf-8, iso-latin-1, iso-latin-2, iso-latin-5, iso-latin-7, iso-latin-9,
japonês-euc, japonês-iso-8bit, jis8, koi8, coreano-euc, coreano-iso-8bit, latin-0,
latin1, latin-1, latin-2, latin-5, latin-7, latin-9, mule-utf-8, mule-utf-16,
mule-utf-16be, mule-utf-16-be, mule-utf-16be-com-assinatura, mule-utf-16le,
mule-utf-16-le, mule-utf-16le-com-assinatura, utf8, utf-16-be,
utf-16-estar-com-assinatura, utf-16-estar-com-assinatura, utf-16-le,
utf-16-le-com-assinatura, utf-16-le-com-assinatura

Essas marcas são tiradas de GNU Emacs e XEmacsGenericName, junto com alguns apelidos. Seguindo
'-dos', '-unix' e '-mac' sufixos de tags de codificação (que fornecem a convenção de fim de linha
usados ​​no arquivo) são retirados antes que a comparação com as tags acima aconteça.

Iconv Temas
pré-conv por si só suporta apenas três codificações: latin-1, cp1047 e UTF-8; todos os outros
codificações são passadas para o iconv funções de biblioteca. Em tempo de compilação, é pesquisado e
verificado para um válido iconv implementação; uma chamada para 'prév --version' mostra se
iconv é usado.

Use o preconv online usando serviços onworks.net