Localizando o Firefox OS

Nesse guia, nós mostraremos o quão fácil é localizar o Firefox OS, especificamente a interface Gaia e seus aplicativos. Nós começaremos ajudando a configurar seu computador, localizar as strings Gaia e finalmente como executar o teste l10n no seu trabalho.

Reunindo as ferramentas

A fim de ser capaz de obter os arquivos fonte do Gaia e testar a sua localização no desktop, você precisa certificar-se que possui os seguintes utilitários instalados:

GNU make: make é uma pequena ferramenta útil para criar binários a partir do código fonte. Ele virá bem a calhar quando você estiver pronto para testar seu trabalho no l10n. Baixar e instalara o make é fácil e pode ser feito diretamente do site do GNU. Se você estiver usando o OSX, você precisa instalar o XCode e a ferramenta do XCode para linha de comando a partir do site da App Store.
git: git é um sistema de controle de versão usado para armazenar o código fonte do Gaia. Para baixar e instalar acesse o site.
Python: Python é uma linguagem de programação que também ajuda a criar imagens Firefox OS para testes do l10n. Para baixar e instalar acesse o site.
Mercurial (hg): Mercurial (hg) é outro sistema de controle de versão que armazena versões estáveis do Gaia usado pelo l10n, bem como os repositórios locais. Para baixar e instalar acesse o site.
compare-locales: compare-locales é um script Python que ajuda aos localizadores avaliar seu trabalho e separar novos conteúdos a localizar do material já localizado (o que chamamos de diff). Para baixar e instalar acesse a wiki page. Observer que isso somente é necessário se você está localizando o Gaia usando somente ferramentas de linha de comando ou um editor de texto. Se você estiver usando outros tipos de ferramente como Pootle, Transifex, ou Pontoon, você não precisa disso.

Configurando um repo local

Uma vez que você baixou e instalou todos os softwares listados acima, é hora de pegar os fontes e localizar as strings no seu computador.

Na sua linha de comando, navege no diretório onde estão armazenados os fontes do Gaia e as strings a serem localizadas.
Usando hg, clone o repo en-US (inglês americano) no localização padrão com o seguinte comando:
```
hg clone https://hg.mozilla.org/gaia-l10n/en-US
```
Agora, clone seus repositórios locais usando o comando com a estrutura abaixo. No exemplo, a segunda linha faz a clonagem do repositório Chinês Tradicional em um diretório adequado.
```
hg clone https://hg.mozilla.org/gaia-l10n/your-locale-code
hg clone https://hg.mozilla.org/gaia-l10n/zh-TW/ B2G/gaia/locales/zh-TW
```

Agora execute o seguinte comando:

LOCALE_BASEDIR=locales/ LOCALES_FILE=locales/languages_mine.json make

Arquivos locais devem ser listados no arquivo languages_mine.json, que adotará uma estrutura como essa:

{
  "en-US" : "English (US)",
  "fr" : "Français (fr)"
}

Nesse arquivo você deve ter uma lista de strings prontas para você traduzir! Por favor observe que se você estiver iniciando uma nova localização do Firefox OS, você não precisa criar um diff já que todas as strings ainda não foram traduzidas

Nota: Verifique esse gist para construir um script automatizado.

Traduzindo strings Gaia

O workflow de tradução do Gaia depende fortemente de quais ferramentas você está usando para o trabalho. Essa parte do trabalho é similar à fase de tradução para outros produtos Mozilla. O artigo Guia rápido de localização - fase de tradução contém uma lista de todas as ferramentas usadas para traduzir strings nos produtos Mozilla com tutoriais de como utilizá-las para o trabalho de tradução. Essa página será útil para você caso você faça parte de uma equipe tentando decidir qual ferramenta utilizar para traduzir as strings Gaia ou se você estiver procurando um tutorial para sua equipe utilizar.

Teste l10n para Firefox OS

Existem dois métodos principais para executar testes l10n no Firefox OS: compilações para desktop ou para dispositivos móveis. Atualmente o método desktop é o mais utilizado para teste l10n.

