Questa documentazione spiega come utilizzare la localizzazione dettagliata (verbose localization) per trovare le chiavi di traduzione per il testo personalizzato in Discourse.
Livello utente richiesto: Amministratore
Trovare una chiave di traduzione usando la localizzazione dettagliata
La localizzazione dettagliata è uno strumento potente in Discourse che aiuta gli amministratori a trovare le chiavi di traduzione per il testo personalizzato in modo più efficace. Questo è particolarmente utile quando è necessario tradurre testo che appare in più punti dell’interfaccia utente di Discourse.
Riepilogo
Questa guida copre:
- Abilitare la localizzazione dettagliata.
- Usare la localizzazione dettagliata per identificare le chiavi di traduzione.
- Applicazioni pratiche e casi d’uso comuni.
Abilitare la localizzazione dettagliata
Ci sono diversi modi per abilitare la localizzazione dettagliata, a seconda della configurazione.
Utilizzo della Barra degli strumenti per sviluppatori (consigliato)
La Barra degli strumenti per sviluppatori di Discourse include un interruttore integrato per la localizzazione dettagliata. Questo è il metodo più semplice e funziona sia su siti self-hosted che ospitati.
- Apri la console per sviluppatori del tuo browser sul tuo sito Discourse.
- Esegui:
enableDevTools() - La pagina si ricaricherà e apparirà una barra degli strumenti per sviluppatori sul lato sinistro dello schermo.
- Clicca sull’icona
(scorrimento) nella barra degli strumenti per attivare la localizzazione dettagliata. - La pagina si ricaricherà con la localizzazione dettagliata abilitata.
Lo stato della barra degli strumenti per sviluppatori viene memorizzato nello spazio di archiviazione locale del tuo browser, mentre lo stato della localizzazione dettagliata viene memorizzato nello spazio di archiviazione della sessione. Altri utenti non saranno influenzati.
Utilizzo diretto della console del browser
- Apri l’ispezione web del tuo browser sul tuo sito Discourse.
- Vai alla scheda della console.
- Inserisci il seguente comando JavaScript al prompt:
I18n.enableVerboseLocalizationSession() - Dovresti vedere una risposta simile a:
Utilizzo della console rails (solo self-hosted)
L’impostazione del sito verbose_localization esiste ma è un impostazione di sito nascosta. Non può essere trovata nell’interfaccia amministrativa sotto “Tutte le impostazioni del sito”. Per abilitarla globalmente per tutti gli utenti su un’istanza self-hosted:
- Accedi alla console rails.
- Esegui:
SiteSetting.verbose_localization = true
Questo abilita la localizzazione dettagliata per tutti gli utenti del sito. Preferisci i metodi basati sulla sessione sopra indicati per evitare di ingombrare l’interfaccia utente per gli altri utenti.
Utilizzo della localizzazione dettagliata per trovare una chiave di traduzione
Quando la localizzazione dettagliata è abilitata, vedrai dei numeri visualizzati dopo tutto il testo personalizzabile sul tuo sito.
Passaggi per identificare una chiave di traduzione
- Naviga nell’area contenente il testo che desideri aggiornare. Ad esempio, se stai cercando di modificare la parola “Name” (Nome):
- Cerca il numero di traduzione associato nella console del tuo browser:
- Prendi nota della chiave di traduzione identificata, come ad esempio
user.name.title. - Vai alla barra laterale Amministrazione e digita
site texts(testi del sito) nella barra di ricerca - Inserisci la chiave di traduzione nella casella di ricerca:
- Clicca sul pulsante Modifica del testo e aggiorna il testo secondo necessità.
Best practice
- Usa la localizzazione dettagliata specifica per la sessione per evitare di ingombrare l’interfaccia utente per altri utenti durante le attività di traduzione.
- Documenta le chiavi di traduzione usate di frequente per riferimento futuro.
- Controlla regolarmente gli aggiornamenti nella documentazione di Discourse per rimanere informato sulle nuove funzionalità di localizzazione.
Problemi comuni e soluzioni
Problema: Marcatori di traduzione visibili a tutti gli utenti
Soluzione: Assicurati di abilitare la localizzazione dettagliata esclusivamente per la tua sessione se altri utenti non dovrebbero vederla. Usa la Barra degli strumenti per sviluppatori o il metodo da console I18n.enableVerboseLocalizationSession() invece dell’impostazione globale del sito.
Problema: Difficoltà nel trovare la chiave di traduzione corretta
Soluzione: Usa accuratamente la console e i marcatori di localizzazione dettagliata e verifica incrociata con la pagina Personalizza Testi Sito.
FAQ
D: La localizzazione dettagliata può essere limitata agli amministratori o allo staff?
R: I numeri di localizzazione dettagliata possono essere nascosti agli utenti non tecnici abilitandola nelle singole sessioni tramite la Barra degli strumenti per sviluppatori o la console del browser.
D: Come possono essere verificate le traduzioni delle stringhe?
R: Dopo aver identificato e aggiornato la chiave di traduzione, rivedi le modifiche dell’interfaccia utente in una nuova sessione o scheda del browser.