Plugin Codificação¶
Um menu Codificação para reler um arquivo em outra codificação de caracteres, ou para convertê-lo para uma. O editor trabalha internamente em UTF-8; este plugin decide como os bytes de um arquivo se mapeiam de e para isso.
Seu arquivo mantém a codificação dele¶
O OctoEdit detecta a codificação de um arquivo quando o abre e grava a mesma
codificação de volta a cada salvamento. Um arquivo UTF-8 com marca de ordem de
bytes mantém o BOM, um arquivo UTF-16 continua UTF-16, e um arquivo na página de
código ANSI do sistema não é promovido silenciosamente a UTF-8 na primeira vez que
você pressiona Ctrl+S.
A codificação pertence ao documento, não a este plugin: o menu abaixo a mostra e a altera, e quem grava é o núcleo do editor. É também por isso que uma conversão recebe o mesmo tratamento de qualquer outro salvamento — a gravação é atômica, o backup ao salvar se aplica, e o monitor de arquivos sabe que a alteração foi sua.
Um .editorconfig de projeto com um charset ainda vence: essa é uma decisão que
você registrou para o projeto inteiro, e ela substitui o que os bytes de um arquivo
específico por acaso diziam. Depois de um salvamento assim, o documento reporta
aquele charset como sua codificação, então o menu e a barra de status nomeiam o que
realmente está no disco.
Dois tipos de comando¶
A distinção importa — um muda a interpretação, o outro muda com o que o arquivo será salvo:
| Família | Menu | O que faz |
|---|---|---|
| Interpretar como | Codificação ▸ <encoding> e Codificação ▸ Conjuntos de caracteres ▸ <set> |
Relê os bytes do arquivo do disco e os decodifica com a codificação escolhida, substituindo o buffer, e registra aquela codificação no documento. Use quando um arquivo abrir com caracteres ilegíveis. O arquivo no disco fica intocado até você salvar. |
| Converter para | Codificação ▸ Converter para <encoding> |
Marca o documento como "a ser salvo nesta codificação" e o marca como modificado. Nenhum byte é gravado ainda — salve o documento para aplicar a conversão, ou feche-o sem salvar para abandoná-la. |
A codificação que o documento ativo usa no momento aparece marcada no menu, na
lista de primeiro nível para as entradas Unicode/ANSI e dentro de Codificação ▸
Conjuntos de caracteres para as legadas. A marca acompanha a aba ativa, então
trocar de documento diz num relance o que cada um é.
A barra de status nomeia a mesma codificação em um segmento próprio (UTF-8,
UTF-8-BOM, ANSI, Windows-1250, …) e também acompanha o documento ativo — para
que você veja o que um arquivo é sem abrir o menu.
Codificações disponíveis¶
- Unicode: UTF-8, UTF-8-BOM, UTF-16 LE BOM, UTF-16 BE BOM.
- ANSI — a página de código local de um byte do sistema.
- Submenu Conjuntos de caracteres — os conjuntos legados agrupados por idioma: árabe, báltico, celta, europeu central, chinês, cirílico, europeu oriental, grego, hebraico, japonês, coreano, europeu do norte, tailandês, turco, vietnamita e europeu ocidental.
Converter para oferece os cinco principais Unicode/ANSI. Uma página de código legada é alcançável por Interpretar como, e um documento lido assim é gravado de volta naquela mesma página de código.
Consertando um arquivo ilegível
Se um arquivo abre como algo sem sentido, tente Interpretar como com a codificação que você espera (por exemplo, um conjunto de caracteres legado). Quando ele for lido corretamente, use Converter para UTF-8 e salve, para armazená-lo em uma codificação moderna e portátil.