Migrating to Weblate

Estàs utilitzant una plataforma de localització diferent i estàs pensant en canviar a Weblate? Aquesta guia ofereix un procés ràpid i pas a pas per ajudar-vos a migrar el vostre projecte de traducció des de plataformes com Transifex, Crowdin, Lokalise o serveis similars.

Weblate està dissenyat al voltant de la localització contínua amb la integració de Git en el seu nucli, el que el fa ideal per als equips que volen mantenir les traduccions a prop del seu flux de treball de desenvolupament.

Vegeu també

• Començant per la internacionalització for choosing the right internationalization framework

• Integració amb Weblate for detailed integration options

• Localització contínua per configurar fluxos de treball automatitzats

Prerequisites

Abans d’iniciar la migració, assegureu-vos que teniu:

A la teva plataforma de localització:

• Access to export your translation files

• Llista de traductors i les seves funcions/permisos

• Comprensió del vostre flux de treball actual (procés de revisió, automatització, etc.)

For Weblate:

• Una instància de Weblate (ja sigui Hosted Weblate o self-hosted)

• Permisos d’administrador o de creació de projectes a la vostra instància de Weblate

Prepare your translation files

Export translations from your current platform

La majoria de les plataformes de localització us permeten exportar totes les traduccions alhora:

• Transifex: Use their CLI tool or download translations from the web interface

• Crowdin: exporta totes les traduccions com a fitxer ZIP des de la configuració del projecte

• Lokalise: utilitzeu la funció d’exportació massiva

• Frase: Baixeu totes les configuracions regionals des del tauler del projecte

Suggeriment

Mantingueu els vostres fitxers de traducció en el format natiu del vostre marc d’internacionalització (PO, XLIFF, JSON, etc.) en lloc de convertir-los. Weblate admet molts formats.

Commit translations to your Git repository

Suggeriment

Si preferiu no emmagatzemar traduccions en un repositori Git extern, podeu ometre aquest pas i utilitzar l’opció Pujar fitxers de traducció quan creeu un component.

If your translations aren’t already in Git:

1. Creeu un dipòsit de Git o utilitzeu el vostre dipòsit de projecte existent

2. Organitzeu els fitxers de traducció seguint l’estructura del vostre projecte

3. Envieu i envia els fitxers al vostre servei d’allotjament Git (GitHub, GitLab, Bitbucket, etc.)

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

Vegeu també

• Localització contínua for optimal repository structure

• Integració del control de versions per als sistemes de control de versions compatibles

Import your project into Weblate

Create a new project

1. Navigate to your Weblate instance.

2. Feu clic a Afegeix un projecte de traducció nou al menú +.

3. Ompliu les dades del vostre projecte:

   • Nom del projecte: el nom de la vostra aplicació o projecte

   • URL slug: identificador curt (p. ex., myapp)

   • Lloc web del projecte: la pàgina d’inici del projecte (opcional)

Vegeu també

Afegir projectes i components de traducció per obtenir instruccions detallades de creació de projectes

Add a component from your Git repository

1. Després de crear el projecte, feu clic a Afegeix un nou component de traducció

2. Select From version control

3. Configure your component:

   • Nom del component: p. ex., «Cadenes d’aplicació», «Lloc web», «Documentació»

   • URL del repositori: URL del vostre repositori Git (HTTPS o SSH)

   • Branca del repositori: Opcional: especifica la branca del repositori (Weblate detecta automàticament la branca predeterminada si no s’especifica)

4. Weblate detectarà automàticament:

   • Translation file format

   • Available languages

   • Llengua d’origen

5. Review and confirm the detected settings

Nota

Si el vostre repositori conté un Transifex .tx/config, Weblate l’analitza mitjançant el cercador de traduccions i ofereix configuracions de components coincidents durant el descobriment. Això només cobreix la configuració relacionada amb els fitxers, com ara les màscares de fitxers i els fitxers font. Altres configuracions del projecte de la plataforma anterior, inclosos els fluxos de treball, els permisos i els àlies d’idioma, encara s’han de configurar manualment a Weblate.

Language aliases are usually not needed because Weblate already recognizes and normalizes common language-code variants while parsing translation files. See Anàlisi de codis d’idioma; configure Àlies de llengua only if your repository uses codes Weblate cannot map as intended.

Suggeriment

Per als dipòsits amb diversos components de traducció (p. ex., fitxers separats per a backend, frontend, documentació), creeu un component Weblate independent per a cadascun.

Podeu accelerar-ho fent servir Des del component existent per als dipòsits compartits o Descobriment de components per crear-los automàticament.

Vegeu també

• Configuració dels components for all configuration options

