Překládání Snippu

Snipp překládá jeho komunita a budeme rádi za vaši pomoc. Pokud plynně ovládáte jiný jazyk, můžete vylepšit stávající překlady nebo pomoci přinést Snipp do nového jazyka. Tento průvodce pokrývá vše, co potřebujete.

Odměny

  • Za smysluplné příspěvky získáte exkluzivní odznak Překladatel na svém profilu Snipp.

  • Obdržíte také roli Překladatel na našem serveru Discord.

  • Aktivní přispěvatelé mohou jako poděkování obdržet Snipp PLUS.

Začínáme

Nejlepší místo, kde začít, je náš server Discord kde se překladatelé koordinují, přihlašují si jazyky a získávají pomoc. Dejte nám vědět, na kterém jazyce byste chtěli pracovat, aby se úsilí neduplikovalo.

Dva způsoby překládání

Existují dva způsoby, jak přispět překlady. Vyberte si, který vám vyhovuje, nemusíte používat oba.

Crowdin

Nejjednodušší možnost. Překládejte přímo ve svém prohlížeči bez znalosti JSON nebo Gitu. Crowdin zobrazuje každý řetězec v kontextu a formátování zařídí za vás. Doporučeno pro většinu překladatelů.

Otevřít Crowdin

GitHub

Pro vývojáře, kteří se vyznají v Gitu. Upravujte přímo soubory JSON jednotlivých jazyků a otevřete pull request. Nejlepší, pokud chcete plnou kontrolu nebo přidáváte nový jazyk.

Otevřít repozitář

Jak soubory fungují

Každý jazyk je plochý soubor JSON. Klíč je stabilní ID a nikdy se nemění. Hodnota je text zobrazený uživatelům a to jediné překládáte:

{
  "SETTINGS_PREFS_AUTO_COMPRESSION_LABEL": "Automatic Compression",
  "SETTINGS_PREFS_PARTY_MODE_LABEL": "Party Mode"
}

Anglický soubor je zdrojem pravdy. Každý další jazyk má přesně stejnou sadu klíčů, takže měníte vždy jen hodnoty.

Pravidla

  • Nikdy nepřidávejte, neodebírejte ani nepřejmenovávejte klíče. Nové klíče pocházejí z kódu Snippu. Pokud klíč ve vašem jazyce chybí, web použije angličtinu jako záložní.

  • Zachovejte zástupné symboly identické. Text jako {count} nebo {username} se nahrazuje za běhu. Zachovejte přesně stejné zástupné symboly, i když je můžete přesunout podle slovosledu svého jazyka.

  • Dodržujte konvenci velikosti písmen. Krátké popisky UI používají v každém jazyce Velká Počáteční Písmena. Celé věty používají běžnou větnou velikost písmen pro váš jazyk.

  • Nepřekládejte značkové ani technické tokeny. Snipp, Discord, ShareX, URL, API, PLUS a přípony souborů ponechte beze změny.

  • Udržujte platný JSON. Používejte dvojité uvozovky, čárku za každou položkou kromě poslední a žádné koncové čárky.

  • Zachovejte úvodní a koncové mezery, pokud je hodnota má. Jsou záměrné a slouží ke spojování vět.

Odesílání přes GitHub

Pokud jste zvolili cestu přes GitHub, zde je postup. Překladatelé na Crowdinu mohou tuto sekci přeskočit, vaše změny se odesílají přímo z Crowdinu.

Překlady se odesílají přes repozitář i18n na GitHubu standardním postupem fork a pull request:

  • Forkněte repozitář, poté naklonujte svůj fork a vytvořte novou větev pro svou změnu.

  • Upravte soubor jazyka pro svůj jazyk a přeložte hodnoty, které chcete vylepšit.

  • Spusťte validační skript z kořene repozitáře a před odesláním opravte vše, co nahlásí.

  • Commitněte, pushněte do svého forku a otevřete pull request proti hlavní větvi. Správce jej zkontroluje a sloučí.

Nechcete používat příkazovou řádku? Funguje i webový editor GitHubu. Otevřete soubor jazyka, klikněte na ikonu tužky, upravte a navrhněte své změny.

Přidání nového jazyka

Snipp zatím nepodporuje váš jazyk? Otevřete na GitHubu issue s návrhem jazyka a jeho kódu, zkopírujte anglický zdrojový soubor jako výchozí bod, přeložte každou hodnotu a otevřete pull request. Správce nový jazyk na webu zaregistruje.

Připraveni pomoci?

Připojte se k našemu serveru Discord, přihlaste si jazyk, poznejte další překladatele a začněte.

Další články