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

Pro nahrání souborů v Strings postupujte podle těchto kroků:

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

Archiv nahrávání obsahuje seznam všech historických nahrání ve všech možných stavech. Klikněte na rozbalovací nabídku Všechny stavy pro filtrování nahrání podle stavu (Úspěch, Selhalo a/nebo Probíhá). Pro vyhledání konkrétního 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ání ovlivněných zdrojů kliknutím na uvedené nahrání. Všechna úspěšná nahrání jsou také zobrazena v proudu aktivit projektu.

Možnosti stažení se zobrazí při stahování 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ů souborů zobrazí různé možnosti. Další podrobnosti naleznete v příslušném článku o konkrétním formátu souboru.

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

Ve výchozím nastavení jsou překládané zdroje ukládány jako klíče a hodnoty namísto zachování původní struktury souborů. To umožňuje zaměnitelné formáty souborů bez nutnosti být zamknut v jednom formátu, stejně jako 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 byste měli uchovávat v jednom souboru. Díky tomu je stahování zdrojů rychlejší a robustnější. Překlady jsou organizovány v projektech, takže není nutné mít oddělené malé soubory.

Pokud je vyžadováno, aby lokalizační soubory byly udržovány v oddělených souborech, lze použít pracovní postup založený na souborech tak, že při nahrávání označíte klíče tagy a tyto tagy použijete jako referenci při stahování přeložených klíčů zpět do původních souborů. Klíče mohou mít 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 tazích je flexibilní a umožňuje reorganizaci překládaných zdrojů, aniž by musely být nahrány do projektů.

Přiřaďte klíčům napříč všemi soubory jedinečné názvy, abyste zajistili hladký pracovní postup. V přístupu založeném na klíčích a hodnotách musí mít klíč v každém kontextu přiřazeny stejné hodnoty. Některé frameworky umožňují použití nejedinečný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 jedinečné předpony domény 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 organizace souborů v lokalizační projekt a propojte je s tagy v projekt Strings zahrnutím zástupný znak tagu do cesty k souboru:

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

Parametr tags lze také použít v sekci push namísto použití zástupný znak <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 jazyk.

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 projektu existovat samostatná verze produktu.

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

Pokud je produkt neustále aktualizován novým obsahem (klíči), je obtížné aplikovat tyto aktualizace na více projektů a udržovat je synchronizované. Použijte vyhrazené jazyky v rámci projektu k jejich údržbě.

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

Při nastavení se každý nově zavedený klíč ve výchozím kódu jazyka zobrazí jako nepřeloženo v ostatních jazycích a bude odpovídajícím způsobem lokalizován. Pokud pracujete s klientem a jeho vlastním překladatelem (překladateli), přiřaďte je konkrétně tak, aby mohli upravovat pouze své jazykové verze aktualizací přístupu k jazyku v jejich profilu uživatele nebo správě uživatelů projektu.

Nastavte paralelní lokalizační procesy pomocí zakázek a revizních pracovních postupů v rámci stejného projektu. Tato flexibilita se vztahuje také na nahrávání a stahování souborů jazyka nebo automatizované procesy prostřednictvím API.