Hogyan őrizhető meg a szigorú behúzás a YAML konfigurációs fájlok (például Kubernetes vagy Ansible dokumentációk) fordítása során?
“A YAML a behúzásra (szóközökre) épít a hierarchia ábrázolásához; bármilyen behúzási hiba a fájl feldolgozásának sikertelenségét eredményezi.”
Kiváltó ok elemzése
Szigorú szóköz-ankhorgony védelem
Nemcsak a szöveget fordítjuk, hanem minden sor elején rögzítjük a szóközök számát. A fordítás befejezése után a rendszer kötelezően visszahelyezi a lefordított szöveget a megfelelő behúzási szintre, ezzel 100%-ban garantálja a YAML szintaxisfa helyes szerkezetét.
Megjegyzések fordítása és megtartása
A konfigurációs fájlokban szereplő megjegyzések (# utáni tartalom) kulcsfontosságúak a konfiguráció megértéséhez. A felhasználók választhatják ezen megjegyzések lefordítását a csapat jobb megértése érdekében, miközben a konfigurációs kulcsokat (Key) változatlanul hagyják.
Többdokumentum-folyam támogatása
Az olyan YAML fájlok esetében, amelyek több dokumentumot tartalmaznak (`---` elválasztóval), a rendszer felismeri az elválasztókat, és külön kezeli az egyes blokkokat, így a különböző modulok tartalma nem keveredik össze.
Végső megoldás összefoglalója
A technikai konfigurációs dokumentációk lokalizációja többé nem üzemeltetői rémálom, így a telepítési szkriptek világszerte egységesen használhatók.