Polyglot

Polyglot 1.13 - novas variáveis liquid, melhorias de SEO e redirecionamento

2026-05-13T00:00:00-06:00

Jekyll-Polyglot 1.13.0 foi lançado! Este lançamento foi possível graças ao apoio e às muitas contribuições de @rathboma e Beekeeper Studio.

melhor geração de hreflang

PR #282: @rathboma mesclou melhorias na geração de tags hreflang, adicionando uma opção de fallback para idiomas não configurados. Isso melhora o SEO e a correção dos cabeçalhos gerados em sites multilíngues.

avisos sobre códigos de idioma incompatíveis

PR #287: @rathboma adicionou avisos em tempo de build quando o valor lang: de uma postagem não corresponde a nenhum idioma configurado do site. A correspondência de idiomas agora não diferencia maiúsculas de minúsculas, então EN e en são tratados da mesma forma.
PR #290: @rathboma a filtragem agora exclui corretamente postagens escritas em idiomas que não estão na configuração languages:, evitando que conteúdo não configurado vaze para os builds.

localização do _redirects do Netlify

PR #285: @rathboma adicionou uma nova opção localize_redirects. Quando ativada, o Polyglot gera automaticamente cópias com prefixo de idioma das regras _redirects do Netlify, de modo que um redirecionamento como /github também funcione para /fr/github, /de/github e assim por diante. Veja a página de receitas de SEO para detalhes de configuração.

novas variáveis liquid para status de tradução

PR #305: Duas novas variáveis liquid — page.missing_languages e page.available_languages — permitem que seus templates vejam quais idiomas uma página já recebeu tradução, e quais ainda estão faltando. Útil para construir seletores de idioma e barras laterais mais ricos.

novas traduções de idioma

PR #303: O site de documentação do Polyglot agora conta com traduções para ucraniano (uk) e híndi (hi), com a ajuda de tradução assistida por IA. Correções são bem-vindas!
PR #297: @manabu-nakamura contribuiu com correções nas traduções do site para o japonês (ja). Obrigado!

suporte a ferramentas de desenvolvimento de IA

PR #298: O Polyglot agora vem com suporte de engenharia de primeira classe para GitHub Copilot, Claude Code e a convenção compartilhada AGENTS.md. A IA faz parte do fluxo de trabalho agora, e contribuições feitas com essas ferramentas são bem-vindas.
Verificações adicionais de qualidade de CI foram adicionadas, incluindo ajustes de htmlproofer e rubocop.

barra lateral mostra traduções ausentes

A barra lateral do site de documentação agora sinaliza páginas que ainda não têm tradução no idioma ativo, facilitando a identificação de lacunas por leitores e colaboradores.

Obrigado a @rathboma e a todos que contribuíram para este lançamento!

Polyglot 1.12 - melhorias de redirecionamento e contribuições da comunidade

2026-01-31T00:00:00-07:00

Jekyll-Polyglot 1.12.0 foi lançado! Este lançamento foca em melhorar o tratamento de redirecionamentos e inclui várias contribuições da comunidade.

melhorias de redirecionamento

Este lançamento inclui melhorias importantes em como os redirecionamentos funcionam com o Polyglot:

PR #275: Preservação de tags de âncora em redirecionamentos - graças a uma solução de @GruberMarkus, as URLs de redirecionamento agora preservam corretamente as tags de âncora, garantindo que os usuários cheguem exatamente onde pretendiam.
PR #293: Suporte de redirecionamento de sublinguagens para o plugin jekyll-redirect-from - sugerido por @rathboma, o Polyglot agora delimita corretamente o frontmatter redirect_from entre sublinguagens, evitando redirecionamentos duplicados e garantindo roteamento correto para páginas de idiomas não padrão.

detectar páginas de fallback com page.rendered_lang

PR #283: Nova variável page.rendered_lang - contribuída por @rathboma, esta nova variável liquid permite detectar quando uma página está sendo renderizada como fallback. Quando page.rendered_lang != site.active_lang, você sabe que o conteúdo da página ainda não foi traduzido.

A página /about foi atualizada com instruções sobre como melhor usar esta variável liquid de conveniência page.rendered_lang.

novo suporte de idiomas

PR #280: Suporte para italiano e turco foi adicionado ao site de documentação do Polyglot, expandindo nosso alcance multilíngue.

contribuições da comunidade

Vários membros da comunidade contribuíram com melhorias para o projeto:

PR #277: Definições de rich text da barra lateral atualizadas, melhorando a apresentação multilíngue do site.
PR #288: Strings de rich text em japonês contribuídas por @manabu-nakamura, aprimorando a experiência do idioma japonês.

