Marmite supporta siti multilingue attraverso le language streams. Ogni lingua diventa una stream con la propria pagina di elenco e feed RSS, mentre le traduzioni vengono automaticamente collegate con la navigazione "Disponibile anche in" e tag hreflang per la SEO.
\nLe lingue vengono rilevate automaticamente dai contenuti. Basta impostare language: xx nel frontmatter oppure usare le convenzioni di denominazione delle sottocartelle, e marmite gestisce il resto - nessuna configurazione necessaria.
Il campo language in marmite.yaml (valore predefinito en) determina la lingua predefinita del sito. I contenuti nella lingua predefinita rimangono su index.html. Le altre lingue ottengono le proprie pagine di stream (pt.html, es.html) e feed RSS (pt.rss, es.rss).
Per impostazione predefinita, le language stream vengono etichettate con il loro codice a due lettere (ad esempio "pt", "es"). Per impostare nomi leggibili, aggiungi una sezione opzionale languages in marmite.yaml:
language : en \nlanguages : \n pt : \n display_name : "Portugues" \n es : \n display_name : "Espanol" Questo segue lo stesso pattern di streams: e series: - la configurazione e puramente estetica. I siti senza contenuti multilingue non vengono influenzati in alcun modo.
Ci sono quattro modi per organizzare contenuti multilingue. Tutti producono output HTML piatto.
\nRaggruppa le traduzioni in una sottocartella con il nome dello slug del contenuto base. I file con prefisso di un codice lingua ISO 639-1 vengono automaticamente rilevati e collegati:
\ncontent/hello/\n hello.md # Lingua predefinita (en)\n pt-ola-mundo.md # Traduzione in portoghese\n es-hola-mundo.md # Traduzione in spagnolo\nQuesto genera:
\nhello.html - Post in inglese, elencato in index.htmlpt-ola-mundo.html - Post in portoghese, elencato in pt.htmles-hola-mundo.html - Post in spagnolo, elencato in es.htmlTutte e tre le pagine mostrano automaticamente i link "Disponibile anche in" verso le altre.
\nTip
\nLa sottocartella puo anche avere la data, ad esempio content/2026-07-02-hello/, cosi non devi specificare la data nel frontmatter di ogni traduzione.
Se hai un sito piatto esistente e vuoi aggiungere traduzioni senza spostare i file originali, crea una sottocartella che corrisponda allo slug del contenuto esistente:
\ncontent/\n hello.md # File piatto esistente, slug: hello\n hello/\n pt-ola.md # Traduzione in portoghese, collegata automaticamente\nMarmite rileva che il nome della sottocartella hello corrisponde allo slug del file piatto e li collega come traduzioni.
Important
\nI nomi delle sottocartelle devono corrispondere allo slug del post originale (non il nome del file, ma lo slug risolto, a volte preso dal titolo) per essere collegati automaticamente come traduzioni.
\nOgni traduzione punta allo slug del contenuto originale usando il campo translates. Marmite costruisce automaticamente la rete completa di collegamenti bidirezionali:
--- \ntitle : Ciao Mondo \ndate : 2024-01-01 \nlanguage : it \ntranslates : hello \n--- Questo e piu semplice rispetto al mantenere una lista translations in ogni file. Basta impostare translates su ogni traduzione e marmite collega tutto automaticamente. Quando language e impostato su un valore diverso dalla lingua predefinita del sito e nessuna stream e definita esplicitamente, marmite inserisce automaticamente il contenuto nella stream della lingua corrispondente.
Imposta la lingua e le traduzioni esplicitamente nel frontmatter:
\n--- \ntitle : Hello World \ndate : 2024-01-01 \nlanguage : en # puo essere omesso perche e la lingua predefinita \ntranslations : \n - pt-ola # poi scrivi un post con slug `ola` e language: pt \n - es-hola \n--- Il campo translations accetta una lista di slug. Marmite risolve ogni slug al contenuto reale, compila il codice lingua e il nome di visualizzazione, e crea collegamenti bidirezionali. Se il post A elenca il post B come traduzione, il post B riceve automaticamente un collegamento di ritorno al post A.
Important
\nPreferisci le opzioni 1 e 2 per il rilevamento automatico. Le opzioni 3 e 4 richiedono frontmatter esplicito ma offrono maggiore controllo sui collegamenti.
\nlanguageImposta esplicitamente il codice lingua del contenuto:
\nlanguage : it Di solito non e necessario con il rilevamento per sottocartella (Opzioni 1 e 2), dove la lingua viene dedotta automaticamente. Usalo per le Opzioni 3 e 4, dove la lingua deve essere specificata nel frontmatter.
\nQuando language e impostato su un valore diverso dalla lingua predefinita del sito e nessuna stream e definita esplicitamente, marmite usa automaticamente la lingua come stream, cioe il contenuto verra pubblicato nella stream corrispondente (ad esempio it.html).
translatesPunta una traduzione allo slug del contenuto originale:
\ntranslates : hello Marmite crea collegamenti bidirezionali tra il contenuto originale e tutte le sue traduzioni. Non e necessario con l'auto-scoperta per sottocartella (Opzioni 1 e 2). Vedi l'Opzione 3 sopra per i dettagli.
\ntranslationsCollega manualmente alle traduzioni per slug:
\ntranslations : \n - en-hello-world \n - pt-ola-mundo Non e necessario quando si usa l'auto-scoperta per sottocartella (Opzioni 1 e 2) o il campo translates: (Opzione 3), poiche le traduzioni vengono collegate automaticamente.
index e appaiono nella pagina principale index.htmlessential-guide.md rilevato come lingua es)translates: e risolve i riferimenti del frontmatterseries che una language stream - funzionano indipendentementeen-hello vs es-hola)language e translations per la visualizzazione nei template, ma non appaiono nelle pagine di elenco della stream\n\n\n\n", "summary": "\"Scrivi contenuti in piu lingue con collegamento automatico delle traduzioni, pagine di stream per lingua e tag hreflang per la SEO utilizzando la funzione language streams di marmite.\"", "date_published": "2026-07-02T00:00:00-00:00", "image": "media/language-streams/banner.jpg", "authors": [ { "name": "Bruno Rocha", "url": "https://go.rocha.social/@bruno", "avatar": "https://github.com/rochacbruno.png" } ], "tags": [ "documentazione" ], "language": "en" } ] }Please consider giving a ☆ on Marmite Github repository, that helps a lot!
\n