Mozilla em Klingon, Sindarin e até em Português

Todo mundo que já tenha tido algum contato com grandes projetos de Software
Livre sabe que a localização e internacionalização de programas é de fato
importante e até essencial, em especial em lugares como a França e Itália;
onde se praticamente não usa softwares que não estejam traduzidos ou pelo
menos sejam traduzíveis. O projeto Mozilla possui um ótimo time L10N,
porém, a ferramenta que atualmente todos usam não é muito produtiva nem
útil para se criar um método mais colaborativo acerca das traduções.

Caso você queira traduzir alguma parte da suíte Seamonkey, suponhamos o
componente ChatZilla, você precisa fazer o download da última versão do
Mozilla Translator (datada de 2002), instalar o kit de desenvolvimento
Java (SDK), estudar e fuçar sobre como o MT funciona e aí sim começar a
traduzir. Nesse caso, a curva de aprendizado do MT é absurda demais ao
ponto de pedirmos pra qualquer um ir lá e aprender a usá-lo. Entretanto,
caso aprenda a usar, você não irá conseguir facilmente, por exemplo,
mesclar dois pacotes de traduções no MT, o que torna as coisas difíceis,
pois somente uma pessoa poderá trabalhar na tradução diretamente. Pelo
menos foi isso que nós do Mozilla Brasil notamos.

Alguns projetos fantásticos como o KDE e GNOME usam por padrão o format POT
para traduzir seus arquivos de interface e programas, e assim fazem um
trabalho simples e rápido. Então, o que você acharia de usar algo similar
pra traduzir o T-Rex? Você até poderia usar o Kbabel ou alguma outra
ferramenta popular para traduzir os arquivos DTD do Mozilla. Ops, espere,
um arquivo DTD não é um POT! Antes de mais nada precisamos tentar entender
os termos usados:

- Arquivos POT são arquivos com os textos e mensagens originais de um
determinado programa mais os mesmos campos duplicados
(respectivamente, msgid e msgstr), em branco, para que uma tradução
possa ser feita. POT signifca Portable Object Template, ou em
português, Modelo de Objeto Portável e é através dele que a tradução
começa. Quase todos os Softwares Livres decentes possuem suporte a
gnu/gettext, que é a biblioteca que dá os arquivos POT como frutos.

- Arquivos DTD significam Document Type Definition, ou Definição de
Tipo de Documento e os arquivos do Mozilla usam esse tipo de
mecanismo pra armazenar textos e mensagens da interface. Se você abrir
algum DTD do Mozilla você poderá ver um monte de sentenças <!ENTITY.

Os problemas ao lidar com esse tipo de coisa podem acabar usando o
Translate. O kit Translate é o novo mozpotools, um conjunto de scripts,
GPL, feitos em Python, que são usados pra se converter arquivos DTD para o
formato POT e que também faz a operação inversa. Na verdade o kit converte
os arquivos para outros PO, porém não existe uma grande diferença entre
arquivos .pot e .po.

Atualmente o kit de scripts Translate pode ser encontrado no SourceForge e
você só precisa ter uma versão recente do Python (a 2.3 está ok, mas tenha
também o pacote de desenvolvimento respectivo). Para finalmente testar os
scripts, você precisará baixá-los via CVS (uma versão 0.4 empacotada está
para sair, contudo, você pode criar seu próprio pacote através do script
setup.py, detalhado mais abaixo):

	bash$ cvs -d:pserver:anonymous@cvs.sourceforge.net:/cvsroot/translate login
	bash$ cvs -z3 -d:pserver:anonymous@cvs.sourceforge.net:/cvsroot/translate co src

Basta pressionar ENTER quando perguntado sobre a senha a ser usada. Após
isso você terá um diretório /src, e entrando dentro dele você irá ver o
script setup.py. Para ver todas as opções dele, use:

	bash$ ./setup.py --help-commands

Dê uma olhada nas opções build e install. Você precisa usá-las para poder
ter os scripts e arquivos instalados e fáceis de usar. Caso queira de
antemão saber o que significa cada opção do setup.py, pule até o fim deste
documento:

	bash$ ./setup.py build ; ./setup.py install

Agora você já tem os executáveis moz2po e po2moz dentro do seu
diretório /usr/bin e alguns arquivos auxiliares dentro
de /usr/lib/python2.3/site-packages/translate/. Vamos testar logo! Eu
sugiro que você crie um diretório separado para isso, mas também copie o
diretório en-US da sua distribuição do Mozilla. Esse diretório en-US será
usado como guia pelo script para converter os arquivos DTD originais. Eu
estou assumindo que você irá traduzir o Mozilla para português, mas no
exemplo abaixo você poderia usar qualquer código de língua.

	bash$ mkdir pt-BR ; cp -R /home/voce/mozilla-1.6/chrome/en-US/ .

