IdiomaSistema

De Stoq Wiki
Ir para: navegação, pesquisa

=== Idioma para a documentação do wiki

Índice

=

Inicialmente toda a documentação wiki do Stoq está sendo realizada em português. É tarefa futura da equipe Stoq traduzir esta documentação para inglês ou mesmo criar uma nova página com uma versão neste idioma.

=== Idioma padrão para os bugs no bugzilla

=

Inicialmente o idioma padrão para os bugs será o português embora seja também aceito o idioma inglês em alguns casos. Bugs cujo comentário de abertura seja em inglês deverão receber todos os comentários no mesmo idioma por questão de coerência. Bugs abertos em português também deverão seguir a mesma linha, recebendo todos os comentários na mesma lingua.

=== Idioma padrão do sistema

=

A codificação do sistema será inteiramente feita em inglês. Isto inclui:

  • Header dos módulos
  • Nomes de variáveis, classes e métodos
  • Todas as strings que serão vistas pelo usuário
  • Comentários dentro do código

=== Formato para exibição de texto ao usuário

=

É tarefa do Stoq ser facilmente traduzido para vários idiomas. Para isso usaremos os recursos da biblioteca gettext de forma a facilitar o trabalho de tradução em outras línguas.

Todas as strings que forem exibidas aos usuários usarão portanto o seguinte formato

_('string')

onde _() será uma função genérica que iremos importar em um local adequado do sistema e que será usada largamente.

Em síntese, uma linha de código que tradicionalmente seria escrita como

print "a simple output"

deverá ser reeescrita como

print _('a simple output')