![\"len\"](\"media/line_len.avif\")
Este e apenas um post de teste para verificar que a auto-descoberta\nde idiomas funciona quando o conteudo base tem uma stream explicita\nque nao e um idioma.
\nAs traducoes nesta pasta devem ser auto-descobertas e vinculadas.
\n\n\n\n\n", "summary": "", "date_published": "2026-07-03T00:00:00-00:00", "image": "media/apenas-um-teste.banner.jpg", "authors": [ { "name": "Bruno Rocha", "url": "https://go.rocha.social/@bruno", "avatar": "https://github.com/rochacbruno.png" } ], "tags": [], "language": "en" }, { "id": "https://marmite.blog/pt-apenas-outro-teste.html", "url": "https://marmite.blog/pt-apenas-outro-teste.html", "title": "Apenas Outro Teste", "content_html": "Please consider giving a ☆ on Marmite Github repository, that helps a lot!
\n
Este e apenas outro post de teste para verificar que a auto-descoberta\nde idiomas funciona quando a subpasta tem um prefixo de data.
\n\n\n\n\n", "summary": "", "date_published": "2026-07-03T00:00:00-00:00", "image": "media/apenas-outro-teste.banner.jpg", "authors": [ { "name": "Bruno Rocha", "url": "https://go.rocha.social/@bruno", "avatar": "https://github.com/rochacbruno.png" } ], "tags": [], "language": "en" }, { "id": "https://marmite.blog/pt-conteudo-em-portugues.html", "url": "https://marmite.blog/pt-conteudo-em-portugues.html", "title": "Conteudo em Portugues", "content_html": "Please consider giving a ☆ on Marmite Github repository, that helps a lot!
\n
Este e um post com apenas language: pt no frontmatter, sem stream definido.\nSera que aparece no pt.html automaticamente?
\n\n\n\n", "summary": "", "date_published": "2026-07-03T00:00:00-00:00", "image": "media/conteudo-em-portugues.banner.jpg", "authors": [ { "name": "Bruno Rocha", "url": "https://go.rocha.social/@bruno", "avatar": "https://github.com/rochacbruno.png" } ], "tags": [], "language": "en" }, { "id": "https://marmite.blog/pt-language-streams-conteudo-multilingual.html", "url": "https://marmite.blog/pt-language-streams-conteudo-multilingual.html", "title": "Language Streams - Conteudo Multilingual", "content_html": "Please consider giving a ☆ on Marmite Github repository, that helps a lot!
\n
O marmite suporta sites multilingues atraves de language streams. Cada idioma se torna uma stream com sua propria pagina de listagem e feed RSS, enquanto as traducoes sao automaticamente vinculadas com navegacao "Tambem disponivel em" e tags hreflang para SEO.
\nOs idiomas sao auto-detectados a partir do conteudo. Basta definir language: xx no frontmatter ou usar convencoes de nomenclatura por subpasta, e o marmite cuida do resto - nenhuma configuracao e necessaria.
O campo language no marmite.yaml (padrao en) determina o idioma padrao do site. O conteudo no idioma padrao fica no index.html. Outros idiomas recebem suas proprias paginas de stream (pt.html, es.html) e feeds RSS (pt.rss, es.rss).
Por padrao, as language streams sao rotuladas com seu codigo de duas letras (ex., "pt", "es"). Para definir nomes legiveis, adicione uma secao opcional languages ao marmite.yaml:
language : en \nlanguages : \n pt : \n display_name : "Portugues" \n es : \n display_name : "Espanol" Isso segue o mesmo padrao de streams: e series: - a configuracao e puramente cosmetica. Sites sem conteudo em outros idiomas nao sao afetados.
Existem quatro formas de organizar conteudo multilingual. Todas produzem saida HTML plana.
\nAgrupe traducoes em uma subpasta com o nome do slug do conteudo base. Arquivos com prefixo de codigo de idioma ISO 639-1 sao automaticamente detectados e vinculados:
\ncontent/hello/\n hello.md # Idioma padrao (en)\n pt-ola-mundo.md # Traducao em portugues\n es-hola-mundo.md # Traducao em espanhol\nIsso gera:
\nhello.html - Post em ingles, listado no index.htmlpt-ola-mundo.html - Post em portugues, listado no pt.htmles-hola-mundo.html - Post em espanhol, listado no es.htmlTodas as tres paginas mostram automaticamente links "Tambem disponivel em" para as outras.
\nTip
\nA subpasta tambem pode ter a data nela, por exemplo content/2026-07-02-hello/, assim voce nao precisa especificar a data no frontmatter de cada traducao.
Se voce tem um site plano existente e quer adicionar traducoes sem mover os arquivos originais, crie uma subpasta com o mesmo nome do slug do conteudo existente:
\ncontent/\n hello.md # Arquivo plano existente, slug: hello\n hello/\n pt-ola.md # Traducao em portugues, vinculada automaticamente\nO marmite detecta que o nome da subpasta hello corresponde ao slug do arquivo plano e os vincula como traducoes.
Important
\nOs nomes das subpastas devem corresponder ao slug do post original (nao o nome do arquivo, mas o slug resolvido, as vezes retirado do titulo) para serem automaticamente vinculados como traducoes.
\nCada traducao aponta para o slug do conteudo original usando o campo translates. O marmite constroi a rede completa de links bidirecionais automaticamente. Quando language e definido com um valor diferente do idioma padrao do site, o marmite automaticamente coloca o conteudo na stream de idioma correspondente:
--- \ntitle : Ola Mundo \ndate : 2024-01-01 \nlanguage : pt \ntranslates : hello \n--- Isso e mais simples do que manter uma lista translations em cada arquivo. Basta definir translates em cada traducao e o marmite conecta tudo.
Defina o idioma e as traducoes explicitamente no frontmatter:
\n--- \ntitle : Hello World \ndate : 2024-01-01 \nlanguage : en # pode omitir porque e o idioma padrao \ntranslations : \n - pt-ola # entao voce escreve um post com slug `ola` e language: pt \n - es-hola \n--- O campo translations aceita uma lista de slugs. O marmite resolve cada slug para o conteudo real, preenche o codigo do idioma e o nome de exibicao a partir da configuracao languages, e cria links bidirecionais. Se o post A lista o post B como traducao, o post B automaticamente recebe um link de volta para o post A.
Important
\nPrefira as opcoes 1 e 2 para auto-descoberta. As opcoes 3 e 4 exigem frontmatter explicito, mas oferecem mais controle sobre a vinculacao.
\nlanguageDefine explicitamente o codigo de idioma do conteudo:
\nlanguage : pt Normalmente nao e necessario com deteccao por subpasta (Opcoes 1 e 2) - o idioma e inferido automaticamente. Use para as Opcoes 3 e 4 quando o conteudo nao esta em subpastas.
\nQuando language e definido com um valor diferente do idioma padrao do site e nenhuma stream e definida explicitamente, o marmite automaticamente usa o idioma como stream, ou seja, este post sera publicado na stream pt.html.
translatesAponta uma traducao para o slug do conteudo original:
\ntranslates : hello O marmite cria links bidirecionais entre o conteudo original e todas as suas traducoes. Nao e necessario com auto-descoberta por subpasta (Opcoes 1 e 2). Veja a Opcao 3 acima para detalhes.
\ntranslationsVincula manualmente a traducoes por slug:
\ntranslations : \n - en-hello-world \n - es-hola-mundo Nao e necessario ao usar auto-descoberta por subpasta (Opcoes 1 e 2) ou translates: (Opcao 3), pois as traducoes sao vinculadas automaticamente.
en-) sao detectados e atribuidos a essa language streamtranslates: e resolve referencias de frontmatterTranslationRef contendo o codigo do idioma, nome de exibicao, slug e tituloindex e aparece na pagina principal index.htmlessential-guide.md sendo detectado como idioma es)series quanto uma language stream - funcionam independentementeen-hello vs es-hola)language e translations para exibicao no template, mas nao aparecem em paginas de listagem de stream\n\n\n\n", "summary": "\"Escreva conteudo em multiplos idiomas com links de traducao automaticos, paginas de stream por idioma e tags hreflang para SEO usando o recurso de language streams do 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": [ "documentação" ], "language": "en" }, { "id": "https://marmite.blog/pt-porque-usar-o-marmite.html", "url": "https://marmite.blog/pt-porque-usar-o-marmite.html", "title": "Porque usar o Marmite?", "content_html": "Please consider giving a ☆ on Marmite Github repository, that helps a lot!
\n
Marmite e um gerador de sites estaticos simples, facil e opinativo.
\nMarmite nao exige uma estrutura de pastas especifica ou configuracao complexa,\no objetivo e que um blog possa ser gerado simplesmente executando o Marmite em uma pasta com arquivos Markdown e midia.
\nMarmite e otimizado para blogs, nao apenas os recursos de parsing e organizacao de conteudo, mas tambem o tema integrado e otimizado para blogs e legibilidade.
\nMarmite tambem pode ser usado para criar outros tipos de sites, pois e totalmente configuravel e muito facil de personalizar os templates.
\nMarmite vem com um tema integrado que e muito flexivel, otimizado para legibilidade e com 11 esquemas de cores para alternar.
\nMarmite gera feeds RSS e JSON para todas as listagens do seu site,\nentao voce recebe feeds para o indice principal, tags, autores e streams personalizados.
\nMarmite visa ser mais facil de integrar com a web social, adotando padroes semanticos de federacao e integrando com o fediverse.
\nMarmite e escrito em Rust entao e muito rapido e tudo esta incluido em um unico binario.
\nPara gerar seu site estatico a unica coisa que voce precisa e uma pasta com alguns\narquivos markdown e o marmite.
Supondo que voce tenha uma pasta chamada meuconteudo contendo arquivos com extensao .md:
meuconteudo/\n |_ sobre.md\n |_ primeiro-post.md\n |_ algo-incrivel-que-quero-compartilhar.md\n$ marmite meuconteudo meusite -v\nSite generated at: /meusite\nIsso e tudo que voce precisa para ter um blog gerado, agora basta pegar a\npasta meusite e publicar em um servidor web, leia mais em hospedagem.
Aprenda como criar seu primeiro blog com o marmite no nosso Tutorial de Primeiros Passos
\nO tema integrado do Marmite tem uma estrutura muito simples, nao e sobrecarregado com elementos, o que facilita a personalizacao para suas necessidades usando apenas variaveis CSS.
\nO objetivo principal e que voce possa comecar a publicar seus textos usando o tema integrado e gradualmente personalizar a aparencia ao seu gosto, sem precisar gastar muito tempo nisso, focando na escrita.
\nMas se voce quiser, como os templates sao simples, tambem e direto personalizar completamente ou comecar do zero.
\nO Baymard Institute conduziu uma pesquisa sobre comprimento otimo de linha, considerando que o Marmite e otimizado para blogs, o tema integrado adota por padrao o maximo de 74ch de largura.
A fonte escolhida para o tema integrado tambem foi selecionada pela legibilidade, o Braille Institute criou uma fonte gratuita com recursos unicos para melhorar a legibilidade em qualquer midia, por isso o Marmite usa Atkinson Hyperlegible Next por padrao.
\n![\"braile\"](\"media/braile.png\")
O tema integrado usa picocss, uma biblioteca CSS muito pequena e simples de usar. O Pico utiliza variaveis CSS, entao e muito direto personalizar o tema, colocando um custom.css na sua pasta de conteudo e lidando com as variaveis do PicoCSS.
Exemplo:
\nmeuconteudo/custom.css
: root { \n --pico-color : blue; /* mudar cor do texto */ \n --pico-background-color : # FFCC00 ; /* mudar cor de fundo */ \n --pico-card-background-color : # ccc ; /* mudar cor de fundo dos artigos */ \n --pico-container-max-width : 100 ch ; /* comprimento de linha aumentado para 100 chars */ \n --pico-font-family : "Helvetica" , sans-serif; /* fonte diferente */ \n --pico-border-radius : 4 px ; /* raio da borda dos cards */ \n --pico-typography-spacing-vertical : 1 rem ; /* espacamento de linha */ \n} O CSS parece um arquivo de configuracao, facil de usar, e voce tambem pode ser criativo e adicionar mais estilo CSS alem de apenas variaveis.
\nMarmite e muito leve em JavaScript, tambem pode ser configurado para funcionar sem JavaScript.
\nO tema integrado usa Javascript apenas para:
\nE no conteudo, opcionalmente habilitado nos metadados do conteudo.
\nRecursos opcionais
\nO tema integrado e fortemente otimizado para blogs, entao o conteudo principal dos artigos e a parte mais importante, alem disso outras decisoes foram tomadas com o leitor do blog em mente.
\n_references.md e vinculadas em qualquer conteudoO Marmite vem com alguns esquemas de cores integrados, esquemas de cores sao arquivos de estilo CSS que personalizam cores, espacamento etc.
\nSe voce usa outros aplicativos como editores de texto, terminais e apps web, provavelmente esta familiarizado com os esquemas de cores disponiveis.
\nPara escolher um esquema de cores adicione na configuracao
\nmarmite.yaml
extra : \n colorscheme : gruvbox As opcoes integradas sao catppuccin, clean, dracula, github, gruvbox, iceberg, monokai, nord, one, solarized, typewriter.
\nPara criar um esquema de cores personalizado, coloque um custom.css na sua pasta de entrada (a mesma onde o marmite.yaml esta localizado)
Um tema no marmite e baseado nas pastas static e templates, voce pode simplesmente comecar do zero e criar seu proprio tema (por favor compartilhe conosco se fizer).
O CLI do Marmite tambem vem com um comando --start-theme que ira pegar o tema integrado e copiar para sua pasta, para que voce possa personalizar completamente os templates e arquivos estaticos, leia mais em personalizando templates.
Marmite nao complica em termos de tipos de conteudo e taxonomias, existem apenas 2 tipos de conteudo Post e Page, e apenas 2 tipos de taxonomia Tags e Stream.
Voce pode ler mais em detalhes em content-types
\nO site gerado pelo Marmite e um site HTML plano, isso significa que mesmo se a pasta de entrada tiver conteudo organizado em subpastas para melhor experiencia de escrita, o site final sera sempre plano.
\nO que e um site plano?
\n/{slug}.ext.html e feeds terao .rss|.jsonPor que isso foi decidido?
\nSites planos facilitam:
\nEsta e uma opiniao que algumas pessoas nao gostam, porque e comum usar o que as pessoas chamam de URLs bonitas, por exemplo: /pagina em vez de /pagina.html, porem a opiniao do Marmite e que .html nao torna a URL feia, HTML e uma tecnologia incrivel e nao ha problema em mostrar que nosso conteudo e publicado em um site HTML estatico.
Semanticamente e melhor ter a extensao porque e mais facil distinguir uma pasta ou um endpoint de API do conteudo final.
\nSe por algum motivo voce nao gostar das URLs, ainda pode personalizar via seu servidor web, voce pode configurar o NGINX por exemplo para fazer uma reescrita transparente de URLs para servir conteudo .html, mas isso nao e diretamente suportado pelo Marmite.
\n\n\n\n", "summary": "", "date_published": "2024-10-21T00:00:00-00:00", "image": "media/why.jpg", "authors": [ { "name": "Bruno Rocha", "url": "https://go.rocha.social/@bruno", "avatar": "https://github.com/rochacbruno.png" } ], "tags": [ "documentação" ], "language": "en" } ] }Please consider giving a ☆ on Marmite Github repository, that helps a lot!
\n