• Formats bilingües i monolingües per entendre els formats monolingües i bilingües

• Descobriment de components

Configure your workflow

Set up access control

Trieu la visibilitat i el nivell d’accés del vostre projecte:

1. Go to your project settings: Operations → Settings → Access tab

2. Seleccioneu el control d’accés adequat:

   • Públic: Projectes de codi obert, tothom pot col·laborar

   • Protegit: visible per a tothom, però només els usuaris convidats poden traduir

   • Privat: només els usuaris convidats poden veure i traduir

Vegeu també

Managing per-project access control per a la configuració detallada del control d’accés

Set up continuous localization

Activa les actualitzacions i les confirmacions automàtiques:

1. Configure repository integration:

   • Pull canvis: configureu un webhook perquè Weblate s’actualitzi quan canviï el vostre codi font

   • Push changes: configureu Impulsant canvis des de Weblate perquè les traduccions es tornin a enviar al vostre repositori

2. Enable automatic actions in component settings:

   • Push on commit: envia traduccions automàticament al teu repositori

   • Interval de confirmació: defineix la freqüència amb què es comprometen les traduccions pendents (p. ex., cada 24 hores)

Vegeu també

Localització contínua for complete workflow automation

Configure quality checks and workflows

Customize translation quality controls:

1. Activa comprovacions: revisa Controls de qualitat i activa les comprovacions de qualitat d’activació que necessites.

2. Configura el flux de treball de revisió: activa Activa les revisions si vols un procés d’aprovació.

3. Afegeix comprovacions obligades: configura quines comprovacions de qualitat han de bloquejar les traduccions.

Optional: Enable add-ons

Weblate offers Complements to automate common tasks:

• Actualitza els fitxers PO perquè coincideixin amb el POT (msgmerge): Actualitza automàticament els fitxers PO de les plantilles POT

• Neteja els fitxers de traducció: Elimina les cadenes de traducció no utilitzades

• Fes comissions «squash» al Git: Squash es compromet abans d’enviar-lo al vostre repositori

• Descobriment de components: Automatically discover new translation files

Vegeu també

Complements per a tots els complements disponibles

Test and verify

Abans d’anunciar la migració als vostres traductors:

1. Prova el flux de treball:

   • Make a test translation

   • Verify it appears in your Git repository

   • Test pulling changes from your repository into Weblate

2. Import any existing translation memory (optional):

   • Use Memòria de traducció to import previous translations

   • Això ajuda a la coherència i accelera la traducció

3. Configure notifications:

   • Set up Notificacions for translation events

   • Configure repository Punts d’inserció de notificacions for your Git hosting service

Vegeu també

Memòria de traducció per a la gestió de la memòria de traducció

Invite and manage users

Invite translators

Per a projectes protegits i privats:

1. Navigate to Operations → Users in your project

2. Use Add user to invite translators

3. Assigneu-los als equips adequats:

   • Translators: Can translate strings

   • Reviewers: Can review and approve translations

   • Gestors: pot gestionar la configuració del projecte

Per als projectes públics, els usuaris poden començar a contribuir immediatament després de registrar-se.

Truc

Envieu als vostres traductors un missatge de benvinguda amb:

• Link to your project on Weblate

• Visió general de qualsevol terminologia o guies d’estil específiques del projecte

• Information about your review process

Vegeu també

• Managing per-project access control for team management

• Control d’accés per a la configuració avançada de permisos

Next steps

Després de completar la migració:

• Anunciar als traductors: informa el teu equip de traducció sobre la migració amb instruccions clares

• Controleu l’ús inicial: vigileu qualsevol problema durant els primers dies

• Recolliu comentaris: pregunteu als traductors sobre la seva experiència en comparació amb la plataforma anterior

• Optimitza el flux de treball: ajusta la configuració en funció de les necessitats del teu equip

• Elimina la plataforma anterior: un cop finalitzada la migració, recorda revocar l’accés concedit a la plataforma anterior.

Truc

Durant la migració, podeu executar ambdues plataformes en paral·lel durant un període de transició per assegurar-vos que tot funcioni com s’esperava abans de canviar completament.

Additional resources

• Integració amb Weblate - Detailed integration patterns

• Fluxos de treball de traducció - Diferents configuracions de flux de treball

• Localització contínua - Localització contínua automatitzada

• API REST del Weblate - API per a automatització i integracions

• Informe de progrés de la traducció - Configuració d’informes de progrés de la traducció

• Preguntes freqüents - Preguntes freqüents

Suggeriment

Uneix-te a la comunitat Weblate si necessites ajuda durant la migració. La comunitat és activa i útil!