Converter TXT para CFG

Um jogo, router, aplicação ou dispositivo incorporado pode rejeitar um ficheiro de definições, a menos que o nome termine em .cfg. Normalmente, basta mudar o nome de um ficheiro de configuração de texto simples válido; as notas comuns continuam a exigir uma reescrita para corresponder à sintaxe do software de destino.

O que é o formato TXT

.txt identifica texto simples, não uma estrutura de dados específica. Notepad, TextEdit, editores Linux, editores de código, scripts e ferramentas de exportação criam ficheiros TXT que contêm notas, registos, tabelas ou diretivas de configuração. A extensão não indica a codificação de caracteres, a convenção de fim de linha ou a sintaxe do conteúdo.

O que é o formato CFG

.cfg é uma convenção de nomes de ficheiros para dados de configuração, não um formato universal. Um programa pode exigir pares chave-valor, como fullscreen=true, secções no estilo INI, como [network], definições separadas por dois-pontos, objetos semelhantes a JSON ou uma linguagem de comandos específica do fornecedor.

Os ficheiros CFG permitem que o software carregue definições a partir de uma localização conhecida, mantendo-se editáveis num editor de texto simples. A documentação do programa de destino define os nomes de parâmetros, separadores, cabeçalhos de secção, comentários, utilização de aspas, valores booleanos, codificação e fins de linha válidos. Um ficheiro cujo nome foi alterado só pode ser utilizado quando o conteúdo já segue essas regras.

Como criar um ficheiro CFG

1. Faça uma cópia de segurança da origem. Copie o ficheiro TXT original antes de alterar o nome ou o conteúdo.
2. Inspecione a sintaxe. Abra o ficheiro no Notepad++ no Windows, no Visual Studio Code no Windows, macOS ou Linux, ou noutro editor de texto simples. Não utilize o Microsoft Word ou outro editor de rich text, que pode inserir formatação e caracteres incompatíveis.
3. Compare-o com o exemplo da aplicação de destino. Corrija os nomes dos parâmetros, separadores, cabeçalhos de secção, caminhos, comentários, capitalização, utilização de aspas e tipos de valores. Por exemplo, fullscreen: yes não é equivalente a fullscreen=true, a menos que a aplicação documente essa sintaxe.
4. Guarde uma cópia de texto simples. Utilize File → Save As, introduza um nome como settings.cfg e selecione UTF-8 apenas se o software recetor o suportar. No Notepad++, utilize Encoding → Convert to UTF-8 quando a codificação de origem não for adequada e, em seguida, guarde a cópia.
5. Verifique a extensão. No Explorador de Ficheiros do Windows, ative View → Show → File name extensions. Confirme que o ficheiro é settings.cfg, e não settings.cfg.txt.
6. Instale-o e teste-o. Coloque o ficheiro no diretório especificado na documentação do programa ou dispositivo. Inicie o software, verifique o respetivo registo de erros e restaure a cópia de segurança se for comunicada uma linha inválida ou se as definições forem repostas.

Se o conteúdo já for válido para o programa de destino, basta mudar o nome. No Linux ou macOS, execute:

mv settings.txt settings.cfg

Na Linha de Comandos do Windows, execute:

ren settings.txt settings.cfg

Para vários ficheiros no PowerShell, utilize:

Get-ChildItem *.txt | Rename-Item -NewName { $_.BaseName + '.cfg' }

Estes comandos alteram apenas os nomes dos ficheiros; não traduzem o conteúdo TXT para uma linguagem de configuração diferente.

Ferramentas online e para desktop

Notepad++, Visual Studio Code e outros editores locais de texto simples são as opções mais seguras, porque preservam o ficheiro como texto e permitem verificar a codificação e os fins de linha. Serviços online gerais, como CloudConvert ou Convertio, podem ser considerados para um ficheiro não sensível apenas se a lista atual de formatos indicar explicitamente que suportam a conversão de texto solicitada, mas não conseguem inferir a sintaxe CFG proprietária de um programa. Não carregue ficheiros que contenham palavras-passe, chaves de API, credenciais de dispositivos, endereços privados ou outras definições confidenciais.

Verificações de qualidade e compatibilidade

Não existe uma conversão universal de TXT para CFG, porque CFG não tem uma especificação única. Alterar o nome de um documento, registo ou ficheiro de texto não relacionado não cria dados de configuração válidos, e convertê-lo para JSON, YAML, XML ou INI só está correto quando a aplicação de destino suporta essa linguagem.

Preserve os comentários, a indentação, a capitalização, as aspas e as linhas em branco necessários. Verifique a definição de fim de linha do editor quando o software for antigo ou sensível à plataforma: LF é o padrão no Linux e macOS, enquanto muitos programas do Windows utilizam CRLF. O Visual Studio Code disponibiliza esta definição através de View → Command Palette → Change End of Line Sequence. Incompatibilidades de codificação podem produzir caracteres corrompidos ou fazer com que um dispositivo rejeite o ficheiro; por isso, siga a codificação documentada pela aplicação de destino em vez de presumir UTF-8.