Як забезпечити сувору цілісність відступів під час перекладу YAML-файлів конфігурацій (наприклад, документації Kubernetes/Ansible)?
“YAML використовує відступи (пробіли) для позначення ієрархії; будь-яка помилка у відступах призводить до помилок при розборі файлу.”
Аналіз основних причин
Суворий захист пробілів якорями
Ми не лише перекладаємо текст, а й фіксуємо кількість пробілів перед кожним рядком. Після завершення перекладу система примусово розміщує переклад у відповідний рівень відступу, забезпечуючи 100% правильність структури синтаксичного дерева YAML.
Переклад і збереження коментарів
Коментарі у конфігураційних файлах (зміст після #) є ключовими для розуміння налаштувань. Користувач може обрати переклад цих коментарів для кращого розуміння командою, при цьому ключі конфігурації (Key) залишаються незмінними.
Підтримка багатопоточних документів
У випадку одного YAML-файлу, що містить кілька документів (розділених за допомогою `---`), система розпізнає роздільники та обробляє кожен блок окремо, не змішуючи вміст різних модулів.
Підсумок остаточного рішення
Локалізація технічної конфігураційної документації більше не є проблемою для адміністрування — розгортання сценаріїв гарантується як глобально сумісне.