Ao traduzir documentação técnica (Markdown), como lidar com blocos de código e o Front Matter?
“Se os blocos de código, o código inline e as configurações de cabeçalho (Front Matter) em documentação técnica forem traduzidos à força, a documentação tornar-se-á inutilizável.”
Análise da causa raiz
Mecanismo de “zona de isolamento” dos blocos de código
O sistema identifica automaticamente o conteúdo delimitado por ``` (blocos de código) e ` (código em linha). Estas áreas são marcadas como “zonas não traduzíveis” e a IA ignora esse conteúdo para garantir que a lógica de código Python, JS, etc., não seja afetada.
Proteção dos metadados Front Matter
Para configurações YAML de cabeçalho comuns em blogues estáticos como Jekyll ou Hugo (por exemplo, `date:` ou `slug:`), apenas traduzimos campos específicos como `title` e `description`, preservando os parâmetros de configuração necessários para o processo de construção.
Reorganização adaptativa de tabelas em Markdown
As tabelas em Markdown frequentemente ficam desalinhadas após a tradução devido à alteração do comprimento dos caracteres. O DL.Translator recalcula as posições dos caracteres pipe `|` na etapa de pós-processamento, produzindo código-fonte de tabelas visualmente alinhado e organizado.
Resumo da solução final
Desenvolvido especialmente para a comunidade open source e para developers, garantindo profissionalismo e legibilidade na transição entre diferentes idiomas em ficheiros README.md e tutoriais técnicos.