Migrácia na Weblate

Používate inú lokalizačnú platformu a uvažujete o prechode na Weblate? Táto príručka poskytuje rýchly proces krok za krokom, ktorý vám pomôže migrovať váš prekladový projekt z platforiem, ako sú Transifex, Crowdin, Lokalise alebo podobné služby.

Weblate je navrhnutý okolo kontinuálnej lokalizácie s integráciou Git v jeho jadre, čo ho robí ideálnym pre tímy, ktoré chcú mať preklady blízko svojho vývojového workflow.

Viď aj

Požiadavky

Pred začatím migrácie sa uistite, že máte:

Na vašej lokalizačnej platforme:

  • Prístup na export vašich prekladových súborov

  • Zoznam prekladateľov a ich rolí/oprávnení

  • Pochopenie vášho súčasného pracovného postupu (proces kontroly, automatizácia atď.)

Pre Weblate:

  • Inštancia Weblate (buď Hosted Weblate alebo self-hosted)

  • Oprávnenia administrátora alebo vytvárania projektov na vašej inštancii Weblate

Pripravte vaše prekladové súbory

Exportujte preklady z vašej aktuálnej platformy

Väčšina lokalizačných platforiem vám umožňuje exportovať všetky preklady naraz:

  • Transifex: Použite ich CLI nástroj alebo stiahnite preklady z webového rozhrania

  • Crowdin: Exportujte všetky preklady ako ZIP súbor z nastavení projektu

  • Lokalise: Použite funkciu hromadného exportu

  • Phrase: Stiahnite všetky lokály z dashboardu projektu

Rada

Uchovajte vaše prekladové súbory vo formáte natívnom pre váš internacionalizačný framework (PO, XLIFF, JSON atď.) namiesto ich konvertovania. Weblate podporuje mnoho formátov.

Zapisovať preklady do vášho Git repozitára

Rada

Ak radšej nechcete ukladať preklady v externom Git repozitári, môžete tento krok preskočiť a použiť možnosť Nahrať prekladové súbory pri vytváraní súčasti.

Ak vaše preklady ešte nie sú v Gite:

  1. Vytvorte Git repozitár alebo použite váš existujúci projektový repozitár

  2. Organizujte prekladové súbory podľa štruktúry vášho projektu

  3. Zapíšte a odošlite súbory na vašu Git hostingovú službu (GitHub, GitLab, Bitbucket atď.)

git add locales/
git commit -m "Add translation files for Weblate migration"
git push origin main

Viď aj

Importujte váš projekt do Weblate

Vytvorte nový projekt

  1. Prejdite na vašu inštanciu Weblate.

  2. Kliknite na Pridať nový prekladový projekt v menu +.

  3. Vyplňte detaily vášho projektu:

    • Názov projektu: Názov vašej aplikácie alebo projektu

    • URL slug: Krátky identifikátor (napr. myapp)

    • Webová stránka projektu: Domovská stránka vášho projektu (voliteľné)

../_images/user-add-project.webp

Viď aj

Pridávanie prekladových projektov a komponentov pre podrobné pokyny na vytvorenie projektu

Pridajte súčasť z vášho Git repozitára

  1. Po vytvorení projektu kliknite na Pridať novú prekladovú súčasť

  2. Vyberte Zo správy verzií

  3. Nakonfigurujte vašu súčasť:

    • Názov súčasti: napr. „Reťazce aplikácie“, „Webová stránka“, „Dokumentácia“

    • URL repozitára: URL vášho Git repozitára (HTTPS alebo SSH)

    • Vetva repozitára: Voliteľné: Špecifikujte vetvu repozitára (Weblate automaticky deteguje predvolenú vetvu, ak nie je špecifikovaná)

  4. Weblate automaticky deteguje:

    • Formát prekladového súboru

    • Dostupné jazyky

    • Zdrojový jazyk

  5. Skontrolujte a potvrďte detegované nastavenia

Poznámka

Ak váš repozitár obsahuje Transifex .tx/config, Weblate ho parsuje pomocou translation-finder a ponúka zodpovedajúce konfigurácie komponentov počas objavovania. Toto pokrýva iba konfiguráciu súvisiacu so súbormi, ako sú masky súborov a zdrojové súbory. Ostatné nastavenia projektu z predchádzajúcej platformy, vrátane pracovných postupov, oprávnení a aliasov jazykov, je stále potrebné nakonfigurovať manuálne vo Weblate.

Aliasy jazykov zvyčajne nie sú potrebné, pretože Weblate už rozpoznáva a normalizuje bežné varianty kódov jazykov pri parsovaní prekladových súborov. Pozrite Analýza kódov jazykov; nakonfigurujte Jazykové aliasy iba ak váš repozitár používa kódy, ktoré Weblate nedokáže mapovať podľa zamýšľaného účelu.

../_images/user-add-component-discovery.webp

Rada

Pre repozitáre s viacerými prekladovými súčasťami (napr. samostatné súbory pre backend, frontend, dokumentáciu), vytvorte samostatnú súčasť Weblate pre každú.

