In questo argomento, vi guideremo attraverso le funzionalità di localizzazione dei contenuti e come attivarle. Le funzionalità sono divise in due parti: ciò che è disponibile di default in Discourse; e Discourse AI per le traduzioni automatiche.
Per un accesso rapido alle sezioni pertinenti, utilizzate le intestazioni della wiki 
Localizzare i contenuti della vostra community
Una versione aggiornata di Discourse (3.5.0.beta7-dev) vi offre accesso a diverse funzionalità di localizzazione configurabili all’indirizzo:
<your-site-url>/admin/site_settings/category/content_localization
Ottenere informazioni sui vostri utenti
Innanzitutto, è utile raccogliere alcune informazioni sulla vostra community. La seguente query di Data Explorer può darvi un’idea di quanti utenti abbiano 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
Impostare le lingue supportate dalla vostra community
Con le informazioni sopra riportate, ora abbiamo una visione più chiara di quali lingue la vostra community dovrebbe supportare.
In <your-site-url>/admin/site_settings/category/content_localization, potete selezionare le lingue da supportare.
Content localization enabled- attiva la funzionalità che sostituisce i contenuti originali scritti dagli utenti con contenuti localizzati. Continuate a leggere per scoprire le modalità automatica e manuale di localizzazione.Content localization supported locales- l’elenco delle lingue supportate dal vostro sitoContent localization crawler param- trattato nella sezione sui crawler più avantiContent localization language switcher- trattato subito sotto
Abilitando l’impostazione successiva Content localization language switcher, è anche possibile rendere la vostra community più accessibile agli utenti non registrati, mostrando l’elenco delle lingue scelte nell’elenco delle lingue supportate:
Visualizzare i contenuti localizzati
Per i visualizzatori di contenuti localizzati (tutti i visitatori del sito), è possibile 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.
Se un utente desidera vedere solo i contenuti originali, può utilizzare l’interruttore sopra la cronologia dell’argomento per disabilitare le localizzazioni per l’intero sito.
Traduzioni automatiche con Discourse AI 
Discourse AI sono le vitamine essenziali per la funzionalità di localizzazione ed eliminano la necessità di effettuare traduzioni manuali.
Come amministratore, dovrete recarvi nella nuova sezione delle funzionalità AI per la Traduzione.
Funzionalità di Discourse AI nelle impostazioni di amministrazione 📸
Per coprire alcune impostazioni e raccomandazioni importanti:
AI translation backfill hourly rate- questa impostazione ha un valore predefinito di50. Assumendo un tasso di 50, il vostro sito tradurrà 50 post, 50 argomenti e 50 categorie all’ora, nelle lingue impostate inContent localization supported locales. Mantenete questo valore basso quando iniziate.AI translation target categories- predefinito su nessuna categoria selezionata. Solo i contenuti nelle categorie selezionate verranno tradotti. Le sottocategorie devono essere aggiunte separatamente. Lasciate vuoto per disabilitare la traduzione degli argomenti nelle categorie.AI translation personal messages- predefinito sunone. Controlla quali messaggi personali vengono tradotti. ‘none’ disabilita la traduzione dei PM. ‘group’ traduce solo i PM di gruppo. ‘all’ traduce tutti i PM.AI translation include bot content- predefinito sufalse. Se abilitato, anche i post degli utenti bot (user id < 0) verranno tradotti. Di default, i contenuti dei bot sono esclusi dalla traduzione.AI translation max post length- predefinito su10000. Questa è una misura di sicurezza che impedisce la traduzione di post superiori a una certa lunghezza.AI translation backfill max age days- predefinito su5. Ciò significa che gli argomenti e i post più vecchi di 5 giorni non verranno tradotti. Potete aumentare questo valore a un numero elevato per tradurre tutti gli argomenti e i post.AI translation post raw translator agent(e altri agenti) - In community più formali, gli amministratori possono scegliere di creare il proprio agente. Questo permette di impostare un prompt più accurato per la lingua o il vocabolario preferito.
Potete consultare AI bot - Agents per sapere come configurare agenti adatti e affinare i prompt per ciascuna funzione.
Stato della traduzione
Potete trovare ulteriori informazioni sull’avanzamento delle traduzioni automatiche nel grafico Stato della traduzione in /admin/plugins/discourse-ai/ai-translations
Questo grafico apparirà se:
- tutti gli agenti traduttori hanno un LLM valido
discourse ai enabled
ai translation enabledcontent localization supported localesè compilatoai translation backfill max age daysè maggiore di 0ai translation backfill hourly rateè maggiore di 0
Localizzazione manuale
Poiché la localizzazione è una funzionalità fondamentale in Discourse, offriamo la possibilità di inserire e modificare manualmente le localizzazioni nel caso in cui le traduzioni automatiche con Discourse AI non siano disponibili.
Di default, gli amministratori e i moderatori sono configurati per modificare le localizzazioni.
Gruppi autorizzati alla localizzazione nelle impostazioni del sito 📸
Attualmente, abbiamo localizzazioni per il contenuto del post, il titolo dell’argomento, il nome della categoria, la descrizione della categoria e i tag. Le sezioni successive 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, barra laterale e menu a discesa delle categorie
- Pagina delle categorie
- Una categoria specifica con sottocategorie
Come amministratore, dovreste essere in grado di accedere alle impostazioni della categoria come al solito e trovare il nuovo elemento di navigazione “Localizzazioni” sulla sinistra.
Localizzazione di argomenti e post
Dagli screenshot precedenti in Localizzazione delle categorie, potreste aver notato che i titoli degli argomenti e gli estratti vengono localizzati.
Ci sono alcune impostazioni preliminari:
- Assicuratevi che il vostro utente sia nei
content localization allowed groups - Il pulsante
addTranslationviene aggiunto automaticamente apost menuepost menu hidden itemsquandoContent localization enabledè attivo. Questo permette all’icona
di apparire nel menu del post per gli utenti nei 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 menzionato.
Ancora una volta, l’elenco delle lingue localizzabili si trova nell’impostazione Content localization supported locales menzionata 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:
Dopo aver deciso, apparirà l’editor appropriato.
Eliminazione della traduzione di un post per una determinata lingua
Se avete seguito correttamente le istruzioni sopra riguardanti l’impostazione post menu, dovreste essere in grado di fare quanto segue se siete nei Content localization allowed groups:
Crawlers
Potete permettere ai crawler di vedere il vostro sito nelle varie lingue configurate in Content localization supported locales. L’impostazione del sito si trova nella sezione “Content localization” come Content localization crawler param:
Il risultato sarà che i crawler potranno vedere quanto segue, dove ogni lingua supportata ha un corrispondente hreflang nell’head di ogni argomento:
Per ulteriori prove/verifiche
Abbiamo testato questa funzionalità estensivamente e possiamo confermare che siamo indicizzati correttamente dopo aver introdotto X numeri di lingue supportate
FAQ
Ho configurato tutto, ma la traduzione automatica non funziona ancora per me
Verificate se avete impostato quanto segue:
Content localization supported localesha almeno una linguaContent localization enabledè
Allow user localeè (abilitato di default)Set locale from cookieè
Ai translation enabledèAi translation backfill max age daysnon è 0Ai translation backfill hourly rateè maggiore di 12- Dovete avere un LLM funzionante impostato per ogni agente di traduzione
Se tutto il resto fallisce, potete abilitare SiteSetting.ai_translation_verbose_logs.
Ogni post viene tradotto?
Se AI translation backfill limit to public content è , tutti i post nelle categorie pubbliche verranno tradotti. Di default, i post dei bot (user id < 0) sono esclusi a meno che AI translation include bot content non sia abilitato.
Le traduzioni automatiche vengono salvate o vengono inviate all’LLM ogni volta che qualcuno visualizza un argomento?
Le traduzioni vengono salvate; ogni post viene inviato una sola volta per lingua e le traduzioni vengono riutilizzate.
Se il mio forum supporta l’inglese e il giapponese (tramite Content localization supported locales) e qualcuno scrive in spagnolo, il suo post verrà tradotto?
Sì. Tutti gli argomenti e i post verranno tradotti in inglese e giapponese, indipendentemente dalla lingua scritta.
Se il post originale viene modificato, viene ripreso e tradotto di nuovo?
Sì – con un massimo di 2 volte al giorno. Quando un post viene modificato, viene inviato per la rielaborazione dopo un ritardo pari al massimo tra 5 minuti o il SiteSetting.editing_grace_period per tenere conto delle modifiche “ninja”. Gli utenti autorizzati nei Content localization allowed groups hanno la possibilità di inviare immediatamente un post alla rielaborazione.
Le traduzioni verranno eliminate se cambio l’agente o l’LLM?
No, le traduzioni generalmente persistono attraverso le modifiche alle impostazioni, a meno che non vengano eliminate esplicitamente utilizzando l’elemento del menu del post o l’editor di traduzione.