Marmite soporta sitios multilingues a traves de language streams. Cada idioma se convierte en una stream con su propia pagina de listado y feed RSS, mientras que las traducciones se vinculan automaticamente con navegacion "Tambien disponible en" y etiquetas hreflang para SEO.
\nLos idiomas se detectan automaticamente a partir del contenido. Solo establece language: xx en el frontmatter o usa convenciones de nombres de subcarpetas, y marmite se encarga del resto - no se requiere configuracion.
El campo language en marmite.yaml (valor predeterminado en) determina el idioma predeterminado del sitio. El contenido en el idioma predeterminado permanece en index.html. Los demas idiomas obtienen sus propias paginas de stream (pt.html, es.html) y feeds RSS (pt.rss, es.rss).
Por defecto, las streams de idioma se etiquetan con su codigo de dos letras (por ejemplo, "pt", "es"). Para establecer nombres legibles, agrega una seccion opcional languages en marmite.yaml:
language : en \nlanguages : \n pt : \n display_name : "Portugues" \n es : \n display_name : "Espanol" Esto sigue el mismo patron que streams: y series: - la configuracion es puramente estetica. Los sitios sin contenido en multiples idiomas no se ven afectados.
Hay cuatro formas de organizar contenido multilingue. Todas producen salida HTML plana.
\nAgrupa las traducciones en una subcarpeta con el nombre del slug del contenido base. Los archivos con prefijo de codigo de idioma ISO 639-1 se detectan y vinculan automaticamente:
\ncontent/hello/\n hello.md # Idioma predeterminado (en)\n pt-ola-mundo.md # Traduccion al portugues\n es-hola-mundo.md # Traduccion al espanol\nEsto genera:
\nhello.html - Post en ingles, listado en index.htmlpt-ola-mundo.html - Post en portugues, listado en pt.htmles-hola-mundo.html - Post en espanol, listado en es.htmlLas tres paginas muestran automaticamente enlaces "Tambien disponible en" hacia las otras.
\nTip
\nLa subcarpeta tambien puede tener la fecha, por ejemplo content/2026-07-02-hello/, asi no necesitas especificar la fecha en el frontmatter de cada traduccion.
Si tienes un sitio plano existente y quieres agregar traducciones sin mover los archivos originales, crea una subcarpeta que coincida con el slug del contenido existente:
\ncontent/\n hello.md # Archivo plano existente, slug: hello\n hello/\n pt-ola.md # Traduccion al portugues, vinculada automaticamente\nMarmite detecta que el nombre de la subcarpeta hello coincide con el slug del archivo plano y los vincula como traducciones.
Important
\nLos nombres de las subcarpetas deben coincidir con el slug del post original (no el nombre del archivo, sino el slug resuelto, a veces tomado del titulo) para ser vinculados automaticamente como traducciones.
\nCada traduccion apunta al slug del contenido original usando el campo translates. Marmite construye la red completa de enlaces bidireccionales automaticamente:
--- \ntitle : Hola Mundo \ndate : 2024-01-01 \nlanguage : es \ntranslates : hello \n--- Esto es mas simple que mantener una lista translations en cada archivo. Solo establece translates en cada traduccion y marmite conecta todo. Cuando language se define con un valor diferente al idioma predeterminado del sitio, marmite automaticamente coloca el contenido en la stream del idioma correspondiente.
Define el idioma y las traducciones explicitamente en el frontmatter:
\n--- \ntitle : Hello World \ndate : 2024-01-01 \nlanguage : en # se puede omitir porque es el idioma predeterminado \ntranslations : \n - pt-ola # luego escribes un post con slug `ola` y language: pt \n - es-hola \n--- El campo translations acepta una lista de slugs. Marmite resuelve cada slug al contenido real, completa el codigo de idioma y el nombre de visualizacion, y crea enlaces bidireccionales. Si el post A lista al post B como traduccion, el post B automaticamente recibe un enlace de vuelta al post A.
Important
\nPrefiere las opciones 1 y 2 para auto-descubrimiento. Las opciones 3 y 4 requieren frontmatter explicito pero te dan mas control sobre la vinculacion.
\nlanguageDefine explicitamente el codigo de idioma del contenido:
\nlanguage : es Normalmente no es necesario con la deteccion por subcarpeta (Opciones 1 y 2) - el idioma se infiere automaticamente. Usalo para las Opciones 3 y 4.
\nCuando language se define con un valor diferente al idioma predeterminado del sitio y no se establece una stream explicita, marmite automaticamente usa el idioma como stream, es decir, este post se publicara en la stream es.html.
translatesApunta una traduccion al slug del contenido original:
\ntranslates : hello Marmite crea enlaces bidireccionales entre el contenido original y todas sus traducciones. No es necesario con auto-descubrimiento por subcarpeta. Ver Opcion 3 arriba para mas detalles.
\ntranslationsVincula manualmente a traducciones por slug:
\ntranslations : \n - en-hello-world \n - pt-ola-mundo No es necesario al usar auto-descubrimiento por subcarpeta (Opciones 1 y 2) o translates: (Opcion 3), ya que las traducciones se vinculan automaticamente.
index y aparece en la pagina principal index.htmlessential-guide.md siendo detectado como idioma es)translates: se procesan despues de la recoleccion de contenido para construir enlaces bidireccionalesseries como una language stream - funcionan independientementeen-hello vs es-hola)language y translations para visualizacion en plantillas, pero no aparecen en paginas de listado de stream\n\n\n\n", "summary": "\"Escribe contenido en multiples idiomas con enlaces de traduccion automaticos, paginas de stream por idioma y etiquetas hreflang para SEO usando la funcion de language streams de 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": [ "documentacion" ], "language": "en" } ] }Please consider giving a ☆ on Marmite Github repository, that helps a lot!
\n