Utilizzo dei file di localizzazione (Strings)

Per caricare file in Strings, segui questi passaggi:

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

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

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

Le opzioni di download vengono presentate quando si scarica un file nella finestra Scarica con schede per Generale, Avanzate e Codifica.

Selezionando diversi formati file si presentano diverse opzioni. Per ulteriori dettagli, fare riferimento all'articolo pertinente riguardante il formato file specifico.

Facoltativamente, utilizzare 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 traducibili sono memorizzate come chiavi e valori invece di mantenere la struttura originale del file. Questo consente formati file intercambiabili senza essere bloccati in un formato e una flessibile raggruppamento utilizzando tag.

Alcuni framework o configurazioni richiedono più file sorgente che richiedono anche configurazioni aggiuntive.

Mantenere file separati

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

Se i file di localizzazione devono essere mantenuti in file separati, è possibile utilizzare un flusso di lavoro basato su file etichettando le chiavi al momento del caricamento e utilizzando le etichette come riferimento quando si scaricano le chiavi tradotte nei file originali. Le chiavi possono avere più etichette e essere incluse in più file garantendo riutilizzo e coerenza. Un flusso di lavoro basato su etichette è flessibile e consente la riorganizzazione delle risorse di traduzione senza dover essere caricate nei progetti.

Dai alle chiavi nomi unici 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. Al alcuni framework consentono l'uso di chiavi non uniche su più file. Alcuni formati, come Symfony, supportano i domini dei messaggi. Questi domini vengono rilevati dal nome del file. Le chiavi non sono automaticamente scoperte dai domini basati sul nome del file, ma questo può essere risolto utilizzando un prefisso di dominio unico per le chiavi all'interno del file.

Esempio di configurazione CLI

Se lavori con CLI o colleghi un progetto con un archivio (ad es. GitHub, GitLab o Bitbucket), configura un file di configurazione per gestire caricamenti e download.

Per l'esempio, un progetto ha diversi file di traduzione nominati semanticamente per la lingua sorgente. Ad esempio: accounts.en.yml, emails.en.yml ecc. Questi nomi semantici sono gestiti tramite etichette.

Configura il .phrase.yml per riflettere l'organizzazione dei file nel progetto di localizzazione e collegali alle etichette nel progetto Strings includendo il segnaposto dell'etichetta 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:
          etichette: accounts
      # email
      - file: ./path/to/locales/emails.<locale_name>.yml
        params:
          tags: email

I tag dei parametri possono essere utilizzati anche nella sezione di push invece di utilizzare 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'esportazione nell'archivio, raggruppa le chiavi in file in base ai loro tag.

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

È necessaria una ulteriore distinzione se:

Localizzare un prodotto statico

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

Localizzare un progetto con aggiornamenti continui

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

I codici lingua seguendo lo standard ISO (ad es. en-US) non devono essere unici, quindi molte versioni della stessa lingua possono essere create all'interno di un progetto. Distinguere tra regioni, clienti o pubblici utilizzando un nome lingua unico.

Quando configurato, qualsiasi chiave introdotta di recente nella locale predefinita apparirebbe come non tradotta nelle altre lingue e sarebbe localizzata di conseguenza. Se lavori con un cliente e i loro traduttori, assegnali specificamente per poter modificare solo le loro versioni linguistiche aggiornando l'accesso alla lingua nel loro profilo utente o nella gestione utenti del progetto.

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