Formát Ruby Yaml

Ruby on Rails používá YAML jako výchozí formát lokalizace se specifickou konvencí struktury souborů. Každý soubor lokalizace je pojmenován podle kódu jazyka — en.yml, fr.yml, de.yml — a klíč nejvyšší úrovně v souboru je kód jazyka sám obalující celý strom klíčů. Modul I18n frameworku Rails automaticky vybírá správný soubor na základě aktuálního jazyka.

Soubory Rails YAML začínají kódem jazyka jako kořenovým klíčem, následovaným vnořenými hierarchiemi klíčů zrcadlícími strukturu aplikace. Modely, kontrolery a pohledy mají obvykle každý svou vlastní sekci. Interpolace používá názvy proměnných obklopené znaky procenta. Množné číslo ve výchozím nastavení používá klíče one a other, přičemž zero, few, many se přidávají pro jazyky, které je vyžadují. Názvy modelů ActiveRecord a popisky atributů pro chybové zprávy se řídí specifickou konvencí pod klíčem activerecord.

Osvědčená praxe: dodržujte konvence jmenných prostorů Rails — pro řetězce pohledů používejte vzor controller.action.key a pro obsah related s modely vzor activerecord.models.name. Spouštějte gem i18n-tasks v CI pro detekci chybějících překladů, nepoužívaných klíčů a nekonzistencí mezi soubory lokalizace. V pohledech používejte líné vyhledávání — volání i18n mohou automaticky rozlišit klíč lokalizace na základě cesty k souboru pohledu. Language Monster podporuje formát Ruby YAML a zachovává hierarchii klíčů lokalizace Rails během překladu.

Více informací Formáty souborů