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 da phrase anziché per ogni traduzione richiesta della stringa.
A una chiave possono essere associate più traduzioni, ognuna corrispondente a diverse impostazioni locali linguistiche 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.
In genere non è necessario aggiungere chiavi a un progetto perché vengono idealmente create quando viene caricato un file di risorse attraverso la scheda della pagina di un progetto.
Per evitare che le chiavi vengano caricate o create, usa la funzionalità chiave di blocco. Se una chiave bloccata esiste già, non può essere tradotta nell'editor.
Per escludere chiavi dall'esportazione, usa la funzionalità Escludi chiavi. Anche le chiavi escluse non possono essere tradotte nell'editor.
Le chiavi in un progetto possono essere duplicate selezionando Altro/Duplica chiave nella sezione della pagina di un progetto o nella parte superiore del pannello Strings editor.
Chiavi di traduzione diverse con gli stessi valori in uno o più progetti possono essere collegate per automatizzare gli aggiornamenti dei contenuti. Le chiavi collegate vengono utilizzate per garantire la coerenza tra progetti ed eliminare lavori ripetitivi su contenuti identici.
Le modifiche alle chiavi possono essere annullate dalla finestra di attività della barra laterale in 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.
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 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 creare una chiave, segui i passaggi riportati di seguito:
-
Dalla scheda fare clic su Aggiungi chiave.
Si apre la finestra Aggiungi chiave.
-
Dalla scheda , fornisci un , , tutti i disponibili e una .
-
Abilita le forme plurali dalla scheda , se necessario.
-
Seleziona le lingue escluse dalla scheda , se necessario.
-
Fornire dettagli tecnici nella scheda , se necessario.
Ad esempio, è possibile impostare un limite di caratteri per le traduzioni nel . Se impostato, il limite di caratteri viene visualizzato da un indicatore in Strings editor durante la modifica delle traduzioni della chiave rilevante.
-
Fai clic su Salva.
La chiave viene aggiunta al progetto ed è possibile visualizzarla nella scheda .
L'eliminazione di una chiave dall'editor o dalla scheda eliminerà tutte le traduzioni associate di quella chiave ed è irreversibile.
Nei progetti con più di 10.000 chiavi, le chiavi non menzionate non verranno calcolate negli ulteriori uploads.
Il blocco impedisce che intere chiavi vengano aggiunte a un progetto; se il nome di una chiave bloccata appare in un file caricato, quella chiave viene omessa e non aggiunta al progetto.
Il blocco viene utilizzato per omettere chiavi da un progetto in modo che non vengano gestite affatto.
Chiavi in genere bloccate:
-
Strings formato data e ora.
-
Chiavi incluse configurazioni.
-
Chiavi che causano problemi se gestite con il gem phrase.
Gestisci le chiavi bloccate in un file di lingua separato che non viene elaborato o mantenuto.
Queste chiavi 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, segui i passaggi riportati di seguito:
-
Dalla pagina di un progetto, seleziona la scheda .
-
Fare clic su Aggiungi chiave all'elenco delle chiavi bloccate.
Si apre la finestra delle chiavi bloccate.
-
Indicare un nome per la chiave o un'espressione regolare (regexp) e fare clic su Salva.
La chiave viene aggiunta all'elenco.
Consiglio
I chatbot IA possono essere molto efficaci nel generare e verificare regexp.
Usa Strumenti come Regex101 per testare regexp con input diversi.
Le chiavi possono essere successivamente modificate facendo clic su o su
eliminate.
Alcune chiavi possono aver bisogno di 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.
Traduzioni escluse sono:
-
Escluse dall’esportazione della lingua correlata.
-
Escluse dai rapporti sulle lingue correlati.
Se il contenuto è empty non viene contato come non tradotto.
-
Visibile ma non modificabile nell'editor di traduzione.
Opzioni di esclusione:
-
Escludi una singola traduzione in una lingua all'interno dell'editor di traduzione.
-
Escludi traduzioni multiple in una lingua all'interno dell'editor di traduzione.
-
Escludi traduzioni multiple selezionando le lingue durante la creazione o la modifica della chiave.
Per escludere una chiave, segui i passaggi riportati di seguito:
-
Dalla pagina della chiave fare clic su
per la chiave che richiede l'esclusione.
Si apre la finestra .
-
Seleziona la scheda .
-
Seleziona le lingue per l'esclusione.
-
Fai clic su Salva.
La selezione è esclusa nella chiave specificata.
Le chiavi possono anche essere escluse individualmente o in blocco dall'elenco chiavi editor selezionando le chiavi e utilizzando il menu .