Môžete to urýchliť pomocou Z existujúcej súčasti pre zdieľané repozitáre alebo Objavovanie komponentov na ich automatické vytvorenie.

Viď aj

Nakonfigurujte váš workflow

Nastavte riadenie prístupu

Vyberte viditeľnosť a úroveň prístupu vášho projektu:

  1. Prejdite do nastavení vášho projektu: Operácie → Nastavenia → karta Prístup

  2. Vyberte vhodné riadenie prístupu:

    • Verejný: Projekty s otvoreným zdrojovým kódom, prispievať môže ktokoľvek

    • Chránený: Viditeľný pre všetkých, ale prekladať môžu iba pozvaní používatelia

    • Súkromný: Iba pozvaní používatelia môžu prezerať a prekladať

../_images/project-access.webp

Viď aj

Správa riadenia prístupu pre jednotlivé projekty pre podrobnú konfiguráciu riadenia prístupu

Nastavte kontinuálnu lokalizáciu

Povoľte automatické aktualizácie a zápisy:

  1. Nakonfigurujte integráciu repozitára:

    • Stiahnuť zmeny: Nastavte webhook, aby sa Weblate aktualizoval, keď sa zmení váš zdrojový kód

    • Odoslať zmeny: Nakonfigurujte Odosielanie zmien z Weblate, aby boli preklady zapísané späť do vášho repozitára

  2. Povoľte automatické akcie v nastaveniach súčasti:

    • Odoslať pri zápise: Automaticky odosielať preklady do vášho repozitára

    • Interval zápisu: Nastavte, ako často sú čakajúce preklady zapísané (napr. každých 24 hodín)

Viď aj

Nepretržitá lokalizácia pre kompletnú automatizáciu workflow

Nakonfigurujte kontroly kvality a workflow

Prispôsobte kontroly kvality prekladu:

  1. Povoliť kontroly: Preskúmajte Kontroly kvality a povoľte akékoľvek voliteľné kontroly kvality, ktoré potrebujete.

  2. Nastaviť workflow kontroly: Povoľte Povoliť kontroly, ak chcete proces schvaľovania.

  3. Pridať vynútené kontroly: Nakonfigurujte, ktoré kontroly kvality by mali blokovať preklady.

Voliteľné: Povoliť doplnky

Weblate ponúka Doplnky na automatizáciu bežných úloh:

Viď aj

Doplnky pre všetky dostupné doplnky

Testovať a overiť

Pred oznámením migrácie vašim prekladateľom:

  1. Otestovať workflow:

    • Urobte testovací preklad

    • Overte, že sa objaví vo vašom Git repozitári

    • Otestujte sťahovanie zmien z vášho repozitára do Weblate

  2. Importovať akúkoľvek existujúcu pamäť prekladov (voliteľné):

    • Použite Prekladová pamäť na import predchádzajúcich prekladov

    • Toto pomáha s konzistenciou a urýchľuje preklad

  3. Nakonfigurovať upozornenia:

Viď aj

Prekladová pamäť pre správu pamäte prekladov

Pozvať a spravovať používateľov

Pozvať prekladateľov

Pre Chránené a Súkromné projekty:

  1. Prejdite na Operácie → Používatelia vo vašom projekte

  2. Použite Pridať používateľa na pozvanie prekladateľov

  3. Priraďte ich k vhodným tímom:

    • Prekladatelia: Môžu prekladať reťazce

    • Recenzenti: Môžu kontrolovať a schvaľovať preklady

    • Manažéri: Môžu spravovať nastavenia projektu

Pre Verejné projekty môžu používatelia začať prispievať ihneď po registrácii.

Tip

Pošlite vašim prekladateľom uvítaciu správu s:

  • Odkaz na váš projekt na Weblate

  • Prehľad akejkoľvek terminológie alebo štýlových príručiek špecifických pre projekt

  • Informácie o vašom procese kontroly

Viď aj

Ďalšie kroky

Po dokončení migrácie:

  • Oznámiť prekladateľom: Informujte váš prekladový tím o migrácii s jasnými pokynmi

  • Sledovať počiatočné použitie: Sledujte akékoľvek problémy počas prvých niekoľkých dní

  • Zozbierať spätnú väzbu: Opýtajte sa prekladateľov na ich skúsenosti v porovnaní s predchádzajúcou platformou

  • Optimalizovať workflow: Upravte nastavenia podľa potrieb vášho tímu

  • Odstrániť predchádzajúcu platformu: Po dokončení migrácie nezabudnite zrušiť prístup udelený predchádzajúcej platforme.

Tip

Počas migrácie môžete prevádzkovať obe platformy paralelne počas prechodného obdobia, aby ste sa uistili, že všetko funguje podľa očakávania pred úplným prepnutím.

Dodatočné zdroje

Rada

Pripojte sa ku komunite Weblate, ak potrebujete pomoc počas vašej migrácie. Komunita je aktívna a ochotná pomôcť!