Le chiavi vengono utilizzate per identificare stringhe di testo traducibili all'interno del codice software. Ciò consente di usare una chiave (come nome in codice per una stringa traducibile) a cui fare riferimento una sola volta tramite Phrase invece che per ogni traduzione richiesta della stringa.
Una chiave può avere più traduzioni associate, ognuna corrispondente a una diversa lingua impostazioni locali del progetto. La funzione è simile a quella della chiave primaria nei database relazionali, con le traduzioni come attributo della chiave. Le chiavi vengono archiviate nei file di origine e vengono utilizzate per identificare le lingue di origine e destinazione.
Usare le chiavi consente alle piattaforme di gestione della localizzazione di presentare testo traducibile ai traduttori senza dover presentare codice.
Le chiave normalmente non devono essere aggiunte a un progetto poiché vengono idealmente create quando un file di risorse viene caricato tramite la scheda di una pagina del progetto.
Per impedire il caricamento o la creazione di chiave, usare la funzionalità blocco chiave. Se una chiave bloccata esiste già, non può essere tradotta nell'editor.
Per Escludi le chiave dall'esportare, usare la funzionalità Escludi chiave. Le chiave Escludi non possono essere tradotte nemmeno nell'editor.
Le chiave in un progetto possono essere duplicare selezionando Altro/Duplicare chiave nella sezione di una pagina del progetto o nella parte superiore del riquadro Strings Editor.
Diverse chiave di traduzione con gli stessi valori in uno o più progetti possono essere collegate per automatizzare gli aggiornamenti del contenuto. Le chiave collegate vengono usate per garantire la coerenza tra i progetti ed eliminare il lavoro ripetitivo su contenuto identico.
Le modifiche alle chiave possono essere annullate dalla finestra attività della barra laterale nello Strings Editor.
Nota
Quando si lavora con gli archivi (GitHub, GitLab, ecc.) e si eliminano chiavi, queste devono essere eliminate sia da Phrase che dall'archivio affinché la loro rimozione sia definitiva. Questo per evitare l'eliminazione accidentale delle chiavi a causa di errori o incidenti in Phrase o nell'archivio.
In Strings, le chiave possono essere di diversi tipi a seconda del formato del file caricato:
-
Stringa (predefinito)
Nota
I traduttori possono modificare solo le chiave di tipo stringa a meno che l'opzione non sia abilitata nelle impostazioni avanzate del progetto.
-
Array
-
Booleano
-
Markdown
-
Numero
Il tipo di chiave viene visualizzato nella sezione della barra laterale dell'editor.
I nomi delle chiavi devono essere univoci all'interno di un progetto.
Esistono diverse strategie per denominare le chiavi:
-
Descrizione
Il testo originale è identificato dalla funzione. Questo potrebbe rendere più difficile identificare il testo durante la lettura del codice, ma rimane una costante.
Esempio:
-
Strings di origine (non consigliato)
Il testo originale stesso viene utilizzato come chiave, il che rende facile identificarne l'utilizzo. Ciò potrebbe risultare problematico poiché, qualora il testo originale dovesse cambiare, la sua relazione con le traduzioni si interromperebbe.
Esempio:
Se le chiavi non vengono caricate, possono essere create manualmente.
Per Crea una chiave, seguire questi passaggi:
-
Dalla scheda , fare clic su Aggiungere chiave.
Si apre la finestra Aggiungere chiave.
-
Dalla scheda , fornire un , una , eventuali
-
Se necessario, Abilita forme plurali dalla scheda e scegliere il tipo di forma plurale.
-
Selezionare le lingue escluse dalla scheda se necessario.
-
Fornire i dettagli tecnici nella scheda se necessario.
Ad esempio, è possibile impostare un limite di carattere per le traduzioni nel campo . Se impostato, il limite di carattere viene visualizzato da un indicatore nello Strings Editor durante la modifica delle traduzioni della chiave pertinente.
-
Clicca su Salva.
La chiave viene aggiunta al progetto e può essere visualizzata nella scheda .
Elimina una chiave dall'editor o dalla scheda eliminerà tutte le traduzioni associate di tale chiave e non può essere annullato.
Nei progetto con più di 10.000 chiave, le chiave non menzionate non verranno calcolate nei caricare successivi. Le chiave non menzionate sono chiave che non sono incluse nel caricare corrente ma che esistono ancora nel progetto.
Il blocco impedisce che intere chiave vengano aggiungere a un progetto; se il nome di una chiave bloccata appare in un file caricare, quella chiave viene omessa e non aggiungere al progetto.
Il blocco viene utilizzato per omettere chiave da un progetto in modo che non vengano gestite affatto.
Chiavi che vengono tipicamente bloccate:
-
Stringhe di formato data e ora.
-
chiave che includono configurazioni.
-
chiave che causano problemi quando gestite con la Phrase gem.
Gestire le chiave bloccate in un file lingua separato che non viene elaborato o mantenuto.
Queste chiave possono causare problemi e, se utilizzate, dovrebbero essere bloccate quando viene creato un progetto.
-
activemodel.errors* -
number.format* -
number.currency* -
number.percentage* -
datetime.prompts*
Per bloccare una chiave, seguire questi passaggi:
-
Da una pagina progetto, Seleziona la scheda .
-
Fare clic su Add key to the blocked keys list.
Si apre la finestra .
-
Fornire un nome per la chiave o un'espressione regolare (regex) e fare clic su Salvare.
La chiave viene aggiunta all'elenco.
Consiglio
I chatbot IA possono essere molto efficaci nel generare e verificare regex.
Usare Strumenti come Regex101 per testare regex con input diversi.
Le chiavi possono essere successivamente modificare facendo clic su o eliminate
.
Alcune chiavi potrebbero dover essere escluse da determinate lingue e possono essere contrassegnate come escluse. Queste chiavi vengono caricate ed esistono all'interno di un progetto, ma vengono ignorate.
Le traduzioni escluse sono:
-
Escluso dall'esportare della lingua correlata.
-
Escluse dai report della lingua correlata.
Se il contenuto è vuoto non viene conteggiato come non tradotto.
-
Visibile ma non modificabile nell'editor di traduzione.
Opzioni di esclusione:
-
Escludere una singola traduzione in una lingua all'interno dell'editor di traduzione.
-
Escludere traduzioni multiple in una lingua all'interno dell'editor di traduzione.
-
Escludere traduzioni multiple selezionando le lingue durante la creazione o la modifica della chiave.
Per escludere una chiave, seguire questi passaggi:
-
Dalla pagina delle chiavi, fare clic su
per la chiave che richiede l'esclusione.
Si apre la finestra .
-
Selezionare la scheda .
-
Selezionare le lingue per l'esclusione.
-
Clicca su Salva.
La selezione è esclusa nella chiave specificata.
Le chiavi possono anche essere escluse singolarmente o in blocco dall'editor key list selezionando la/le chiave/i e utilizzando il menu .