Caricamento e download di file di localizzazione (Strings)

Per caricare file in Strings, seguire questi passaggi:

Da qualsiasi pagina del progetto, selezionare Caricamenti dal menu Altro per accedere all'archivio caricamenti.

L'archivio caricamenti elenca tutti i caricamenti storici in tutti i possibili stati. Fai clic sul menu a discesa Tutti gli stati per filtrare i caricamenti in base allo stato (Successo, Non riuscito e/o In avanzamento). Per individuare un caricamento specifico, usare la casella di ricerca in alto per cercare per nome.

Accedere ai riepiloghi dettagliati del caricamento delle risorse interessate facendo clic su un caricamento elencato. Tutti i caricamenti riusciti vengono presentati anche nel flusso di attività di un progetto.

Le opzioni di download vengono presentate durante il download di un file nella finestra Download con schede per Generale, Avanzate e Codifica.

La selezione di diversi formato file presenta opzioni diverse. Per ulteriori dettagli, fare riferimento all'articolo pertinente sul specifico formato file.

Facoltativamente, usare il campo Nome file nella scheda Generale per specificare un nome file di esportazione Personalizzato, oppure lasciarlo vuoto per generare un nome definito dal sistema.

Per impostazione predefinita, le risorse traducibile vengono archiviate come chiavi e valori invece di mantenere la struttura originale del file. Ciò consente formati di file intercambiabili senza essere bloccati in un unico formato, oltre a un raggruppamento flessibile tramite tag.

Alcuni framework o configurazioni richiedono più file di origine che necessitano anche di una configurazione aggiuntiva.

Mantenere file separati

In generale, mantenere tutte le traduzioni per ogni lingua in un unico file. Ciò rende i download delle risorse più veloci e più robusti. Le traduzioni sono mantenute organizzate nei progetti, quindi non sono necessari piccoli file separati.

Se è necessario mantenere i file di localizzazione in file separati, è possibile utilizzare un flusso di lavoro basato su file contrassegnando le chiavi al momento del caricamento e utilizzando i tag come riferimento durante il download delle chiavi tradotte nei file di origine. Le chiavi possono avere più tag ed essere incluse in più file, garantendo riutilizzo e coerenza. Un flusso di lavoro basato su tag è flessibile e consente la riorganizzazione delle risorse di traduzione senza dover essere caricate nei progetti.

Assegna alle chiavi nomi univoci in tutti i file per garantire un flusso di lavoro fluido. In un approccio basato su chiave-valore, una chiave deve avere gli stessi valori assegnati in ogni contesto. Alcuni framework consentono l'uso di chiavi non univoche su più file. Alcuni formati, come Symfony, supportano i domini dei messaggi. Questi domini vengono rilevati dal nome del file. Le chiavi non vengono automaticamente delimitate da domini basati sul nome del file, ma questo può essere risolto usando un prefisso di dominio univoco per le chiavi all'interno del file.

Esempio di configurazione CLI

Se si lavora con CLI o si collega un progetto a un archivio (ad es. GitHub, GitLab o Bitbucket), configurare un file di configurazione per gestire caricamenti e download.

Per l'esempio, un progetto ha diversi file di traduzione denominati semanticamente per le impostazioni locali di origine. Ad esempio: accounts.en.yml, emails.en.yml ecc. Questi nomi semantici vengono gestiti tramite tag.

Configura il .phrase.yml per riflettere l'organizzazione dei file nel progetto di localizzazione e collegarli ai tag nel progetto Strings includendo il segnaposto tag nel percorso del file:

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.<locale_name>.yml
        params:
          tags: accounts
      # emails
      - file: ./path/to/locales/emails.<locale_name>.yml
        params:
          tags: emails

I tag dei parametri possono anche essere usati nella sezione push invece di usare il segnaposto <tag>.

La configurazione crea chiavi con tag basati sul file da cui provengono quando si esegue un push o si attiva la sincronizzazione da un archivio. Quando si esegue un pull o si attiva l'esportare verso l'archivio, le chiavi vengono raggruppate in file in base ai loro tag.

Un prodotto, sito web o app viene tradotto in diverse lingue, ma in alcuni casi la localizzazione non riguarda solo la lingua scelta, ma diverse versioni all'interno di una stessa lingua.

È necessaria un'ulteriore distinzione se:

Localizzazione di un prodotto statico

Se un prodotto è completamente sviluppato e raramente aggiornato, una versione separata del prodotto può esistere all'interno di un progetto.

Localizzazione di un progetto con aggiornamenti continui

Se un prodotto viene costantemente aggiornato con nuovo contenuto (chiavi), applicare tali aggiornamenti a più progetti e mantenerli sincronizzati è difficile. Usare lingue dedicate all'interno di un progetto per mantenerle.

I codici lingua che seguono lo standard ISO (ad es. en-US) non devono essere univoci, quindi molte versioni della stessa lingua possono essere create all'interno di un progetto. Distinguere tra regioni, clienti o pubblico usando un nome lingua univoco.

Una volta effettuata la configurazione, qualsiasi chiave appena introdotta nelle impostazioni locali predefinite verrebbe visualizzata come non tradotto nelle altre lingue e localizzata di conseguenza. Se si lavora con un cliente e il suo/i suoi traduttore/i, assegnarli specificamente in modo che possano modificare solo le loro versioni lingua aggiornando l'accesso alla lingua nel loro profilo utente o nella gestione utente del progetto.

Configurare processi di localizzazione paralleli con lavori e flussi di lavoro di revisione all'interno dello stesso progetto. Questa flessibilità si estende anche al caricamento e al download di file lingua o processi automatizzati tramite API.