Note que eu peguei o diretório en-US de dentro de um pacote pronto, como o
mozilla-1.6-xft-gtk2-pc-linux.tar.bz2. De qualquer maneira, poderia pegar
ele de dentro do arquivo en-US.jar, que fica no seu chrome; ele é um
arquivo ZIP comum, basta renomear para .zip e extrair seu conteúdo, ou
mesmo abrir pelo Konqueror, que tem suporte nativo à arquivos ZIP. Você
poderia inclusive pegar esse diretório en-US de qualquer projeto mozilla,
suponhamos da extensão Checky, encontrada no MozDev.

Agora está na hora de finalmente converter os arquivos DTD de dentro do
diretório en-US, para o formato PO, que serão armazenados então no
diretório criado pt-BR. Mais uma vez, você pode ler uma descrição de cada
opção do script no fim deste documento, mas vamos logo com isso, usando
uma barra de progresso mais detalhista:

	bash$ moz2po --progress=verbose -i en-US/ -o pt-BR/

Agora você já tem o diretório pt-BR repleto de arquivos .po convertidos dos
respectivos .dtd e também dos arquivos .properties! Se você checar alguns
deles você irá encontrar trechos como esse:

	#: windowtitle.label
	msgid "About Popups"
	msgstr ""

Você só precisa abrir tais arquivos em algum decente editor de traduções
como o Kbabel ou mesmo no GNU/Emacs no modo PO - na verdade, você poderia
até mesmo usar o VI. Caso não saiba traduzir um arquivo .po, dê uma passada
no site do TLDP ou na área de desenvolvedores do KDE, uma vez que esse
documento não explica como usar o Kbabel ou mesmo editar diretamente os
arquivos .po. Mas não esquente, esse jeito é muito mais fácil do que usar
o Mozilla Translator. Veja uma lista de links interessantes sobre esse
assunto no fim do documento.

Beleza, você é uma pessoa esperta e distribuiu alguns arquivos .po para um
certo grupo de pessoas, assim eles poderão traduzir tudo e depois enviar
de volta para você já tudo ok e traduzido para o português (nesse caso, como
dito anteriormente). Você agora precisa fazer a operação inversa,
convertendo os arquivos PO para o formato DTD, para então poder empacotar
tudo e criar seu próprio .xpi ou mesmo um build inteiro.

	bash$ po2moz --progress=verbose -i pt-BR/ -t en-US/ -o NEW/

Na linha acima, o diretório de entrada (-i) possui os arquivos traduzidos,
e usará como guia o diretório en-US (-t) com os DTD. O resultado será
passado para o diretório de saída (-o) chamado NEW, que deverá ser
renomeado para pt-BR, após tudo isso.

Pronto! Você passou por todo o processo de converter, traduzir e converter
novamente os arquivos. Acredito que esse documento possa ser útil para
você, para que possa fácil e colaborativamente traduzir os softwares
Mozilla para sua língua nativa ou quem sabe mesmo pra Klingon ou
Sindarin... não?

Se você tiver alguma sugestão, crítica ou algo que faça o texto ficar
melhor, envie um e-mail para a lista -dev do Mozilla Brasil, que é pra
onde esse texto foi originalmente pensado. O link está logo abaixo.

Caio Begotti entercaio@uol.com.br
Mozilla Brasil http://www.mozilla.org.br

Descrição das opções:

Do script setup.py, que fica no diretório /src mencionado inicialmente:

