Le chiavi vengono utilizzate per identificare stringhe di testo traducibili all'interno del codice software. Questo consente l'uso di una chiave (come nome in codice per una stringa traducibile) da fare riferimento solo una volta da Phrase invece che per ogni traduzione richiesta della stringa.
Una chiave può avere più traduzioni associate, ciascuna corrispondente a un diverso locale della lingua 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 chiavi non devono normalmente essere aggiunte a un progetto poiché idealmente vengono create quando un file di risorse viene caricato tramite la scheda di una pagina di progetto.
Per impedire che le chiavi vengano caricate o create, utilizzare la funzionalità chiave di blocco. Se una chiave bloccata esiste già, non può essere tradotta nell'editor.
Per escludere le chiavi dall'esportazione, utilizzare la funzionalità escludi chiavi. Le chiavi escluse non possono essere tradotte nemmeno nell'editor.
Le chiavi in un progetto possono essere duplicate selezionando Altro/Duplica chiave nella sezione di una pagina di progetto o nella parte superiore del riquadro dell'editor delle stringhe.
Chiavi di traduzione diverse con gli stessi valori in uno o più progetti possono essere collegate per automatizzare gli aggiornamenti dei contenuti. Chiavi collegate vengono utilizzate per garantire coerenza tra i progetti ed eliminare il lavoro ripetitivo su contenuti identici.
Le modifiche alle chiavi possono essere annullate dalla finestra di attività barra laterale nell'editor delle stringhe.
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 chiavi possono essere di diversi tipi a seconda del formato del file caricato:
-
Stringa (predefinita)
Nota
I traduttori possono modificare solo le chiavi di stringa a meno che l'opzione non sia abilitata nelle impostazioni avanzate del progetto.
-
Array
-
Booleano
-
Markdown
-
Numero
Il tipo di chiave è 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:
-
Stringhe sorgente (non raccomandato)
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 sono caricate, possono essere create manualmente.
Per creare una chiave, segui questi passaggi:
-
Dalla scheda , clicca su Aggiungi chiave.
Si apre la finestra Aggiungi chiave.
-
Dalla scheda , fornisci un , una , eventuali disponibili e una .
-
Se necessario, abilita forme plurali dalla scheda e scegli il tipo di forma plurale.
-
Se necessario, seleziona le lingue escluse dalla scheda .
-
Fornisci dettagli tecnici nella scheda se necessario.
Ad esempio, è possibile impostare un limite di caratteri per le traduzioni nel campo . Se impostato, il limite di caratteri è visualizzato da un indicatore nell'Editor di stringhe durante la modifica delle traduzioni della chiave pertinente.
-
Clicca su Salva.
La chiave è aggiunta al progetto e può essere visualizzata nella scheda .
Eliminare una chiave dall'editor o dalla scheda eliminerà tutte le traduzioni associate a quella chiave e non può essere annullato.
Nei progetti con più di 10.000 chiavi, le chiavi non menzionate non verranno calcolate nei caricamenti successivi. Le chiavi non menzionate sono chiavi che non sono incluse nel caricamento attuale ma esistono ancora nel progetto.
Il blocco impedisce l'aggiunta di intere chiavi 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 che vengono tipicamente bloccate:
-
Stringhe di formato data e ora.
-
Chiavi che includono configurazioni.
-
Chiavi che causano problemi quando gestite con il gemma 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 questi passaggi:
-
Dalla pagina del progetto, seleziona la scheda .
-
Clicca Aggiungi chiave all'elenco delle chiavi bloccate.
La finestra si apre.
-
Fornisci un nome per la chiave o un espressione regolare (regex) e fai clic su Salva.
La chiave viene aggiunta all'elenco.
Consiglio
I chatbot IA possono essere molto efficaci nella generazione e verifica delle regex.
Usa strumenti come Regex101 per testare le regex con diversi input.
Le chiavi possono essere modificate in seguito facendo clic su o eliminate
.
Alcune chiavi potrebbero dover essere escluse da determinate lingue e possono essere contrassegnate come escluse. Queste chiavi sono caricate e esistono all'interno di un progetto, ma vengono ignorate.
Le traduzioni escluse sono:
-
Escluse dall'esportazione della lingua correlata.
-
Escluse dai rapporti della lingua correlata.
Se il contenuto è vuoto, non viene conteggiato 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 più traduzioni in una lingua all'interno dell'editor di traduzione.
-
Escludi più traduzioni selezionando le lingue durante la creazione o la modifica della chiave.
Per escludere una chiave, segui questi passaggi:
-
Dalla pagina delle chiavi, fai clic su
per la chiave da escludere.
Si apre la finestra .
-
Seleziona la scheda .
-
Seleziona le lingue da escludere.
-
Clicca su Salva.
La selezione è esclusa nella chiave specificata.
Le chiavi possono essere escluse anche singolarmente o in blocco dall'elenco chiavi editor selezionando la/e chiave/i e utilizzando il menu .