-
Notifications
You must be signed in to change notification settings - Fork 6
Processo de Tradução para Novo Idioma
O objetivo deste documento é descrever os passos necessários para disponibilizar o conteúdo da documentação da API Rest do Redu, publicado em http://developers.redu.com.br/, em um novo idioma.
Atualmente, o site fornece a documentação em Português e Inglês.
Para adicionar um novo idioma, é necessário executar os seguintes passos, na branch source:
No arquivo de configuração _config.yml, a chave languages é associada a uma lista com os idiomas atualmente suportados no site. Para adicionar um novo idioma, é necessário adicionar o language code do mesmo a essa lista.
É necessário manter pt como primeiro elemento da lista, por ser o idioma default. Por exemplo, ao adicionar o idioma Espanhol, cujo language code é es, a nova lista poderia ser da seguinte forma:
languages: ["pt", "en", "es"]Para disponibilizar o conteúdo do site em um novo idioma, você deve criar um novo arquivo na pasta _18n com a tradução das strings localizadas. Esse arquivo deverá ser nomeado da seguinte forma: language_code.yml. Por exemplo, para o Espanhol, o nome do arquivo seria es.yml.
A forma mais simples de realizar essa etapa é copiar o arquivo existente pt.yml na mesma pasta, renomeá-lo seguindo a convenção acima e substituir o valor de todas as chaves para as respectivas traduções no novo idioma.
Para permitir ao usuário a visualização do conteúdo do site no novo idioma, é necessário adicionar um novo botão com a bandeira representando um país onde o idioma é falado. Esses botões são localizados na parte superior esquerda da página.
A imagem da bandeira deverá ser colocada dentro da pasta assets/images e o botão deverá ser adicionado ao arquivo _includes/themes/twitter/default.html, dentro de <div class = "flags">. Para o Espanhol, poderíamos adicionar o link com a bandeira de acordo com o exemplo abaixo:
<div class = "flags">
<a class = "flag" href="{{site.baseurl_root}}/" title="Português"/><img src="/assets/images/br.png" /></a>
<a class = "flag" href="{{site.baseurl_root}}/en" title="English"/><img src="/assets/images/uk.png" /></a>
<a class = "flag" href="{{site.baseurl_root}}/es" title="Español"/><img src="/assets/images/es.png" /></a>
</div>