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

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

Z jakékoli stránky projekt Vybrat nahrát z nabídky Více pro přístup do archivu nahrávání.

Archiv nahrávání uvádí všechny historické nahrát ve všech možných stav. Klikněte na rozevírací nabídku Všechny stav pro filtrovat nahrát podle stav (Úspěch, Selhalo a/nebo průběh). Pro nalezení konkrétního nahrát použít vyhledávací pole v horní části pro vyhledávání podle názvu.

přístup k podrobným souhrnům nahrát ovlivněných zdrojů kliknutím na uvedené nahrát. Všechny úspěšné nahrát jsou také prezentovány v proudu aktivit projekt.

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

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

Volitelně použít pole Název souboru v záložka Obecné pro zadání Vlastní název 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ý text zdroje ukládány 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 v jednom formát, a také flexibilní seskupování pomocí tagy.

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

Udržování samostatných souborů

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

Pokud je vyžadováno, aby byly lokalizační soubory udržovány v samostatných souborech, lze použít pracovní postup založený na souborech tak, že se klíče při nahrát označí tagy a tyto tagy se použijí 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 tagy je flexibilní a umožňuje reorganizaci překladových zdrojů, aniž by musely být nahrát 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íč-hodnota musí mít klíč v každém kontextu přiřazeny stejné hodnoty. Některé frameworky umožňují použít nejedinečné klíče napříč více soubory. Některé formát, 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é 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ě (např. GitHub, GitLab nebo Bitbucket), nastavit konfigurační soubor pro správu nahrát 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ím 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:
      # accounts
      - file: ./path/to/locales/accounts.<kód jazyka_name>.yml
        params:
          tags: accounts
      # emails
      - 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ého znaku <tag>.

Konfigurace vytváří klíče s tagy na základě souboru, ze kterého pocházejí, při spuštění příkazu push nebo spuštění synchronizace z úložiště. Při spuštění příkazu pull nebo spuštění operace 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 o zvoleném jazyk, ale o různých verzích v rámci jednoho jazyk.

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

Lokalizace statického produkt

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

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

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

Kód 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 jazyk. Rozlišujte mezi regiony, klient nebo publikem pomocí jedinečného název jazyk.

Po nastavení se každý nově zavedený klíč ve výchozím kód jazyka zobrazí jako nepřeloženo v ostatní jazyk a bude odpovídajícím způsobem lokalizován. Pokud pracujete s klient a jejich vlastní 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ávě uživatel projekt.

nastavit paralelní lokalizační procesy s zakázka a revizní pracovní 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.