Using Localization Files (Strings)

Per caricare file in Strings, segui i passaggi riportati di seguito:

Dalla pagina di qualsiasi progetto, seleziona Uploads dal menu More per accedere all’archivio da caricare.

L'archivio carica elenca tutti i uploads storici in tutti gli stati possibili. Fai clic sul menu a discesa Tutti gli stati per filtrare i uploads per stato (Riuscito, Non riuscito e/o In avanzamento). Per individuare un caricare specifico, usare la Box di ricerca in alto per cercare per nome.

Accedi caricando riepiloghi dettagliati delle risorse interessate facendo clic su un caricamento elencato. Tutti i uploads riusciti vengono presentati anche nel flusso di attività di un progetto.

Le opzioni da scaricare vengono presentate quando si scarica un file nella finestra Download con le schede Generale, Avanzato e Codifica.

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

Per impostazione predefinita, le risorse traducibili vengono archiviate come chiavi e valori anziché mantenere la struttura originale dei file. Ciò consente formati di file intercambiabili senza essere bloccati in un formato, nonché un raggruppamento flessibile utilizzando tags.

Alcuni framework o configurazioni richiedono più file di origine richiedendo anche configurazioni aggiuntive.

Mantenimento di file separati

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

Se i file di localizzazione devono essere mantenuti in file separati, è possibile utilizzare un flusso di lavoro basato su file contrassegnando le chiavi quando vengono caricate e utilizzando i tags come riferimento durante il download delle chiavi tradotte nei file originali. Le chiavi possono contenere più tags ed essere incluse in più file garantendone il riutilizzo e la coerenza. Un flusso di lavoro basato su tag è flessibile e consente la riorganizzazione delle risorse di traduzione senza dover essere caricato nei progetti.

Assegna nomi univoci alle chiavi in tutti i file per garantire un flusso di lavoro senza intoppi. In un approccio basato su valori chiave, a una chiave devono essere assegnati gli stessi valori in ogni contesto. Alcuni framework consentono di usare 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 sono automaticamente coperte dai domini basati su nomi di file, ma questo può essere risolto utilizzando un prefisso di dominio univoco per le chiavi all'interno del file.

Esempio di configurazione della CLI

Se lavori con la CLI o colleghi un progetto con un archivio (ad esempio GitHub, GitLab o Bitbucket), configura un file di configurazione per gestire uploads e downloads.

Ad esempio, un progetto ha diversi file di traduzione con nome semantico per le impostazioni locali di origine. Ad esempio: accounts.en.yml, emails.en.yml, ecc. Questi nomi semantici sono gestiti tramite tags.

Configurare il .phrase.yml per riflettere l'organizzazione dei file nel progetto di localizzazione e collegarli ai tags nel progetto Strings includendo il tag segnaposto 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:
      # account
      - file: ./path/to/impostazioni locali/accounts.<nome_locale>.yml
        params:
          tags: account
      # email
      - file: ./path/to/impostazioni locali/emails.<locale_name>.yml
        params:
          tags: email

Anche i tag dei parametri possono essere utilizzati nella sezione push invece di utilizzare il <tag> segnaposto.

La configurazione crea chiavi con tags in base al file da cui provengono durante l'esecuzione di un push o l'attivazione della sincronizzazione da un archivio. Quando esegui pull o attivi l’esportazione nell’archivio, raggruppa le chiavi in file in base ai tags.

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

È necessaria un’ulteriore distinzione se:

Localizzazione di 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 nuovi contenuti (chiavi), è difficile applicare tali aggiornamenti a più progetti e mantenerli sincronizzati. usare lingue dedicate all'interno di un progetto per mantenerle.

I codici lingua che seguono la norma ISO (ad esempio en-US) non devono essere univoci, quindi è possibile creare all’interno di un progetto molte versioni della stessa lingua. Distinguere tra regioni, clienti o destinatari utilizzando un nome univoco della lingua.

Durante la configurazione, qualsiasi chiave introdotta di recente nelle impostazioni locali predefinite appariva come non tradotta nelle altre lingue e veniva localizzata di conseguenza. Se lavori con un cliente e i suoi stessi traduttori, assegna loro specificamente di poter modificare le loro versioni linguistiche solo aggiornando la lingua accessibile nel loro profilo utente o la gestione degli utenti del progetto.

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