---
title: "Traduzir arquivos YAML e TOML"
description: "Traduza arquivos .yaml, .yml e .toml de até 4 MB para um ou vários idiomas. As chaves, a hierarquia e a ordem permanecem intactas. Exemplos de instruções para Rails, Hugo e arquivos de configuração."
canonical: "https://ai-glot.com/docs/pt/formats/yaml-and-toml"
updated: "2026-10-12"
---

# Traduzir arquivos YAML e TOML

São aceitos arquivos YAML (`.yaml`, `.yml`) e TOML (`.toml`) de até **4 MB**. Apenas os valores de texto são alterados: as chaves, os níveis de aninhamento, as tabelas e a ordem das chaves são preservados. Entre os usos mais comuns estão arquivos de localização do Rails e Symfony, conteúdo de sites estáticos e tabelas i18n do Hugo.

> **Tip: Experimente grátis**
>
> Envie um arquivo de até 2 MB pelos tradutores gratuitos de [YAML](https://ai-glot.com/file-formats/yaml-translation) ou [TOML](https://ai-glot.com/file-formats/toml-translation) para testá-los sem criar uma conta, com limite de cinco arquivos por dia. O app, a API e a CLI aceitam arquivos de até 4 MB.

## O que é traduzido e o que permanece intacto

|      | Traduzido                                                                | Permanece como estava                                             |
| ---- | ------------------------------------------------------------------------ | ----------------------------------------------------------------- |
| YAML | Valores de texto, incluindo conteúdo em prosa em blocos de várias linhas | Chaves, hierarquia, ordem das chaves, números e valores booleanos |
| TOML | Valores de texto, substituídos um por linha                              | Tabelas, chaves, ordem, comentários, números, datas e caminhos    |

Placeholders como `%{name}` (Rails), `{name}` e `%s` são protegidos e mantidos no texto traduzido.

## O que você pode pedir

**Uma localização do Rails**

Um idioma, com placeholders de interpolação e todas as chaves preservadas.

Traduza os valores para francês. Mantenha %\{name} e %\{count} sem alterações e não altere nenhuma chave.

**Preencher as seções de idioma**

Para um arquivo YAML que já tem uma seção para cada idioma: vários idiomas em uma única tarefa.

Preencha as seções vazias fr e de com base na seção en.

**Front matter e conteúdo**

Para um site estático: traduz o texto e mantém as configurações intactas.

Traduza apenas os campos title, description e body para italiano. Mantenha slugs, datas, layouts e URLs sem alterações.

**Uma tabela i18n do Hugo**

Para TOML: mantém as chaves usadas pelos templates.

Traduza os textos para português. Mantenha todas as chaves e os nomes das tabelas exatamente como estão.

**Somente as chaves alteradas**

Para YAML: retorna apenas as chaves que foram escritas.

Traduza os valores para francês e retorne apenas as chaves alteradas.

**Texto voltado ao usuário em uma configuração**

Mantém as configurações intactas.

Traduza apenas as mensagens e os rótulos que as pessoas leem para alemão. Mantenha configurações, identificadores, caminhos e números sem alterações.

## Bom saber

- **Vários idiomas em uma tarefa.** TOML aceita vários idiomas: o plano adiciona, ao lado de cada chave original, uma chave correspondente com um sufixo de idioma, como `hello_fr`. YAML aceita vários idiomas quando o arquivo já tem uma seção para cada um (`en:`, `fr:`, `de:`). Um arquivo Rails típico com uma única chave raiz `en:` aceita um idioma por envio. Se você pedir mais de um, a tarefa poderá falhar porque não será possível prepará-la. Processe o arquivo uma vez para cada idioma: seu [glossário](/docs/platform/glossaries) será mantido.
- **Filtro de saída.** Disponível para YAML ("somente as chaves alteradas"). TOML retorna o arquivo inteiro.
- **Comentários YAML não são mantidos.** O arquivo é lido como dados e reescrito em YAML limpo: os comentários são removidos, e a indentação e as aspas são normalizadas para dois espaços. Use o arquivo original com comentários como referência. Os anchors continuam válidos, embora seus nomes possam mudar.
- **Comentários TOML são mantidos** em condições normais, pois cada string é substituída na própria linha. Um valor que não possa ser inserido dessa forma, como um valor dentro de uma tabela inline, faz com que o arquivo seja reescrito em formato normalizado e seus comentários sejam removidos. O plano avisará quando isso acontecer.
- **Limite.** 4 MB.

## Relacionados

- [JSON, ARB e JSON Lines](/docs/formats/json) e [Java, INI, Fluent e PHP](/docs/formats/java-ini-fluent-php) para outros formatos de configuração e localização.
- [Markdown](/docs/formats/markdown) para o conteúdo ao lado da configuração.
- [Todos os formatos de arquivo](/docs/formats)