Um agradecimento especial a @PanderMusubi pela demonstração jekyll-minimal-mistakes-polyglot, mostrando como integrar o Polyglot com o popular tema Minimal Mistakes.

Obrigado a todos os contribuidores que tornaram este lançamento possível!

Polyglot 1.11 - lançamento de correções diversas

2025-09-20T00:00:00-06:00

Jekyll Polyglot 1.11.0 foi lançado. Ele contém correções para bugs complicados que foram desafiadores de resolver até recentemente. Este lançamento é possível graças a contribuidores e usuários como você.

conflitos corrigidos com temas jekyll

Outros temas jekyll como minimal-mistakes ou chirpy usam padrões glob em configurações exclude: que anteriormente conflitavam com o processamento polyglot de sites web com relativização de URL. @mattions contribuiu com uma correção para regex.escape esses valores antes de serem aplicados às regexes de relativização.

Este ajuste deve ajudar com o uso do polyglot pronto para uso com outros temas jekyll comuns.

outras correções diversas

suporte para japonês e árabe

O site polyglot agora tem versões de suporte traduzidas em árabe e japonês. Essas traduções do site foram feitas com a ajuda de IA; se algo estiver mal traduzido, por favor contribua com correções melhores!

Polyglot 1.10 - melhorias no i18n_headers

2025-07-07T00:00:00-06:00

O Jekyll-Polyglot 1.10 já está disponível. Ele traz grandes melhorias e mudanças no plugin liquid i18n_headers para SEO, além de pequenos ajustes para idempotência em builds paralelos. Contribuições da comunidade e Vibe Coding ajudaram em grande parte dos recursos, testes e redação deste lançamento.

Melhorias no i18n_headers

O plugin i18n_headers agora possui capacidades estendidas nesta versão:

adiciona <link rel="canonical" ...> para cada idioma da página, garantindo que a indexação seja única em todos os sites.
adiciona <link rel="alternate" hreflang="x-default" ...> para apontar para a versão padrão do site quando nenhum idioma correspondente é solicitado pelo navegador.
define corretamente <link rel="alternate" hreflang="..."> para páginas e posts em coleções com permalinks personalizados.
a URL padrão agora incluirá site.baseUrl se definido.

Isso também corrige um bug que fazia com que a relativização de URLs absolutas alterasse essas tags involuntariamente.

Contribuições vibe-coded

O uso de certas ferramentas de vibe coding ajudou a encontrar, medir e verificar correções e recursos para este lançamento. Essa é uma nova abordagem para o desenvolvimento de software e permitiu a criação de testes Ruby avançados para código de plugin Jekyll executado em muitos idiomas do site.

Os testes escritos com vibe coding ajudaram a manter a alta cobertura de testes e a adicionar recursos complexos com confiança. Garantir a automação dos testes permitiu que recursos complicados fossem construídos corretamente.

Além disso, as ferramentas de vibe coding ajudaram a traduzir este post do blog para muitos idiomas.

Contribuições da comunidade

O Jekyll-Polyglot tem sido apoiado por pessoas. A documentação em linguagem humana é contribuída por pessoas que querem ver este plugin documentado em sua língua materna. Pessoas que contribuem com correções de bugs e documentação ajudaram este plugin a alcançar milhares de downloads por lançamento. A programação assistida por IA, em minhas ou suas mãos, moldará o software que usamos e os muitos idiomas em que escrevemos e falamos.

ruby >= 3.1 obrigatório

Atualizações contínuas de segurança das dependências de build do jekyll-polyglot exigiram uma atualização importante para ruby 3.1. Isso pode afetar sistemas de build que geram documentação com jekyll-polyglot. Agora é um bom momento para atualizar para a versão principal mais recente do ruby. Avise se essas mudanças causarem complicações nas builds do jekyll.

Polyglot 1.9.0 - Melhorias Instrucionais

2025-01-18T00:00:00-07:00

Jekyll-Polyglot 1.9.0 foi lançado, que possui pequenas atualizações de dependência e melhorias instrucionais para obter o máximo do seu site multilíngue.

Melhorias instrucionais fornecidas pela comunidade

Obrigado a aturret por ajudar a manter as páginas do site chinês (zh-CN) existentes. 谢谢！

george-gca aprimorou a configuração opcional derive_lang_from_path para melhor identificar o idioma do documento a partir da inferência do caminho. Testes foram adicionados para seu útil PR de melhoria de recurso. Essa melhoria ajuda a inferir o idioma de posts e páginas sem frontmatter lang, de qualquer parte do caminho do arquivo do documento.

