json (.json)
JSON je nejrozšířenější formát lokalizace pro webové aplikace. Aplikace v Reactu využívající i18next nebo react-i18next ukládají překlady jako ploché nebo vnořené JSON objekty. Aplikace ve Vue.js využívající vue-i18n pracují s JSON nativně. Next.js, Angular, backendové servery v Node.js a většina JavaScriptových frameworků mají nativní podporu JSON. Language Monster automaticky detekuje strukturu vašich JSON souborů s lokalizacemi a zvládá jak ploché, tak vnořené rozložení objektů.
Plochý JSON mapuje řetězcové klíče přímo na přeložené hodnoty. Vnořený JSON organizuje klíče do jmenných prostorů — například auth.login.button je řetězec vnořený uvnitř objektu auth uvnitř objektu login. i18next přistupuje k vnořeným klíčům pomocí tečkové notace. Soubory s překlady jsou pojmenovány podle kódu jazyka: en.json, fr.json, de.json. Interpolace používá pojmenované proměnné uzavřené ve dvojitých složených závorkách; množné formy využívají konvenci přípony _one a _other v i18next nebo oddělovač svislou čarou ve vue-i18n.
Osvědčená praxe: rozdělte soubory s lokalizacemi podle jmenných prostorů funkcí, namísto jednoho velkého souboru na jazyk. To umožňuje líné načítání pouze řetězců potřebných pro danou stránku, čímž se snižuje velikost počátečního balíčku. Pojmenovávejte klíče sémanticky — checkout.submit je stabilnější než button_14. Vyhněte se dynamickému sestavování klíčů za běhu, protože to narušuje statické analyzátory. Spouštějte eslint-plugin-i18next v CI, abyste zachytili nepřeložené hardkódované řetězce dříve, než se dostanou do produkce.