Teste Desktop l10n

Baixe e instale o último boot2gecko nightly desktop em https://ftp.mozilla.org/pub/mozilla.org/b2g/nightly/latest-mozilla-b2g18/e baixe o pacote correspondente ao seu sistema operacional. Procure por pacotes que contém a palavra localizer. Isso indica que a compilação tem os locais listados em languages-all.json habilitados.
Clone a última versão do Gaia navegando no diretório em seu desktop onde você gostaria de baixar e execute esse comando: git clone git://github.com/mozilla-b2g/gaia.git
Se sua equipe está localizando o Firefox OS pela primeira vez, você precisa habilitar seu local. Se não, pegue uma bebida enquanto os outros habilitam o local para você.
1. Na linha de comando, navegue dentro do seu clone do Gaia e execute esse comando para clonar seu repo local: hg clone ssh://hg.mozilla.org/gaia-l10n/your-locale-code
2. Abra o arquivo languages.json no diretório shared/resources no repositório Gaia que você acabou de clonar.
3. Inclua a informação do seu local seguindo esse formato: "en-US" : "English (US)", e salve o arquivo.
4. Finalmente, execute o comando make multilocale. Isso habilita seu local no desktop.
Crie seu perfil Gaia executando o comando: DEBUG=1 make -C gaia profile
Finalmente, você pode executar o Firefox OS com seu perfil local e começar os testes. Faça isso com o comando: b2g/b2g -profile gaia/profile. Se você estiver usando OSX, execute esse comando: /Applications/B2G.app/Contents/MacOS/b2g -profile gaia/profile
Para atualizar sua compilação desktop, simplesmente navege no seu repo Gaia clonado e execute o comando: git pull

Teste no l10n mobile

Essa seção crescerá assim que mais dispositivos que suportam o Firefox OS fiquem disponíveis aos localizadores.

O que verificar quando testar l10n

Testes de localização para um sistema operacional móvel possui algumas similaridades com testes para aplicações desktop. A seguir um guia do que deve ser verificado quando for fazer os testes:

Verifique se suas traduções cabem dentro dos elementos de texto da interface do usuário.
Verifique se o tom, estilo e terminologia é consistente em todo o produto.
Procure por termos não traduzidos na inteface. Esses podem ser termos embutidos no código no Gaia ou pode ter sido causado por erros de identificação dos elementos.
Certifique-se de que os formatos de data e hora estão de acordo com os padrões regionais.

Encontrando bugs específicos de localização

Aqui alguns links para o bugzilla para mostrar alguns exemplos de bugs encontrados durante a utilização dos telefones. Isso lhe dá uma ideia de onde verificar bugs bem como um exemplo de como preencher esses tipos de bugs.

https://bit.ly/100bcsC - Uma lista geral de bugs l10n B2G
https://bugzilla.mozilla.org/show_bug.cgi?id=846060
https://bugzilla.mozilla.org/show_bug.cgi?id=852739

Regras gerais para registrar um bug relacionado à Localização:

Se um bug é específico de um idioma, registre-o como Mozilla Localization (abaixo de outros produtos) e inclua o localizador na cópia (cc). Não se esqueça de sinalizar seu bug adequadamente.
Se não for específico de um idioma, registre-o sob o produto FirefoxOS, e inclua o localizador em cópia (cc). Não se esqueça de sinalizar seu bug adequadamente.
Se você está em dúvida, registre-o sob o produto FirefoxOS, e inclua o localizador em cópia (cc). Não se esqueça de sinalizar seu bug adequadamente.

Para aqueles que usarem Moztrap, procure casos de teste existentes nas tags FirefoxOS localization e veja se você pode usá-los. Isso também é uma boa forma de testar as localizações do Firefox OS.

E agora?

Você está pronto para iniciar a localização! Abra sua ferramenta favorita l10n e mãos a obra! Como sempre, se você tiver dúvidas que não foram cobertas nesse documento, por favor envie-a para mozilla.dev.l10n newsgroup.