---
layout: post
title: Variáveis traduzidas
lang: pt-BR
---
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](https://github.com/george-gca/multi-language-al-folio) 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](https://github.com/george-gca/multi-language-al-folio/blob/main/_pages/en-us/about.md) e português brasileiro em [\_pages/pt-br/about.md](https://github.com/george-gca/multi-language-al-folio/blob/main/_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](https://jekyllrb.com/docs/layouts/), [about](https://github.com/george-gca/multi-language-al-folio/blob/main/_layouts/about.liquid), 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: Affiliations. Address. Contacts. Moto. Etc.` e na página em português brasileiro tem `subtitle: Afiliações. Endereço. Contatos. Lema. Etc.`. Essa informação no layout é usada dessa forma:
{% raw %}
```liquid
{{ page.subtitle }}
```
{% endraw %}
O mesmo vale para o conteúdo abaixo do frontmatter em ambos os arquivos, que é simplesmente usado no layout dessa forma:
{% raw %}
```liquid
{{ content }}
```
{% endraw %}
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](https://github.com/george-gca/multi-language-al-folio/blob/main/_data/en-us/strings.yml) e [\_data/pt-br/strings.yml](https://github.com/george-gca/multi-language-al-folio/blob/main/_data/pt-br/strings.yml). No primeiro arquivo eles têm:
```yaml
latest_posts: latest posts
```
E no segundo arquivo eles têm:
```yaml
latest_posts: últimas postagens
```
Dessa forma, eles podem usar a chave `latest_posts` no layout assim:
{% raw %}
```liquid
{{ site.data[site.active_lang].strings.latest_posts }}
```
{% endraw %}
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:
{% raw %}
```liquid
{% 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 }}
```
{% endraw %}
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](https://github.com/george-gca/multi-language-al-folio/blob/main/_plugins/localization-exists.rb).
{% raw %}
```liquid
{% 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 }}
```
{% endraw %}