Caricamento e download di file di localizzazione (Strings)

Per caricare file in Strings, seguire questi passaggi:

Da qualsiasi pagina del progetto, Seleziona Uploads dal menu More per accedere all'archivio caricamenti.

L'archivio caricamenti elenca tutti i caricamenti storici in tutti i possibili stato. Fare clic sul menu a discesa All statuses per filtrare i caricamenti per stato (Success, Failed e/o In progress). 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 Scarica vengono presentate durante il download di un file nella finestra Scarica con schede per Generale, Avanzate e Codifica.

La selezione di diversi formato di file presenta diverse opzioni. Per ulteriori dettagli, fare riferimento all'articolo pertinente sul specifico formato di 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 chiave e valori invece di mantenere la struttura del file di origine. Ciò consente di utilizzare formato di file intercambiabili senza essere bloccato in un unico formato, nonché un raggruppamento flessibile utilizzando tag.

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

Mantenimento di file separati

In generale, mantieni 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 nei progetti, quindi non sono richiesti piccoli file separati.

Se è necessario mantenere i file di localizzazione in file separati, è possibile usare un flusso di lavoro basato su file taggando le chiave al momento del caricare e usando i tag come riferimento quando si scaricano le chiave tradotte nei file originali. Le chiave 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 caricare nei progetti.

Assegna alle chiave 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'usare di chiave non univoche su più file. Alcuni formati, come Symfony, supportano i domini dei messaggi. Questi domini vengono rilevati dal nome del file. Le chiave non sono automaticamente delimitate da domini basati sul nome del file, ma questo può essere risolto usando un prefisso di dominio univoco per le chiave 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 caricare 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 sono gestiti tramite tag.

Configura il .phrase.yml per riflettere l'organizzazione dei file nel progetto di localizzazione e collegali 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/impostazioni locali/accounts.<locale_name>.yml
        params:
          tags: accounts
      # emails
      - file: ./path/to/impostazioni locali/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 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 lingua 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:

Localizzare un prodotto statico

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

Localizzazione di un progetto con aggiornamenti continui

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

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, cliente o pubblico usando un nome di lingua univoco.

Una volta effettuata la configurazione, qualsiasi chiave appena introdotta nelle impostazioni locali predefinite verrebbe visualizzata come non tradotto nelle altre lingua e localizzata di conseguenza. Se si lavora con un cliente e il suo/i suoi traduttore/i, assegnarli specificamente in modo che possano Modifica solo le loro versioni di 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 di lingua o processi automatizzati tramite API.