Como manter a estrita correção da indentação ao traduzir ficheiros de configuração YAML (como documentação Kubernetes/Ansible)?
“O YAML utiliza a indentação (espaços) para representar a hierarquia. As alterações na indentação podem causar falhas de análise ou modificar a estrutura hierárquica.”
Análise da causa raiz
Análise da estrutura YAML e verificação da saída
O processo atual trata a estrutura do documento com um analisador YAML, extrai comentários e valores de texto traduzíveis e volta a serializar a saída. A indentação e os espaços em branco podem diferir do ficheiro original. Antes da implementação, verifique a estrutura, os marcadores de posição e o significado da configuração.
Tradução e preservação de comentários
Os comentários no ficheiro de configuração (o conteúdo após #) ajudam a compreender a configuração. O processo atual extrai comentários e valores de texto traduzíveis. Verifique a tradução antes de utilizar e confirme que os nomes das chaves de configuração (Key) e o significado da configuração correspondem ao esperado.
Suporte para fluxos com múltiplos 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.