Nahrávání a stahování lokalizačních souborů (Strings)

Chcete-li nahrát soubory v Strings, postupujte podle těchto kroků:

Na libovolné stránce projektu vyberte Nahrání z nabídky Více pro přístup do archivu nahrání.

Archiv nahrání uvádí všechna historická nahrání ve všech možných stavech. Kliknutím na rozevírací nabídku Všechny stavy můžete filtrovat nahrání podle stavu (Úspěch, Selhalo a/nebo Probíhá). Chcete-li najít konkrétní nahrání, použijte vyhledávací pole v horní části pro vyhledávání podle názvu.

Získejte přístup k podrobným souhrnům nahrát po kliknutí na uvedené nahrát. Všechny úspěšné nahrát jsou také zobrazeny v aktivitě projekt.

Možnosti Stáhnout se zobrazí při stáhnout souboru v okně Stáhnout se záložkami pro Obecné, Pokročilé a Kódování.

Výběr různých formát souboru nabízí různé možnosti. Další podrobnosti naleznete v příslušném článku o konkrétním formát souboru.

Volitelně použijte pole Název souboru na záložka Obecné k určení Vlastní název pro stáhnout soubor, nebo jej nechte prázdné pro vygenerování systémového názvu.

Ve výchozím nastavení jsou překládaný text zdroje uloženy jako klíče a hodnoty namísto zachování původní struktury souborů. To umožňuje zaměnitelné formát souborů, aniž byste byli zamknuto do jednoho formát, a také flexibilní seskupování pomocí tagů.

Některé frameworky nebo nastavení vyžadují více zdrojových souborů, což také vyžaduje dodatečnou konfiguraci.

Udržování oddělených souborů

Obecně platí, že všechny překlady pro každý jazyk uchovávejte v jednom souboru. Díky tomu je stahování zdrojů rychlejší a robustnější. Překlady jsou udržovány organizované v projektech, takže oddělené malé soubory nejsou vyžadovány.

Pokud je vyžadováno, aby byly lokalizační soubory udržovány v oddělených souborech, lze použít pracovní postup založený na souborech tak, že při nahrát označíte klíče tagy a tyto tagy použijete jako reference při stahování přeložených klíčů zpět do původních souborů. Klíče mohou nést více tagů a být zahrnuty ve více souborech, což zajišťuje jejich opětovné použití a konzistenci. Pracovní postup založený na tagu je flexibilní a umožňuje reorganizaci překladových zdrojů, aniž by musely být nahrány do projektů.

Přiřaďte klíčům unikátní názvy napříč všemi soubory, abyste zajistili hladký pracovní postup. V přístupu založeném na klíč-hodnota musí mít klíč v každém kontextu přiřazeny stejné hodnoty. Některé frameworky umožňují použití neunikátních klíčů napříč více soubory. Některé formáty, jako například Symfony, podporují domény zpráv. Tyto domény jsou detekovány podle názvu souboru. Klíče nejsou automaticky vymezeny doménami založenými na názvu souboru, ale toto lze vyřešit použitím unikátní doménové předpony pro klíče v rámci souboru.

Příklad konfigurace CLI

Pokud pracujete s CLI nebo propojujete projekt s úložištěm (např. GitHub, GitLab nebo Bitbucket), nastavte konfigurační soubor pro správu nahrávání a stahování.

Pro tento příklad má projekt několik sémanticky pojmenovaných překladových souborů pro zdrojový kód jazyka. Například: accounts.en.yml, emails.en.yml atd. Tyto sémantické názvy jsou spravovány prostřednictvím tagů.

Nakonfigurujte .phrase.yml tak, aby odrážel organizaci souborů v lokalizačním projekt a propojil je s tagy v projektu Strings zahrnutím zástupný znak tagu do cesty k souboru:

phrase:
  access_token: "3d7e6598d955bfcab104c45c40af1b9459df5692ac4c28a17793"
  project_id: "23485c9c5dfb15d85b32d9c5f3d2hl54"
  file_format: yml
  push:
    sources:
      - soubor: ./path/to/locales/<tag>.en.yml
        params:
          locale_id: "abcd1234cdef1234abcd1234cdef1234"
  pull:
    targets:
      # účty
      - soubor: ./path/to/locales/accounts.<kód jazyka_name>.yml
        params:
          tagy: účty
      # e-maily
      - soubor: ./path/to/locales/emails.<kód jazyka_name>.yml
        params:
          tagy: e-maily

Parametr tagy lze také použít v sekci push namísto použití zástupného znaku <tag>.

Konfigurace vytváří klíče s tagy na základě souboru, ze kterého pocházejí, při spuštění push nebo spuštění synchronizace z úložiště. Při spuštění pull nebo spuštění stáhnout do úložiště seskupuje klíče do souborů na základě jejich tagů.

Produkt, webová stránka nebo aplikace je přeložena do řady různých jazyků, ale v některých případech lokalizace není jen zvolený jazyk, ale různé verze v rámci jednoho jazyka.

Další rozlišení je vyžadováno, pokud:

Lokalizace statického produktu

Pokud je produkt plně vyvinut a zřídka aktualizován, může v rámci projekt existovat samostatná verze produktu.

Lokalizace projekt s průběžnými aktualizacemi

Pokud je produkt neustále aktualizován o nový obsah (klíč), je obtížné aplikovat tyto aktualizace na více projekt a udržovat je synchronizované. Použít vyhrazené jazyky v rámci projekt pro jejich údržbu.

Kódy jazyka podle normy ISO (např. en-US) nemusí být jedinečné, takže lze vytvořit v rámci projekt mnoho verzí stejného jazyka. Rozlišujte mezi regiony, klient nebo publikem pomocí jedinečného názvu jazyka.

Při nastavení se každý nově zavedený klíč ve výchozím kód jazyka zobrazí jako nepřeloženo v ostatních jazycích a bude odpovídajícím způsobem lokalizován. Pokud pracujete s klient a jejich vlastním překladatel, přiřaďte je konkrétně tak, aby mohli Upravit pouze své verze jazyk aktualizací přístup k jazyk v jejich profil nebo správa uživatel projekt.

nastavit paralelní lokalizační procesy s úkoly a revizními pracovními postupy v rámci stejného projekt. Tato flexibilita se vztahuje také na nahrávání a stahování souborů jazyk nebo automatizované procesy prostřednictvím API.