Idiomas

Instalando um pacote de idioma, traduzindo pelo painel e exportando um idioma que você construiu.

O Bondry vem em inglês, que é a fonte de toda string. Outros idiomas chegam como pacotes, ou você os constrói no painel.

Duas camadas#

Uma tradução é resolvida nesta ordem:

1. uma sobrescrita guardada no banco de dados, vinda do editor do painel;
2. o arquivo daquele idioma, do pacote instalado;
3. inglês.

Nada fica em branco. Um idioma parcialmente traduzido cai para o inglês chave por chave, em vez de mostrar um identificador cru.

Instalando um pacote#

Appearance > Languages > Add recebe um zip com um manifesto language.json. O painel valida, extrai os arquivos, registra o locale e o mostra na lista com a cobertura dele.

Criando um idioma no painel#

Você também pode partir do zero. Appearance > Languages > Create pede o código do locale, o nome, o nome nativo, a direção e os metadados de que um pacote distribuível precisa: autor, versão, compatibilidade e descrição. Esses campos são obrigatórios porque o pacote que você constrói é exportável e comercializável.

O idioma novo começa vazio e herda o inglês até você traduzir.

O editor de tradução#

Appearance > Languages > Translate lista toda chave, agrupada por namespace: o core primeiro, depois um grupo por módulo instalado. Cada linha mostra a fonte em inglês ao lado do campo do idioma de destino.

• Salvar grava na camada do banco de dados e tem efeito imediato.
• A cobertura por idioma é mostrada conforme você avança.
• Placeholders como :name e pluralização são validados: uma tradução que perde um placeholder é recusada.
• Com um termo de busca, o editor busca em todos os grupos de uma vez. Sem um termo, ele navega no grupo que você selecionou.

Strings novas de um update#

Quando um update do core ou de um módulo acrescenta strings, elas aparecem em todo pacote de idioma automaticamente, semeadas em inglês, e o número de cobertura cai para refletir isso. Você nunca precisa caçar o que é novo.

Exportando#

Appearance > Languages > Export produz um zip num de dois modos, ambos mesclando as suas sobrescritas do banco de dados de volta nos arquivos:

Use isso para backups, para mover um idioma entre instalações, ou para publicá-lo.

Membros e o idioma deles#

Cada membro escolhe um idioma no próprio perfil, entre os idiomas que você marcou como visíveis. Marcar um idioma como não visível só o remove desse seletor: quem já usa esse idioma continua com ele enquanto estiver ativado.

Inglês#

O inglês pode ser desativado, uma vez que outro idioma seja o padrão do site, mas nunca pode ser excluído. É o fallback que impede que qualquer outro idioma mostre lacunas, e o idioma padrão atual também não pode ser desativado nem excluído.