Přidej svůj jazyk. Je to jeden soubor.

Jediný způsob, jak přispět do ./blog.sh bez napsání jediného řádku Ruby, je přeložit ho – a je to jeden soubor YAML.

Všechno, co čtenář vidí – navigace, data, nadpisy archivu, pole hledání, výzva ke komentářům – pochází ze souboru lokalizace. Celý návod bydlí tady:

docs/localization.md – přidání jazyka do ./blog.sh

Tři věci to dělají opravdu snadným:

• Jazyk jsou data, ne kód. Zkopíruješ en.yml, přejmenuješ ho, přeložíš hodnoty. Žádné šablony se nedotkneš, žádné Ruby nečteš.
• Záložní hodnota funguje po klíčích. Napůl hotový překlad funguje od prvního dne – cokoli jsi ještě nepřeložil, se prostě ukáže anglicky, dokud se k tomu nedostaneš.
• Úplný musí být jen en.yml. Ten tvůj může růst tempem, jaké ti dovolí víkendy.

Angličtina, čeština a němčina už jsou v. Ten tvůj by byl čtvrtý.

Jedno návrhové rozhodnutí stojí za odstavec, protože lidi překvapuje: není tu žádný systém plurálů, záměrně. Místo toho je každá počítaná fráze napsaná tak, aby seděla na jakékoli číslo – tak, jak čeština se svými třemi tvary plurálu odjakživa potichu obchází cizí systémy plurálů. Je to rozdíl mezi tím vydat překlad dnes večer, a tím napřed číst specifikaci CLDR.

Odměna: lokalizace zkontrolovaná rodilým mluvčím se v README označí jako vydaná, s tvým jménem. Vítané jsou i komunitní návrhy – jsou tak označené, dokud je rodilý mluvčí neschválí.

Jedna poctivá hranice: zatím žádné RTL. Šablony rozvržení nezrcadlí a předstírat opak by promarnilo večer arabského nebo hebrejského překladatele. Je to zapsané v témže dokumentu.