O usuário do Github yunseo-kim enviou instruções para melhorar a geração de sitemap. Para ajudar no SEO, um site deve ter apenas um sitemap.xml raiz, e não duplicatas para cada site de sub-linguagem. Certifique-se de adicionar sitemap.xml à configuração exclude_from_localization.

Polyglot 1.8.1 - Community Bug Fixes Release

2024-08-18T00:00:00-06:00

Jekyll-Polyglot 1.8.1 foi lançado, trazendo algumas melhorias de recursos e reconhecendo bugs identificados pela comunidade, para os quais foram fornecidas correções.

Correções de Bugs Fornecidas pela Comunidade

hacketiwack contribuiu com uma verificação mais rigorosa para definir um permalink de documento, evitando problemas posteriores com campos vazios de frontmatter.

O usuário do Github blackpill enviou uma correção de bug de um caractere para a tag de cabeçalhos i18n ao renderizar o href alternativo do link do idioma padrão.

Polyglot 1.8.0 - Liberação de contribuições comunitárias

2024-03-17T00:00:00-06:00

Fique animado com o Jekyll-Polyglot 1.8.0, que tem algumas melhorias de recursos e reconhece a documentação e contribuições da comunidade!

links permanentes específicos idoma

Um novo recurso é fornecer links permanentes específicos ao idioma das páginas e manter sua associação com outras páginas relativas. Este novo recurso foi novamente aprimorado por antoniovazquezblanco, que é um cavalheiro e estudioso.

geração de mapa de site e SEO i18n

Este lançamento também reconhece a qualidade sitemap.xml y robots.txt solução fornecida por jerturowetz. Este site agora demonstra e captura mais poder de SEO ao usá-los para ser rastreável como um site jekyll estático por provedores de pesquisa. Veja os arquivos do site de exemplo aqui.

jekyll :polyglot :post_write hook

Github user obfusk contribuiu com pequeno PRs alguns anos atrás:

Com o poliglota :site, :post_write como estes são executados para cada processo filho:

Jekyll::Hooks.register :site, :post_write do |site|
  ...
end

Esta versão adiciona um personalizado :post_write hook que é executado exatamente uma vez, depois que todos os idiomas foram processados (whether or not parallel_localization is used):

Jekyll::Hooks.register :polyglot, :post_write do |site|
  # faça algo incrível aqui!
end

Este recurso é útil para sites estáticos jekyll complexos que fazem uso adicional de jekyll hook plugins.

Obfusk também contribuiu com uma correção para registro adicional quando os subprocessos da linguagem falham. Obrigado por esta contribuição!

variáveis localizadas e tradução para o português.

george-gca é um cara talentoso e incrível, ele contribuiu com um todo blogpost por qual a melhor forma de localizar rich text dos dados do site. Ele também forneceu umsite de tradução brasileiro.

Variáveis traduzidas

2024-02-29T00:00:00-07:00

Polyglot permite que você tenha diferentes páginas para diferentes idiomas em seu site Jekyll. Por exemplo, você pode ter uma página about.md em inglês e outra about.md em espanhol com layouts completamente diferentes. Mas se você quiser ter o mesmo layout para todas as páginas, você pode usar variáveis traduzidas. Esta é uma maneira de ter diferentes dados para diferentes idiomas em seu site Jekyll, mas usando o mesmo layout para todos os idiomas.

Como exemplo, usarei um site modelo criado com Polyglot.

Compartilhando um layout entre páginas

Nesse site eles têm uma página sobre para cada idioma, no caso deles inglês em _pages/en-us/about.md e português brasileiro em _pages/pt-br/about.md. Em ambas as páginas podemos ver que elas têm as mesmas chaves no frontmatter, mas algumas com valores diferentes. Ambos os arquivos apontam para o mesmo layout, about, e este layout usa os valores no frontmatter para renderizar a página.

Por exemplo, a chave subtitle na página em inglês tem o valor subtitle: <a href='#'>Affiliations</a>. Address. Contacts. Moto. Etc. e na página em português brasileiro tem subtitle: <a href='#'>Afiliações</a>. Endereço. Contatos. Lema. Etc.. Essa informação no layout é usada dessa forma:

{{ page.subtitle }}

O mesmo vale para o conteúdo abaixo do frontmatter em ambos os arquivos, que é simplesmente usado no layout dessa forma:

{{ content }}

Polyglot renderizará automaticamente a página com os valores corretos para o idioma atual.

Compartilhando um layout entre páginas com dados traduzidos

