Как да се запази стриктността на отстъпите при превод на YAML конфигурационни файлове (например документация за Kubernetes/Ansible)?
“YAML разчита на отстъпите (интервали), за да обозначава йерархията – всяка грешка в отстъпите води до неуспешно парсиране на файла.”
Анализ на основната причина
Строга защита чрез фиксиране на интервалите
Ние не просто превеждаме текста – записваме и броя на интервалите пред всеки ред. След приключване на превода системата задължително възстановява преведения текст към съответното ниво на отстъп, за да осигури 100% коректна структура на синтактичното дърво на YAML.
Превод и запазване на коментари
Коментарите в конфигурационните файлове (съдържанието след #) са от ключово значение за разбирането на конфигурацията. Потребителите могат да изберат да преведат тези коментари за по-добро разбиране от екипа, като същевременно запазват ключовете (Key) на конфигурацията непроменени.
Поддръжка на множество документи
При YAML файлове с няколко документа (разделени с `---`), системата разпознава разделителите и обработва всеки блок поотделно, без да смесва съдържанието на различните модули.
Обобщение на крайното решение
Локализацията на технически конфигурационни документи вече не е DevOps кошмар – гарантира се световната приложимост на deployment скриптовете.