Jak zajistit striktní správnost odsazení při překladu YAML konfiguračních souborů (například dokumentace Kubernetes/Ansible)?
“YAML závisí na odsazení (mezerách) pro vyjádření hierarchie, jakákoli chyba v odsazení vede k chybě při analýze souboru.”
Analýza hlavní příčiny
Přísná ochrana kotev mezer
Nejenže překládáme samotný text, ale současně zaznamenáváme počet mezer na začátku každého řádku. Po dokončení překladu systém povinně vrací překlad zpět na odpovídající úroveň odsazení, aby byla struktura YAML syntaktického stromu 100% správná.
Překlad a zachování komentářů
Komentáře v konfiguračních souborech (obsah za znakem #) jsou zásadní pro pochopení konfigurace. Uživatel může zvolit překlad těchto komentářů pro lepší porozumění v týmu, přičemž konfigurační klíče (Key) zůstanou nezměněny.
Podpora vícedokumentových toků
U YAML souborů obsahujících více dokumentů (oddělených pomocí `---`) systém rozpozná oddělovače a každý blok zpracuje samostatně, takže nedochází k záměně obsahu různých modulů.
Shrnutí konečného řešení
Lokalizace technických konfiguračních dokumentů už není provozní noční můrou a zajišťuje globální použitelnost nasazovacích skriptů.