Para o subtitle da página eles usaram pares chave: valor no frontmatter, mas às vezes queremos usar esses mesmos pares em diferentes partes do site. Por exemplo, se quisermos usar o mesmo subtitle no about.md e em outra página, teríamos que repetir o mesmo par no frontmatter de ambas as páginas. Isso não é ideal porque se quisermos mudar o subtitle teríamos que mudá-lo em dois lugares. É aí que entram os dados traduzidos. Você pode criar um arquivo como _data/:lang/strings.yml, um para cada idioma, e o Polyglot trará essas chaves sob site.data[:lang].strings.

Por exemplo, no site modelo existem dois arquivos, _data/en-us/strings.yml e _data/pt-br/strings.yml. No primeiro arquivo eles têm:

latest_posts: latest posts

E no segundo arquivo eles têm:

latest_posts: últimas postagens

Dessa forma, eles podem usar a chave latest_posts no layout assim:

{{ site.data[site.active_lang].strings.latest_posts }}

O que obterá corretamente o valor para a variável latest_posts definida no arquivo _data/:lang/strings.yml para o idioma atual.

Definindo qual variável usar no frontmatter

Agora, se você quiser definir essa variável no frontmatter da página, isso fica um pouco mais complicado. Uma possível solução é verificar se o valor da variável tem um . nele e, se tiver, usar o valor no arquivo _data/:lang/strings.yml. É assim que você faria:

{% if frontmatter_var contains '.' %}
  {% assign first_part = frontmatter_var | split: '.' | first %}
  {% assign last_part = frontmatter_var | split: '.' | last %}
  {% capture result %}{{ site.data[site.active_lang].strings[first_part][last_part] }}{% endcapture %}
{% endif %}

{{ result }}

Isso funcionará, por exemplo, se frontmatter_var = blog.title.

Agora, se você precisar verificar se a string de tradução (neste caso blog.title) realmente existe no arquivo _data/:lang/strings.yml antes de usá-la, você terá que criar um plugin para verificar se a variável existe no arquivo _data/:lang/strings.yml e, se existir, usá-la, caso contrário, retornar para qualquer valor que você quiser. Não entrarei em detalhes sobre como fazer isso, mas mostrarei como usá-lo. Você pode ver o código do plugin aqui.

{% if frontmatter_var contains '.' %}
  {% capture contains_localization %}{% localization_exists {{ frontmatter_var }} %}{% endcapture %}
  {% if contains_localization == 'true' %}
    {% assign first_part = frontmatter_var | split: '.' | first %}
    {% assign last_part = frontmatter_var | split: '.' | last %}
    {% capture result %}{{ site.data[site.active_lang].strings[first_part][last_part] }}{% endcapture %}
  {% else %}
    {% capture result %}fallback value{% endcapture %}
  {% endif %}
{% endif %}

{{ result }}

Polyglot 1.7.0 and page_id front-matter for different permalinks by language

2023-10-29T00:00:00-06:00

I’m excited to announce Jekyll-Polyglot 1.7.0, which has a new feature to give pages language specific permalinks and to retain their association to other relative pages.

This new feature is provided by antoniovazquezblanco, who is a gentleman and a scholar.

use `page_id` frontmatter to associate pages with different permalinks

Polyglot associates pages by matching their permalinks or filenames. However some site translations may instead desire pages with unique permalinks.

Polyglot already coordinates multiple copes of the same document across different languages. So keying off of a different property like page_id is no different than keying off of the permalink.

Using a page_id to coordinate similar pages with different permalinks ensures that custom permalinks can still be seen on language specific sites.

redirects for unique permalinks

The challenge with unique permalinks comes with relativizing those urls. Polyglot avoids this problem entirely by suggesting consistent permalinks.

To help with this, polyglot sets redirect_from hidden frontmatter on these pages, listing the unique permalinks of corresponding pages.

When using the jekyll-redirect-from plugin, that frontmatter will be picked up, and intelligent redirects made to the page’s custom permalink.

To see this in action, visit this page with a long permalink in different languages.

Other bug fixes

This release should have a fix for #151 and #184, preventing crashes on startup when calling other jekyll commands.

Polyglot 1.6.0 and Simplified Chinese language support

2023-06-08T00:00:00-06:00

The Polyglot website has been updated with support for Chinese!

This is made possible by aturret, who contributed numerous bugfixes to the plugin, the website, and an entirely new site translation.

Additionally, jekyll-polyglot 1.6.0 is now available from rubygems.

Fix for relativization of frozen strings

Polyglot used String::gsub! which mutates a .frozen? string. This has now been fixed to duplicate the cloned string before modifying it.

A typo in the html on the site layout prevented the previous page navigation from being translated correctly.

Support for Chinese Language

With a big 谢谢 of support and appreciation to aturret, polyglot.untra.io now supports a zh-CN Simplified Chinese translation!