In questa guida, ti illustreremo le funzionalità di Localizzazione dei Contenuti e come abilitarle. Le funzionalità sono suddivise in due parti: ciò che è disponibile di default in Discourse; e Discourse AI per le traduzioni automatiche.
Per un accesso rapido alle sezioni rilevanti, utilizza le intestazioni della wiki 
Localizzazione dei Contenuti della Tua Community
Discourse ti dà accesso a diverse funzionalità di localizzazione configurabili in:
<your-site-url>/admin/site_settings/category/content_localization
Preparazione
Innanzitutto, è utile raccogliere alcune informazioni sulla tua community tramite Data Explorer.
Lingua tramite preferenze utente
La seguente query può darti un’idea di quanti utenti potrebbero aver impostato la propria lingua in /my/preferences/interface.
SELECT locale, count(*) as count
FROM users
WHERE (locale IS NOT null AND locale <> '')
GROUP BY locale
ORDER BY count DESC
Da dove provengono i tuoi utenti
Una soluzione migliore, se hai abilitato Browser pageview events (impostazione del sito), è questa query che ti indica da quale paese proviene il tuo utente:
SELECT
e.country_code AS country_code,
COUNT(*) AS pageviews
FROM browser_pageview_events e
WHERE e.country_code IS NOT NULL
AND e.country_code <> ''
GROUP BY e.country_code
ORDER BY pageviews DESC
Configurazione
Con le informazioni sopra, ora sei più informato su quali lingue la tua community dovrebbe supportare.
In <your-site-url>/admin/site_settings/category/content_localization, inizia a configurare.
Content localization enabled- attiva la funzionalità che sostituisce il contenuto scritto originale con il contenuto localizzato. Continua a leggere per le modalità di localizzazione automatica (AI) e manuale (umana).Content localization supported locales- l’elenco delle lingue supportate dal tuo sitoContent localization crawler param- trattato nella sezione crawler qui sottoContent localization language switcher- trattato qui sotto
Selettore lingua
Abilitando l’impostazione successiva Content localization language switcher, puoi anche rendere la tua community più accessibile agli utenti non connessi mostrando l’elenco delle lingue che hai scelto nell’elenco delle lingue supportate:
Visualizzazione dei contenuti localizzati
Per i visualizzatori di contenuti localizzati (tutti i visitatori del sito), possono passare il cursore sull’indicatore accanto alla data del post per visualizzare la lingua originale del post. Questo indicatore appare solo se il post non è nella loro lingua. Possono semplicemente toccare l’indicatore per vedere anche il post originale.
Per i nostri visualizzatori multilingue connessi, possono indicare che comprendono più lingue, quindi i contenuti in quelle lingue non verranno tradotti.
Traduzioni automatiche con Discourse AI 
Discourse AI è fondamentale per la funzionalità di localizzazione e elimina la necessità di effettuare traduzioni manuali.
Come amministratore, vorrai recarti nella nostra area dedicata in Discourse AI per le Traduzioni. Questa area dedicata copre:
- progresso della traduzione
- impostazioni AI
- impostazioni lingua dell’app
Per coprire alcune impostazioni e raccomandazioni importanti:
AI translation backfill hourly rate- questa impostazione di default è50- il tuo sito tradurrà 50 post, 50 topic, 50 categorie, 50 tag all’ora, nelle lingue che hai impostato inContent localization supported locales. Mantieni questo numero basso all’inizio.AI translation category scope- di defaultCategorie pubbliche. Puoi cambiarlo in tutte le categorie o in una selezione specifica.AI translation personal messageseAI translation include bot contentsono autoesplicativi.AI translation backfill start date- questo valore è vuoto di default. Se abiliti la funzionalità di traduzione AI “oggi”, la data è impostata automaticamente su “oggi - 5 giorni”AI translation post raw translator agent(e altri agenti) - In community più formali, gli amministratori possono scegliere di creare il proprio agente. Questo ti permette di impostare un prompt più raffinato per la lingua o il vocabolario che preferisci.
Puoi fare riferimento a AI bot - Agents su come configurare agenti adatti e affinare i prompt per ciascuna funzione.
Localizzazione manuale
Poiché la localizzazione è una funzionalità fondamentale in Discourse, forniamo la possibilità di compilare e modificare le localizzazioni manualmente nel caso in cui le traduzioni automatiche con Discourse AI non siano disponibili.
Di default, amministratori e moderatori sono impostati per modificare le localizzazioni.
Attualmente, abbiamo localizzazioni per il contenuto del post, titolo del topic, nome della categoria, descrizione della categoria, nome del tag, descrizione del tag e sidebar. Le sezioni successive qui sotto ti mostreranno come funzionano.
Localizzazione delle categorie
Le categorie localizzate sono visibili nelle seguenti aree, con sia il nome che la descrizione della categoria localizzati:
Luoghi in cui le categorie sono localizzate 📸
- Homepage, sidebar e menu a tendina delle categorie
- Pagina delle categorie
- Una categoria specifica con sottocategorie
Come amministratore, dovresti essere in grado di accedere alle impostazioni della categoria come al solito e trovare la nuova voce di navigazione “Localizzazioni” a sinistra.
Localizzazione di Topic e Post
Dalle screenshot sopra in Localizzazione delle categorie, potresti aver notato che i titoli dei topic e gli estratti sono localizzati.
Ci sono alcune impostazioni prerequisito
- Assicurati che il tuo utente sia in
content localization allowed groups - Il pulsante
addTranslationviene aggiunto automaticamente apost menuepost menu hidden itemsquandoContent localization enabledè attivato. Questo permette alla
di comparire nel menu del post per gli utenti in content localization allowed groups. Content localization allow author localizationè abilitato di default e permette agli autori dei post di localizzare i propri contenuti utilizzando lo stesso menu del post sopra.
Modifica di un post localizzato
Nel caso in cui l’utente stia visualizzando un post localizzato e voglia modificarlo, apparirà una finestra di dialogo per chiedere quale versione preferisce modificare:
Apparirà l’editor appropriato dopo la decisione.
Localizzazione della sidebar personalizzata
Le sezioni della sidebar che sono “visibili a tutti” mostrano anche controlli di traduzione aggiuntivi:
Crawler
Puoi consentire ai crawler di vedere il tuo sito nelle varie lingue che hai configurato in Content localization supported locales. L’impostazione del sito risiede nella sezione “Content localization” come Content localization crawler param:
Il risultato sarà che i crawler possono vedere il seguente, dove ogni lingua supportata ha un hreflang corrispondente nell’head di ogni topic:
Per prova / verifica extra
Abbiamo testato estensivamente questa funzionalità e possiamo confermare di essere indicizzati correttamente dopo l’introduzione di X numero di lingue supportate
FAQ
Ho configurato tutto, ma la traduzione automatica non funziona ancora per me
Conferma se hai configurato questi elementi
Content localization supported localesha almeno una linguaContent localization enabledè
Allow user localeè (abilitato di default)Set locale from cookieè
Ai translation enabledè- Devi avere un LLM funzionante impostato per ogni agente di traduzione
Se tutto il resto fallisce, puoi abilitare SiteSetting.ai_translation_verbose_logs.
Le traduzioni automatiche sono salvate, o vengono inviate al LLM ogni volta che qualcuno visualizza un topic?
Le traduzioni sono salvate, ogni post viene inviato solo una volta per lingua e le traduzioni vengono riutilizzate.
Se il mio forum supporta inglese e giapponese (tramite Content localization supported locales), e qualcuno scrive in spagnolo, il suo post verrà tradotto?
Sì. Tutti i topic e i post verranno tradotti in inglese e giapponese, indipendentemente dalla lingua scritta.
Se il post originale viene modificato, viene ritradotto?
Sì – con un massimo di 2 volte al giorno. Quando un post viene modificato, viene inviato per la ritraduzione dopo un ritardo maggiore tra 5 minuti e SiteSetting.editing_grace_period per tenere conto delle modifiche ninja. Gli utenti autorizzati in Content localization allowed groups hanno l’opzione di inviare un post per la ritraduzione immediata.
Le traduzioni verranno eliminate se cambio l’Agente o il LLM?
No, le traduzioni tipicamente persistono attraverso i cambiamenti delle impostazioni a meno che non vengano esplicitamente eliminate utilizzando la voce del menu del post o l’editor di traduzione.