Adiciona suporte a múltiplas línguas usando Jekyll Polyglot

[george-gca]

Descrição de PR

Seguindo uma proposta diferente da #140 pra dar suporte a vários idiomas, usando jekyll com o plugin polyglot.

Versão em pt-br

Versão em en-us

Perceba que quando alterado pra en-us a url lá em cima muda também.

Issue relacionado

• 📝 Nova estrutura de organização de termos do dicionário #171
• Resolve Implementação de Tradução nos Cards #185

Motivações

Desvantagens:

• introduzindo uma nova tecnologia

Vantagens:

• pouca mudança no código usando liquid pra ajudar com a tradução dos textos, sendo que o código continua praticamente igual no conteúdo tendo sido só movido:
  • ex: onde antes era Pesquisar... virou {{ page.search_placeholder }}
  • index.html -> _layouts/base.liquid
  • assets/js/script.js -> _includes/script.liquid
• facilidade de manutenção: adicionar um novo idioma envolve criar 2 arquivos
  • _pages/LANG/search.md com as traduções dos textos
  • assets/data/LANG/cards.json com os termos, tags e descrições

Informações adicionais

Vou deixar como draft porque já dá pra ser testado, mas tem uns poréns que pretendo resolver (qualquer ajuda é bem vinda):

• atualmente testar envolve instalar o ruby na máquina local. Vou ver se consigo criar um devcontainer pra facilitar a pessoa usuária a testar o site na máquina local. Com isso a pessoa vai abrir o código no vscode, por exemplo, ele detecta que tem um devcontainer e já instala tudo (precisa ter docker instalado)
• cheguei no mesmo ponto que o Feat: Adiciona lógica para ter mais de uma linguagem #140, não criei o botão bonitinho pra mudar o idioma ainda. No código de onde peguei o seletor de idiomas é usado o bootstrap, então criar um dropdown de idioma é mais fácil. Mas não sou a favor de botar uma dependência tão grande só pra customizar um botão
• vai ser necessária uma mudança na configuração do netlify pra ele gerar a página bonitinha igual agora, mas sei que isso é fácil de fazer

[netlify]

❌ Deploy Preview for diciotech failed.

Name	Link
🔨 Latest commit	32bb457
🔍 Latest deploy log	https://app.netlify.com/sites/diciotech/deploys/6716ac087fe5da0008b9e7c9

[george-gca]

@levxyca vê se tu achas que é uma mudança muito disruptiva, ou acha que vale a pena continuar essa implementação antes de eu continuar investindo esforço nisso. @azevgabriel tua opinião também é importante.

[levxyca]

@george-gca boa, vou dar uma olhada com calma!

[george-gca]

Inclusive como tive que traduzir todos os termos pro inglês (ou seja, li TODAS as definições do dicionário), eu percebi algumas coisas que dá pra melhorar, e vou criar issues pra elas individualmente (não vou trabalhar elas nessa PR).

[levxyca]

@george-gca estava dando um bizu aqui e curti, eu vejo que aqui temos dois pesos e duas medidas nessa decisão onde a decisão vai depender das prioridades e do perfil das pessoas que vão contribuir com o projeto.

Vale a pena migrar para Jekyll se:

• A internacionalização for uma prioridade importante e quisermos uma solução que facilite o gerenciamento de vários idiomas.

Pode não ser ideal se:

• O foco é permitir que iniciantes contribuam facilmente, já que a curva de aprendizado pode ser mais alta.

Penso em criar uma nova discussão para entender isso com a Comunidade e ver qual ponto pesa mais nesse momento, se seguirmos a frente de migrar via Jekyll, vamos ter além do trabalho de configuração e migração, toda uma criação de documentação em volta disso.

O que acha?

[levxyca]

Penso um pouco também que talvez outras features possam ser mais relevantes no momento, como por exemplo, a nova UI. Mas quero outras opiniões.

[george-gca]

Eu concordo. Eu posso abrir a discussão e dizer o que eu acho de prós e contras, dar uma visão geral. Acho que rola até abrir como votação.

[george-gca]

Votem sobre isso em #243.

[brunodmartins]

@george-gca pode colocar no README como faz para levantar o projeto local nessa nova arquitetura?

[george-gca]

Descontinuado, ver #267.

[levxyca]

@brunodmartins @george-gca céus, to ficando louca, mandei o link errado pra pro Bruno 😭 pode olhar a #267

[brunodmartins]

@brunodmartins @george-gca céus, to ficando louca, mandei o link errado pra pro Bruno 😭 pode olhar a #267

Acho que eu mesmo que vi errado fica em paz hahaha

[azevgabriel]

@george-gca Olhando por cima, você vai ter que documentar quais dependências os outros contribuidores terão que instalar para rodar o projeto.

Pq temos ruby, python e um .liquid em um projeto que era para ter só html, css e js.

[george-gca]

@azevgabriel ignora essa PR, vê a outra que marquei acima.