Le chiavi vengono utilizzate per identificare stringhe di testo traducibili all'interno del codice software. Ciò consente di utilizzare una chiave (come nome in codice per una stringa traducibile) a cui fare riferimento una sola volta da Phrase anziché per ciascuna traduzione richiesta della stringa.
Una chiave può avere più traduzioni associate, ciascuna corrispondente a una diversa lingua locale 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.
Di norma non è necessario aggiungere chiavi a un progetto, poiché idealmente vengono create quando un file di risorse viene caricato tramite la scheda di una pagina di progetto.
Per impedire il caricamento o la creazione di chiavi, utilizza la funzionalità chiave di blocco. Se una chiave bloccata esiste già, non può essere tradotta nell'editor.
Per escludere le chiavi dall'esportazione, utilizza la funzionalità chiavi da escludere. 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 di stringhe.
Diverse chiavi di traduzione 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 i progetti ed eliminare il lavoro ripetitivo su contenuti identici.
Le modifiche alle chiavi possono essere annullate dalla finestra attività della barra laterale nell'editor di 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 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:
-
Stringhe 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 creare una chiave, segui questi passaggi:
-
Dalla scheda , fai clic su Add key.
Si apre la finestra Add key.
-
Dalla scheda , inserisci un , una , eventuali e una .
-
Se necessario, abilita le Plural forms dalla scheda e scegli il tipo di forma plurale.
-
Seleziona le lingue escluse dalla scheda , se necessario.
-
Fornisci i dettagli tecnici nella scheda , se necessario.
Ad esempio, è possibile impostare un limite di caratteri per le traduzioni nel Characters/span>. Se impostato, il limite di caratteri viene visualizzato da un indicatore nell'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 .
L'eliminazione di una chiave dall'editor o dalla scheda eliminerà tutte le traduzioni associate a tale chiave e non può essere annullata.
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 corrente ma che esistono ancora nel progetto.
Chiavi bloccate
Il blocco impedisce l'aggiunta di intere chiavi a un progetto; se il nome di una chiave bloccata appare in un file caricato, tale chiave viene omessa e non aggiunta al progetto.
Il blocco viene utilizzato per omettere le chiavi da un progetto in modo che non vengano gestite affatto.
Chiavi che vengono tipicamente bloccate:
-
Stringhe di formato di data e ora.
-
Chiavi che includono configurazioni.
-
Chiavi che causano problemi quando gestite con la 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 al momento della creazione di un progetto.
-
activemodel.errors* -
number.format* -
number.currency* -
number.percentage* -
datetime.prompts*
Per bloccare una chiave, segui questi passaggi:
-
Da una pagina di progetto, seleziona la scheda .
-
Fai clic su Aggiungi chiave alla lista delle chiavi bloccate.
Si apre la finestra .
-
Fornisci un nome per la chiave o una espressione regolare (regex) e fai clic su Salva.
La chiave viene aggiunta all'elenco.
Consiglio
I chatbot IA possono essere molto efficaci nel generare e verificare 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 vengono caricate ed esistono all'interno di un progetto, ma vengono ignorate.
Le traduzioni escluse sono:
-
Escluse dall'esportazione 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.
Le traduzioni escluse vengono omesse dai conteggi tradotto/non tradotto e dai report della lingua. Di conseguenza, un progetto o una lingua può mostrare 0 stringhe non tradotte anche quando alle traduzioni escluse manca ancora una traduzione reale. Ciò include contenuto vuoto o una copia non tradotta del testo sorgente. Per confermare che un progetto sia veramente completo, controlla la scheda o interroga le traduzioni con excluded:true tramite l'API, oltre al conteggio delle non tradotte.
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 questi passaggi:
-
Dalla pagina delle chiavi, fai 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 viene esclusa nella chiave specificata.
Le chiavi possono anche essere escluse singolarmente o in blocco dall'elenco chiavi dell'editor selezionando le chiavi e utilizzando il menu .