Formát General yaml
YAML je široce používán pro lokalizaci v Ruby on Rails, projektech Symfony PHP a aplikacích Vue.js. Jeho odsazená syntaxe klíč-hodnota je čitelnější než JSON pro složité vnořené struktury a nativně podporuje víceřádkové řetězce a komentáře — užitečné pro dokumentaci kontextu překladatele přímo v souboru.
Soubory lokalizace YAML používají hierarchie klíčů s odsazením, kde každá úroveň odsazení vytváří vnořený jmenný prostor. Nejvyšší úrovní je obvykle kód jazyka obalující celý strom klíčů — standardní konvence pro soubory lokalizace Ruby on Rails. Hodnoty řetězce lze zapisovat inline nebo jako blokové skaláry pro víceřádkový text. Syntaxe interpolace se liší podle frameworku: Rails používá názvy proměnných obklopené znaky procenta, Symfony používá syntaxi dvojitých složených závorek.
Osvědčená praxe: vyhněte se speciálním znakům YAML v hodnotách řetězce — dvojtečky, mřížky, hranaté závorky a složené závorky by měly být v uvozovkách, aby nedocházelo k chybám parsování YAML. Pro dlouhé řetězce používejte notaci blokového skaláru pro zachování čitelnosti. Udržujte soubory lokalizace konzistentně strukturované napříč jazyky, aby bylo snazší detekovat chybějící překlady. Language Monster podporuje obecný formát YAML a zachovává strukturu vnořených klíčů během překladu.