Attention: Here be dragons

This is the latest (unstable) version of this documentation, which may document features not available in or compatible with released stable versions of Godot.

Checking the stable version of the documentation...

Pseudolocalizzazione

Introduzione

Quando si crea un gioco, il processo di localizzazione inizia solitamente al termine dello sviluppo. Ciò significa che le traduzioni non sono disponibili durante lo sviluppo per testare se il progetto è correttamente internazionalizzato.

Godot offre la pseudolocalizzazione al fine di testare la robustezza del progetto con diverse localizzazioni. La pseudolocalizzazione simula i cambiamenti che potrebbero avvenire durante la localizzazione. In questo modo, eventuali problemi di internazionalizzazione si possono individuare dalle prime fasi dello sviluppo.

Vedi anche

È possibile osservare come funziona la pseudolocalizzazione attraverso il progetto demo Pseudolocalizaton.

Abilitare e configurare la pseudolocalizzazione

Per abilitare la pseudolocalizzazione e le relative configurazioni basta attivare una casella di spunta nelle impostazioni del progetto. Queste impostazioni si trovano in Progetto > Impostazioni del progetto >Generale >Internazionalizzazione > Pseudolocalizzazione dopo aver abilitato l'opzione Avanzate nella finestra delle impostazioni del progetto:

La pseudolocalizzazione può anche essere attivata in fase di esecuzione da uno script.

Configurazione della pseudolocalizzazione

La pseudolocalizzazione in Godot si può configurare in base alle esigenze specifiche del progetto. Ecco le proprietà di pseudolocalizzazione che si possono regolare tramite le impostazioni del progetto:

• replace_with_accents: sostituisce tutti i caratteri nella stringa con le loro varianti accentate. "The quick brown fox jumped over the lazy dog" sarà convertito in "Ŧh̀é q́üíćḱ ḅŕôŵή f́ôx́ ǰüm̀ṕéd́ ôṽéŕ ŧh̀é łáźý d́ôǵ" quando questa impostazione è abilitata. Serve per individuare stringhe non tradotte che non avranno accenti, ma è anche utile per individuare i glifi che mancano nei font utilizzati dal progetto.

• double_vowels: raddoppia tutte le vocali nella stringa. È una buona approssimazione per simulare l'espansione del testo durante la localizzazione. Si può utilizzare per individuare testo che potrebbe fuoriuscire dal proprio contenitore (tra cui pulsanti).

• fake_bidi: testo bidirezionale fittizio (simula testo da destra a sinistra). Utile per simulare sistemi di scrittura da destra a sinistra, nonché per verificare potenziali problemi di layout che si presentano nelle lingue che utilizzano sistemi di scrittura da destra a sinistra.

• override: sostituisce tutti i caratteri nella stringa con un asterisco (*). Utile per trovare rapidamente testo che non viene localizzato.

• expansion_ratio: si può utilizzare nei casi in cui raddoppiare le vocali non è un'approssimazione sufficiente. Questa impostazione aggiunge alla stringa dei trattini bassi (_) e la espande del rapporto specificato. Un rapporto di espansione di 0.3 è sufficiente per la maggior parte dei casi pratici; aumenterà la lunghezza della stringa del 30%.

• prefix e suffix: queste proprietà si possono utilizzare per specificare un prefisso e un suffisso in cui racchiudere il testo.

• skip_placeholders: ignora i segnaposto per formattare le stringhe come %s e %f. Utile per identificare i punti in cui sono necessari più argomenti per visualizzare correttamente una stringa formattata.

Tutte queste proprietà si possono attivare o disattivare in base alle esigenze del progetto.

Configurare la pseudolocalizzazione in fase di esecuzione

La pseudolocalizzazione può essere attivata o disattivata in fase di esecuzione attraverso la proprietà pseudolocalization_enabled nel TranslationServer. Tuttavia, se è necessario regolare le proprietà di pseudolocalizzazione in fase di esecuzione, è possibile fare ciò direttamente usando ProjectSettings.set_setting(property, value) e poi chiamando TranslationServer.reload_pseudolocalization(), il quale rianalizza tali proprietà e ricarica la pseudolocalizzazione. Il seguente frammento di codice attiva le proprietà replace_with_accents e double_vowels e poi chiama reload_pseudolocalization() affinché le modifiche vengano applicate:

ProjectSettings.set_setting("internationalization/pseudolocalization/replace_with_accents", true)
ProjectSettings.set_setting("internationalization/pseudolocalization/double_vowels", true)
TranslationServer.reload_pseudolocalization()