Převod souboru TXT do CFG

Hra, router, aplikace nebo embedded device může odmítnout soubor s nastavením, pokud jeho název nekončí na .cfg. Přejmenování platného plain-text konfiguračního souboru je obvykle dostačující; běžné poznámky je stále nutné přepracovat tak, aby odpovídaly syntaxi cílového softwaru.

Co je formát TXT

.txt označuje plain text, nikoli konkrétní datovou strukturu. Notepad, TextEdit, Linux editors, code editors, scripts a export tools vytvářejí TXT soubory obsahující poznámky, logy, tabulky nebo konfigurační direktivy. Přípona neudává kódování znaků, konvenci konců řádků ani syntaxi obsahu.

Co je formát CFG

.cfg je konvence pojmenování souborů s konfiguračními daty, nikoli univerzální formát. Program může vyžadovat dvojice klíč–hodnota, například fullscreen=true, sekce ve stylu INI, například [network], nastavení oddělená dvojtečkou, objekty podobné JSON nebo jazyk příkazů specifický pro daného výrobce.

Soubory CFG umožňují softwaru načítat nastavení ze známého umístění a zároveň je upravovat v plain-text editoru. Dokumentace cílového programu definuje platné názvy parametrů, oddělovače, záhlaví sekcí, komentáře, uvozování, Boolean hodnoty, kódování a konce řádků. Přejmenovaný soubor je použitelný pouze tehdy, pokud jeho obsah již těmto pravidlům odpovídá.

Jak vytvořit soubor CFG

1. Zálohujte zdroj. Před změnou názvu nebo obsahu zkopírujte původní TXT soubor.
2. Zkontrolujte syntaxi. Otevřete soubor v Notepad++ v Windows, Visual Studio Code ve Windows, macOS nebo Linuxu, případně v jiném plain-text editoru. Nepoužívejte Microsoft Word ani jiný rich-text editor, který může vložit formátování a nekompatibilní znaky.
3. Porovnejte jej s příkladem cílové aplikace. Opravte názvy parametrů, oddělovače, záhlaví sekcí, cesty, komentáře, velikost písmen, uvozování a typy hodnot. Například fullscreen: yes není ekvivalentní k fullscreen=true, pokud aplikace tuto syntaxi neuvádí v dokumentaci.
4. Uložte plain-text kopii. Použijte File → Save As, zadejte název, například settings.cfg, a vyberte UTF-8 pouze v případě, že jej přijímající software podporuje. V Notepad++ použijte Encoding → Convert to UTF-8, pokud zdrojové kódování není vhodné, a poté kopii uložte.
5. Ověřte příponu. V Windows File Exploreru povolte View → Show → File name extensions. Zkontrolujte, že se soubor jmenuje settings.cfg, nikoli settings.cfg.txt.
6. Nainstalujte jej a otestujte. Umístěte soubor do adresáře určeného v dokumentaci programu nebo zařízení. Spusťte software, zkontrolujte jeho error log a obnovte zálohu, pokud ohlásí neplatný řádek nebo obnoví výchozí nastavení.

Pokud je obsah již platný pro cílový program, stačí přejmenování. V Linuxu nebo macOS spusťte:

mv settings.txt settings.cfg

Ve Windows Command Prompt spusťte:

ren settings.txt settings.cfg

Pro více souborů v PowerShellu použijte:

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

Tyto příkazy mění pouze názvy souborů; nepřekládají obsah TXT do jiného konfiguračního jazyka.

Online a desktop tools

Notepad++, Visual Studio Code a další lokální plain-text editors jsou nejbezpečnější volbou, protože zachovávají soubor jako text a umožňují kontrolovat kódování a konce řádků. Obecné online services, jako CloudConvert nebo Convertio, lze zvážit pouze u necitlivého souboru a jen tehdy, pokud jejich aktuální seznam formátů výslovně podporuje požadovanou textovou konverzi; nedokážou však odvodit proprietární syntaxi CFG daného programu. Nenahrávejte soubory obsahující hesla, API keys, přihlašovací údaje zařízení, soukromé adresy ani jiná důvěrná nastavení.

Kontroly kvality a kompatibility

Neexistuje univerzální konverze TXT na CFG, protože CFG nemá jedinou specifikaci. Přejmenováním dokumentu, logu nebo nesouvisejícího textového souboru nevzniknou platná konfigurační data a převod do JSON, YAML, XML nebo INI je správný pouze tehdy, když cílová aplikace daný jazyk podporuje.

Zachovejte požadované komentáře, odsazení, velikost písmen, uvozovky a prázdné řádky. Pokud je software starý nebo citlivý na platformu, zkontrolujte nastavení konců řádků v editoru: LF je standardem v Linuxu a macOS, zatímco mnoho programů ve Windows používá CRLF. Visual Studio Code toto nastavení zpřístupňuje prostřednictvím View → Command Palette → Change End of Line Sequence. Nesoulad kódování může způsobit zkomolení znaků nebo vést k odmítnutí souboru zařízením, proto postupujte podle zdokumentovaného kódování cílové aplikace a nepředpokládejte automaticky UTF-8.