~/translate/src: ./setup.py --help-commands
Comandos padrões:
  build            prepara tudo que é necessário para instalar
  build_py         "cria" módulos Python puros (copia pro diretório build)
  build_ext        cria extensões C/C++ (compila/linka pro diretório build)
  build_clib       cria bibliotecas C/C++ usadas pelas extensões Python
  build_scripts    "cria" os scripts (copia e corrige a linha #!)
  clean            limpa todo o lixo criado pelo comando build
  install          instala tudo do diretório build
  install_lib      instala todos os módulos Python (extensões e os puros)
  install_headers  instala os arquivos de cabeçalho C/C++
  install_scripts  instala os scripts (Python ou outros)
  install_data     instala os arquivos de dados
  sdist            cria um pacote com fontes (tarball, zip etc)
  register         registra o pacote com o índice de pacotes Python
  bdist            constrói um pacote (binário) pra distribuição
  bdist_dumb       constrói um pacote "nulo" pra distribuição
  bdist_rpm        constrói um pacote RPM pra distribuição
  bdist_wininst    constrói um instalador executável para o MS Windows

uso: setup.py [global_opts] cmd1 [cmd1_opts] [cmd2 [cmd2_opts] ...]
   ou: setup.py --help [cmd1 cmd2 ...]
   ou: setup.py --help-commands
   ou: setup.py comando --help



Do script moz2po localizado dentro do diretório /usr/bin/:

bash$: moz2po --help
uso: moz2po [opções] [--version] [-h|--help] [-i|--input ENTRADA]
[-t|--template GUIA] [-o|--output SAÍDA] [--progress PROGRESSO]

opções:
  --version             exibe a versão do programa e encerra o mesmo
  -h, --help            exibe esta mensagem de ajuda e encerra o programa
  -iENTRADa, --input=ENTRADA
                        lê os .dtd e .properties do diretório de entrada
  -tGUIA, --template=GUIA
                        lê do diretório modelo, arquivos .dtd e .properties
  -oSAÍDA, --output=SAÍDA
                        envia para o diretório SAÍDA os arquivos .po
  --progress=PROGRESSO  escolhe o tipo de barra: simple, console, verbose
                        ou curses
  -P, --pot             produz modelos .pot com msgstrs em branco



Do script po2moz, usado para converter do formato .po para o .dtd:

~/Desktop/CVS-translate/src: po2moz --help
uso: po2moz [opções] [--version] [-h|--help] [-i|--input ENTRADa]
[-t|--template GUIA] [-o|--output SAÍDA] [--progress PROGRESSO]

opçõess:

  --version             exibe a versão do programa e encerra o mesmo
  -h, --help            exibe esta mensagem de ajuda e encerra o programa
  -iENTRADa, --input=ENTRADA
                        lê os arquivos .po do diretório de entrada
  -tGUIA, --template=GUIA
                        lê os arquivos .po do diretório modelo
  -oSAÍDA, --output=SAÍDA
                        envia para o diretório SAÍDA os .dtd e .properties
  --progress=PROGRESSO  escolhe o tipo de barra: simple, console, verbose
                        ou curses



Referências:

http://translate.sf.net
http://l10ntools.mozdev.org
http://www.mozilla.org.br
http://translate.org.za
http://www.mozillatranslator.org
http://www.mozdev.org
http://tldp.org
http://i18n.kde.org/translation-howto/
http://www.mozilla.org/projects/l10n/
http://l10nzilla.mozdev.org

Referências locais:

man gettext (mais como um guia rápido)
info gettext (com informações detalhadas)

Micro-Faq:

1. Como eu poderia mesclar dois diretórios de diferentes línguas a fim de
obter um terceiro com ambas as mensagens em inglês e na minha língua
nativa?

No passado o Translate tinha um script chamado repot.py que fazia esse tipo
de coisa, mas hoje você pode usar normalmente o script moz2po, usando o
diretório de DTD da sua língua nativa como entrada e o diretório com os
originais DTD em inglês como guia:

	bash$ moz2po --progress=verbose -i sua_lingua -t en-US -o mesclados/

Assim você terá dentro do diretório mesclados/ um monte de arquivos .po com
ambas as linhas msgid e msgstr. Desse jeito:

	#: windowtitle.label
	msgid "About Popups"
	msgstr "Bloqueando popups - Mozilla"

2. Eu nunca usei o Kbabel pra traduzir alguma coisa! Me ajuda?

Ainda que o kit Translate converta arquivos DTD para o mesmo formato que o
Kbabel trabalha, não se pode dar qualquer suporte sobre isso. Por favor,
cheque a seção de links desse documento e do site translate.sf.net para
ver textos que possam te ajudar a usar o Kbabel.

3. Eu sou um usuário Windows: isso significa que eu nunca poderei usar o
formato .po para ajudar o time local de tradutores?

Absolutamente, não! Existe um interessante editor de arquivos .po para
Windows chamado poEdit. Dê uma procurada sobre ele.

4. Ok, o kit Translate é animal, mas eu não faço a mínima idéia sobre como
posso criar meu próprio pacote .xpi instalável. E agora?

É óbvio que você leu as instruções do MLP sobre esse tipo de situação,
certo? Por favor, vá até http://www.mozilla.org/projects/l10n/ para obter
mais informações sobre como criar pacotes .jar e/ou .xpi.

5. Existe algum outro jeito de converter arquivos DTD para outros formatos?

Bem... sim, existe. Veja o último link da lista de referências acima. O
programa l10nzilla faz isso usando PHP com banco de dados MySQL e uma
interface web em Java, usados pra traduzir diretamente os DTD de forma
online. No entanto, ele não me parece muito ágil e no fim acaba inventando
a roda novamente.

6. Quem fez esse kit Translate?

Um grupo de malucos sul-africanos, que fazem parte do esforço de tradução
do Mozilla, KDE e OpenOffice.org para todos os 11 idiomas diferentes que
são atualmente falados na África do Sul!