Idiomas

Aviso Importante: Nos próximos atualizações, o suporte a idiomas está sendo continuamente expandido. Na versão atual, as traduções são suportadas apenas diretamente nos elementos. O suporte à sintaxe [txt:] será removido no futuro. Traduções personalizadas serão mantidas, mas não poderão ser mais alteradas. Este capítulo contém a descrição do editor de idiomas, mas este ainda não pode ser usado.

O Editor de Idiomas está dividido em duas seções. A configuração e o banco de dados. O banco de dados contém todas as traduções presentes no Antcas Control. Na aba Configuração, uma nova entrada pode ser editada ou complementada. Quando um elemento na tabela é clicado, a edição da tradução é exibida. O editor também contém versões que permitem criar exportações e importações das traduções.

Idiomas e Territórios

Um idioma é sempre definido junto com o território (geralmente o país), mas pode ser vinculado. Por exemplo, Alemão (Alemanha) é gerado a partir de Alemão (Suíça). Traduções personalizadas, no entanto, devem ser definidas para cada território. O território também fornece o esquema regional disponível. Atualmente, isso está fixamente vinculado à tradução.

Geral

Uma tradução é sempre feita do Inglês para o idioma de destino. Nunca do Alemão para outro idioma. Isso deve ser levado em consideração. No futuro, textos também poderão ser traduzidos diretamente no Antcas Control usando IA. Um contexto deve ser usado sempre que possível. Para frases longas, uma variável e o texto devem ser definidos. Uma variável de tradução é sempre sensível a maiúsculas e minúsculas. Maiúsculas e minúsculas são sempre diferenciadas.

Para as traduções, deve-se observar que os sinais de pontuação sempre devem corresponder. Se uma frase termina com um ponto, a tradução também deve conter um ponto. O mesmo vale para maiúsculas e minúsculas. Palavras podem ter sido definidas várias vezes. Por exemplo, uma palavra open aberto e uma palavra Open Aberto são usadas. Quando traduzidas, a primeira letra deve ser traduzida da mesma forma. Palavras em maiúsculas devem ser evitadas: OPEN ABERTO nunca deve ser usado. Em vários idiomas, não há diferenciação entre maiúsculas e minúsculas. Por exemplo, em Japonês. Portanto, a palavra não é destacada. Use sempre um formato de texto claro.

Uma tradução pode ser definida como singular ou plural. Como placeholders podem ser definidos para substituir áreas de texto, o plural é usado quando esses placeholders são usados como contadores. Um texto existente não pode ser convertido de plural para singular e vice-versa.

Contexto

No Antcas Control, esta área é chamada de contexto, mas também é conhecida como domínio. Uma tradução pode conter vários contextos. Um exemplo é a palavra Open. A palavra pode descrever um estado aberto ou também abrir. Portanto, um contexto deve ser definido. Um contexto é sempre sensível a maiúsculas e minúsculas. Maiúsculas e minúsculas são diferenciadas. Recomenda-se sempre escrever todos os contextos em minúsculas. Se uma palavra já foi definida da mesma forma em outro contexto, pode ser duplicada. No entanto, o contexto deve ser sempre definido de forma única.

Aviso: Um contexto deve sempre ser definido da mesma forma. Nunca noun, nouns e Noun ao mesmo tempo.

Contexto Descrição
noun Substantivo. Geralmente usado para palavras como Order Pedido, Open Abrir, Close Fechar, Play Jogo, Print Imprimir etc. Na maioria das vezes, qualquer atividade.
verb Verbo. Por exemplo, Order Pedir, Open Aberto, Close Fechar, Play Jogo, Print Imprimir etc.
adj Adjetivo. Por exemplo, Left Restante, Open Aberto, Close Fechar etc.
menu O texto é definido em um menu. Este contexto aparece frequentemente no Antcas Control.
dialog Usado para mensagens que envolvem interação do usuário. Por exemplo, OK OK, Cancel Cancelar, Save Salvar etc.

Placeholders

Nos textos, placeholders podem ser usados. Estes são formatados automaticamente dependendo do tipo. Isso simplifica o uso de um texto, pois a formatação não precisa ser especificada aninhada. Uma lista dos placeholders pode ser encontrada na tabela abaixo. Os placeholders estão alinhados ao comando sprintf, que também é usado no bloco de função STR_FORMAT. Deve-se observar que a ordem pode ser definida arbitrariamente. No entanto, isso deve ocorrer no texto original sem ordem arbitrária. A tradução é definida da seguinte forma:

Singular: One of %2$i Windows is open. Um de %2$i Janelas está aberto.
Plural: %i of %i Windows are open. %i de %i Janelas estão abertas.

O placeholder %i é usado aqui. Como na versão singular apenas o último é usado, este deve ser definido com %2$i. Que define o índice 2. O primeiro índice começa com 1.

Placeholder Descrição
%s String simples. Quando este placeholder é usado, o valor é exibido um a um.
%i Define um número inteiro (Integer). O número sempre é arredondado para o próximo número inteiro. Além disso, formatações são adicionadas. 12345.67 12'345
%f Define um número de ponto flutuante (Float). 12345.67 12'345.67
%F Como %f, mas mantém um ponto como vírgula e não define uma aspa. 12345.67 12345.67
%z Saída em unidade SI. 12345 12.35k
%Z Saída em bytes (conversão binária com 1'024) 12345 12.06k

Singular e Plural

Uma tradução pode ter várias formas de plural, dependendo do idioma. No entanto, a língua fonte sempre é especificada com singular e plural quando estas são usadas. Isso serve como fallback se nenhuma tradução estiver presente. Se uma tradução plural foi definida, esta não pode ser convertida em uma versão singular e vice-versa. Cada idioma no Antcas Control já contém as regras para a conversão das formas.