Como manter a estrita correção da indentação ao traduzir ficheiros de configuração YAML (como documentação Kubernetes/Ansible)?
“O YAML depende da indentação (espaços) para representar hierarquias; qualquer erro de indentação resultará em falha na análise do ficheiro.”
Análise da causa raiz
Proteção rigorosa dos âncoras de espaços
Não apenas traduzimos o texto; também registamos o número de espaços no início de cada linha. Após a tradução, o sistema força a introdução da versão traduzida no respetivo nível de indentação, garantindo que a estrutura sintática da árvore YAML permanece 100% correta.
Tradução e preservação de comentários
Os comentários nos ficheiros de configuração (conteúdo após o #) são fundamentais para a compreensão da configuração. O utilizador pode optar por traduzir estes comentários para facilitar a compreensão da equipa, mantendo as chaves de configuração (Key) inalteradas.
Suporte para múltiplos fluxos de documentos
Para ficheiros YAML únicos que contêm vários documentos (separados por `---`), o sistema identifica os separadores e processa cada bloco individualmente, sem confundir o conteúdo de diferentes módulos.
Resumo da solução final
A localização de documentação técnica de configuração deixa de ser um pesadelo para as equipas de operações, garantindo que scripts de implementação sejam utilizáveis globalmente.