Guia de Localização do Fedora (Em Construção)
Introdução
Se você encontrar um erro de tipografia nesse manual, ou se você pensou em uma maneira de fazer esse manual melhor, por favor sinta-se livre para ou editar a página diretamente ou simplesmente enviar um email para a lista de discussão do Projeto de Localização do Fedora. Se você tem sugestões para melhorar a documentação, tente ser o mais específico possivel quando for descrevê-la. Se você encontrou algum erro, por favor inclua o número da seção e algum parte do texto, assim nós podemos encontrá-lo facilmente.
O Site do Projeto de Localização do Fedora é https://fedora.transifex.net/.
Obtendo Ajuda
Se você tiver perguntas, envie-as para a lista de discussão, ou peça ajuda via IRC, em irc.freenode.org no canal #fedora-l10n.
Você pode encontrar muitas informações no Transifex em: http://help.transifex.net.
Tornando-se um Tradutor do Fedora
Para começar você precisa se registrar e ganhar acesso ao material em que vai trabalhar:
- Criar uma Conta no Transifex
- Inscrevendo-se na Lista de Discussão
- Apresentando-se
- Entrando para seu time de tradução Fedora
Sua apresentação é importante. Ela aumenta suas chances de ser aprovado para ter acesso para alterações. Você pode também desejar criar uma conta no Bugzilla para trabalhar em bugs relatados por usuários.
Começando a usar o Transifex
O Fedora utiliza o Transifex para gerenciar seu fluxo de trabalho de localização. Esses passos irão guia-lo através da criação de uma conta no Transifex e da entrada para seu time.
Criando uma Conta no Transifex
- Visite https://fedora.transifex.net/ e clique no link "Register" no topo a direita.
- Preencha o formulário e clique em "Register"! Você pode usar seu email do Fedora ou o mesmo email que utilizou para criar sua conta no Fedora. Escolha uma boa senha (como descrito acima). Essa senha pode ser restaurado se você esquecê-la.
- Verifique seu email. Um email deve chegar logo para verificar seu endereço de email. Haverá um link nele - clique no link!
- Você deve estar habilitado para efetuar logon no Transifex com suas credenciais agora.
Entrando para seu time de tradução do Fedora
- Visite a página dos Times do Fedora em https://www.transifex.net/projects/p/fedora/teams/.
- Se seu idioma estiver lá, clique nele.
- Você deve ver uma lista dos membros, o líder (coordenador). Clique em "Join this team" para pedir para entrar para o time.
- O líder do time irá receber uma notificação sobre seu pedido. Ele irá verificar sua informação, e verificar onde você fez sua apresentação.
- Se tudo correr bem, o mantenedor irá aceitar seu pedido, e você irá receber uma notificação.
Isso pode levar entre algumas horas ou dias. Se levar mais tempo, clique no nome de usuário do mantenedor e envie uma mensagem para o mesmo pedindo mais informações.
Inscrevendo-se na Lista de Discussão
- Visite https://admin.fedoraproject.org/mailman/listinfo/trans e inscreva-se na lista de discussão principal de tradução.
- Aguarde pelo email de confirmação que contém um link para confirmar sua inscrição. Clique no link para confirmar sua inscrição.
Verifique https://fedoraproject.org/wiki/L10N/Teams para ver se existe uma lista de discussão especial para seu idioma. Se houver, inscreva-se nessa lista também.
Apresentando-se
- Crie uma página pessoal em https://fedoraproject.org/wiki/User:Username. Isso é muito útil para que os contribuidores do Fedora se conheçam e entrem em contato uns com os outros. Você irá precisar criar uma conta no Fedora para isso.
- Envie uma breve apresentação sua para a lista de discussão trans e para a lista do seu time local com as instruções desse link https://fedoraproject.org/wiki/L10N_Self_introduction. Por favor lembre-se de incluir seu nome de usuário no FAS e seu idioma. Com essas informações, o coordenador do seu idioma pode identificar você e aprová-lo como um tradutor no time dele.
Criando uma Conta no Bugzilla
Se for necessário utilizar o Bugzilla, crie uma conta visitando https://bugzilla.redhat.com/bugzilla/createaccount.cgi.
Criando uma Conta do Fedora
Os passos abaixo guiarão você através da criação de uma Conta do Fedora.
Registrando-se para uma Conta
- Para se inscrever para uma conta do Fedora, primeiro visite https://admin.fedoraproject.org/accounts e selecione "New Account".
- Preencha o nome de usuário, nome completo e email, e clique em "Sign up". Sua senha será enviada por email.
- Volte para https://admin.fedoraproject.org/accounts e faça logon com sua senha. A página de boas vindas será exibida, e ela irá lembrá-lo que o CLA não está completo que uma chave SSH não foi submetida.
- Para enviar uma chave SSH pública e a chave GPG ID, clique em "My Account" ou vá para https://admin.fedoraproject.org/accounts/user/edit.
- Na página de edição da sua Conta, entre com sua chave GPG ID no campo "GPG Key ID:". Para a chave SSH pública, clique no botão "Browse..." localizado próximo ao campo "Public SSH Key:" e especifique sua chave SSH pública.
- O número de telefone e o endereço postal também são necessários para autenticar o CLA. Essas informações NÃO são acessíveis por outros exceto o grupo de administradores.Por favor veja a Política de Privacidade Fedora em https://fedoraproject.org/wiki/Legal:PrivacyPolicy.
- Os outros campos serão mostrados para qualquer outro membro que visitar a sua página.
- Agora clique em "Save!" localizado no rodapé dessa página para salvar a informação.
Validando o CLA
Você deve completar o Contributors License Agreement, ou CLA.
- Visite https://admin.fedoraproject.org/accounts e faça logon em sua conta utilizando seu nome de usuário e senha obtido no processo anterior.
- Na página de Boa Vindas, clique em "Complete the CLA" ou visite https://admin.fedoraproject.org/accounts/user/edit.
- Se a informação do número do telefone e endereço postal não tiver sido fornecida ainda, a página de edição de conta será mostrada. Caso contrário, a página do Fedora Contributor License Agreement será exibida. Leia todo o acordo com atenção e clique em "I agree" se você concordar com o mesmo.
- A página de visualização do usuário será exibida e mostraráo campo "CLA" com a informação "CLA Done".
Traduzindo
A parte de um pacote de software que pode ser traduzida é disponibilizada em um ou mais arquivos PO. Alguns projetos podem utilizar outros formatos de arquivos também, como os QT TS. Esses arquivos podem ser mantidos em qualquer um dos sistemas de controle de versão, dependendo do projeto, como o Subversion, Mercurial, e Git. Eles devem ser hospedados no fedorahosted.org ou outros sistemas.
Esse capítulo explica como traduzir os projetos que utilizan o Transifex para gerenciar seu fluxo de trabalho L10N. Os tradutores podem trabalhar na interface web ou linha de comando para obter e enviar arquivos. Antes de começar, você primeiro deve preparar as pastas que irão guardar seus arquivos po.
Usando o Transifex, você pode contribuir tanto para o Fedora quanto para os Projetos Upstream. Os projetos do Fedora são aqueles em que o próprio Fedora é o upstream, por exemplo, mantendo e manejando. Eles são normalmente utilizados apenas pelo Fedora.
Listando Projetos do Fedora que podem ser traduzidos
- Visite https://www.transifex.net/projects/p/fedora/.
- Escolha o tipo de projeto do Fedora que você deseja traduzir, escolhendo o release (lançamento) apropriado. Você deve visualizar o próprio Fedora, a Documentação do Fedora e outros projetos upstream. Clique na versão com a qual você deseja contribuir. Por exemplo, clicando no link apontando para https://www.transifex.net/projects/p/fedora/r/fedora-15/l/pt_BR/.
- A nova página exibe todas as estatísticas para esse lançamento por idioma. Escolha seu idioma.
- Essa página exibe todos os arquivos que podem ser traduzidos para esse lançamento. Clique em uma das linhas da tabela para obter informações desse arquivo no qual você está interessado.
Você pode marcar essa página como favorita para referência futura. Nós a chamaremos de página "Lançamento-Idioma" agora. Aqui está uma URL de exemplo:
https://www.transifex.net/projects/p/fedora/r/fedora-15/l/ja/
Traduzindo Online
A maneira mais fácil de traduzir é utilizar o Editor Web do Transifex. Ele tem uma interface intuitiva que não necessita que você baixe arquivos e os reenvie depois.
- Siga as instruções acima para encontrar o recurso que está procurando.
- No popup você deverá ver o botão "Translate Now!". Se você estiver logado no Transifex e for membro daquele grupo de idioma, ele deverá ser clicável. Clique nele!
- Você estará agora no Editor Web do Transifex, que tem o codinome Lotte. Vá em frente e traduza o quanto quiser, e no fim, clique em "Save and Exit".
Nota: Quando você estiver traduzindo online, o arquivo é automaticamente bloqueado e outras pessoas são notificadas do seu trabalho. Nunca traduza algo que outro tradutor já tiver bloqueado -- você estará sobreescrevendo o trabalho dele!
Traduzindo Offline
Se você prefere traduzir offline, você pode simplesmente baixar e enviar os arquivos de tradução.
Antes de você baixar quaisquer arquivos, nós sugerimos que você prepare uma pasta para guardar os arquivos. A estrutura descrita abaixo é apenas um exemplo, e a sua estrutura pode ser formada de modo diferente:
mkdir -p ~/fedora-translations
Obtendo e Traduzindo Projetos
Você pode baixar um arquivo para traduzir. Você pode precisar se comunicar com outros tradutores em seu time de idioma para evitar conflitos. Se você não tiver certeza, por favor entre em contato com o coordenador do seu time. Bloquear o arquivo que está sendo traduzido também irá evitar conflitos.
- Na sua página lançamento-idioma encontre o recurso (linha da tabela) que você deseja traduzir clique nele para que o popup apareça.
- Clique no botão "Download for Translation" para baixar o arquivo com o nome da sua escolha para a pasta que criamos no item anterior (ex. abrt.po).
- Agora o arquivo está em sua estação de trabalho local e pronto para ser traduzido. Traduza o arquivo em seu idioma usando o editor PO de sua escolha, como o gtranslate ou o Poedit.
- Verifique a integridade do seu arquivo antes de enviar usando
msgfmt -cvo /dev/null abrt.po. Se qualquer mensagem de erro aparecer, resolva o erro antes de enviar.
Submetendo os Projetos
Após finalizar a tradução, submeta o arquivo usando a mesma interface.
- Tenha certeza de que você está logado no Transifex.
- Navegue de volta a página Lançamento-idioma e clique no recurso que você deseja enviar. Tenha cuidado para não enviar em um recurso diferente.
- Clique no botão "Upload", localize o arquivo traduzido no seu sistema local, e envie-o. A interface levará um tempo (para arquivos grandes mais de um minuto) e finalmente irá notificá-lo de que o arquivo foi enviado com sucesso. Se você receber uma mensagem de erro ou outra qualquer, por favor envie a mensagem para a lista de discussão do Fedora Localization Project para que a mesma seja endereçada.
Adicionando novos arquivos
Se um dos recursos no lançamento não tem versão para o seu idioma, você deve vê-lo faltando da página do lançamento, e visualizar uma lista separada no rodapé da página como o seguinte:
The following resources don't have any translations in Japanese: 1) python-fedora → python-fedora.pot
- Clique nele. Ele irá levá-lo para a página principal do recurso.
- Clique em "Add Translation".
- Escolha seu idioma e clique em "Translate Online".
- Siga e traduza algumas linhas ou o arquivo inteiro e depois clique em "Save and Exit".
Revisando a Tradução de Software
Desde o Fedora 12, uma imagem live é composta para download para revisão e correção de tradução de software na interface do usuário. A imagem live é composta uma semana antes da data limite para tradução de softwares no Fedora e disponibilizada na data limite para tradução. Essa imagem deve incluir todas as traduções enviadas até o momento.
Para revisar sua tradução como parte do software, siga esses passos:
1. Vá para a pasta do pacote que deseja revisar. Por exemplo:
cd ~/myproject/system-config-printer/
2. Converta o arquivo po para um arquivo mo usando o msgfmt com a opção -o :
msgfmt -o system-config-printer.mo ja.po
3. Faça um backup dos arquivos já existentes e depois sobrescreva os antigos:
su - cp /usr/share/locale/ja/LC_MESSAGES/system-config-printer.mo system-config-printer.mo-backup mv system-config-printer.mo /usr/share/locale/ja/LC_MESSAGES/ exit
4. Revise o pacote com as linhas traduzidas como parte do aplicativo. O aplicativo relativo ao pacote traduzido é executado com as linhas traduzidas.
LANG=ja_JP.UTF-8 system-config-printer
Traduzindo Documentação
Traduzir os documentos do Fedora é exatamente a mesma coisa de traduzir os softwares, então apenas sigas as mesmas instruções acima. Tenha certeza de estar selecionando o "Fedora Documentation" lançamento, que te levará a uma página "lançamento-idioma" separada, especializada em documentação.
Exemplo:
https://www.transifex.net/projects/p/fedora/r/fedora-15-docs/
Entendendo a Estrutura de Múltiplos Arquivos
A documentação do Fedora usa principalmente o Publican, diferente de um software, um guia tem uma estrutura com múltiplos arquivos po. Cada arquivo po equivale a um capítulo do guia. O nome do arquivo normalmente consiste no nome do capítulo. Essa estrutura é muito útil, uma vez que mais de um tradutor pode trabalhar no mesmo guia ao mesmo tempo.
Novos Idiomas: Criando o arquivo docbook-locales
Se você estiver criando a primeira tradução para um idioma, você deve primeiro traduzir o arquivo docbook-locales utilizado em todos os documentos para seu idioma.
- Navegue para o Projeto Docbook-Locales do Fedora: https://www.transifex.net/projects/p/fedora-docbook-locales/resource/locale/
- Se o seu idioma não estiver lá, apenas adicione-o.
- Envie um bug ao Bugzilla para o produto "Fedora Documentation" com o componente "docs-request". Você deve deixar os detalhes em branco, ou colocar o nome do guia que deseja traduzir. Anexe arquivos se necessário. Se você tiver problemas para enviar o arquivo po usando as instruções acima, anexe-o ao bug.
- Use o seguinte sumário no bug: "[ja]: New language support request."
Quais Documentos Traduzir
As mais importantes documentações para cada lançamento do Fedora são as seguintes:
- Docs :: docbook-locales
- Docs :: Release Notes
- Docs :: About Fedora
- Docs :: Readme
- Docs :: Readme Burning ISOs
- Docs :: Readme Live Image
Traduzindo Websites
Os websites do Fedora também podem ser traduzidos via Transifex. Você pode ver todos os projetos relacionados aos websites do Fedora, na página Fedora Websites do lançamento.
https://www.transifex.net/projects/p/fedora/r/fedora-websites/
Baixe, traduza e envie os projetos do website da mesma forma que faz com os projetos de software. Por favor note que as atualizações são adicionadas de tempos em tempos. Elas podem ser diárias ou semanais, dependendo do status do lançamento.Se você notar que sua tradução não é atualizada durante um tempo, você deve pedir uma atualização ao time de websites na lista de discussão deles. Ao adicionar a lista de discussão L10N ao CC, você vai dizer aos outros times que já pediu uma atualização.
Adicionando Novos Arquivos Po
Adicione o novo arquivo po da mesma forma como faz com projetos de software. Se você estiver criando a primeira tradução para um idioma, você deve notificar o time de websites para adicionar seu idioma ao site. Envie seu pedido na lista de discussão L10N,assim o time de websites pode adicionar a configuração do seu idioma ao Apache do site.
Revisando
Geralmente, o time de websites disponibiliza sites fornece sites de testes que podem ser utilizados para revisar sua tradução.
Traduzindo Páginas da Wiki
A Fedora Wiki é um repositório para informações relativas ao projeto. Algumas dessas páginas podem precisar de tradução para melhor servir a comunidade Fedora. Esse capítulo irá mostrar, passo a passo, o método correto de traduzir uma página da wiki.
Encontrando a Versão em Inglês da Página
O Inglês é o idioma base para a Wiki do Projeto Fedora, então existe a necessidade de uma versão em inglês da página na qual você está trabalhando.(Se não houver uma versão em inglês da página que você está trabalhando, veja "Lidando com Traduções sem uma Versão em Inglês", abaixo.)
Se já existir um modelo de idioma no topo da página, clique no link "edit" a direita na caixa de idiomas e siga para o passo 4; caso contrário siga para o passo 2.
Se a página que você criou não tem versão em inglês, crie uma nova página para a versão em inglês, adicione o modelo { { template|autolang } } como anotado abaixo, e depois adicione o modelo {{[[Template:needs
english|needs
english]]}}. Isso irá marcar a página como precisando de tradução para inglês, assim como criar uma página base.
Adicionando o Modelo de Idioma a Página em Inglês
Edite a página em inglês e, no topo da mesma, adicione o modelo { { autolang|base=yes } } (sem espaços):
{ { autolang|base=yes } }
A parte "base=yes" é necessária para a versão em inglês. Salve a página.
Criando o Modelo do Idioma
O { { template|autolang } } modelo autolang deve fornecer um link para você configurar a caixa de idioma. Clique nele e uma página de edição será exibida. Não altere nenhuma parte do conteúdo e salve a página. Depois clique no link "edit" no lado direito da caixa de idioma.
Adicionando seu Idioma ao Modelo
Nesse ponto você deve ter uma caixa de edição aberta com a sintaxe de modelo que se parece com isso: { { lang|en|page=Base page name } }
O texto entre "lang" e "page=" é a lista de códigos de idioma. Adicione o código do idioma para o qual você está traduzindo na lista. Use essa lista para determinar o código do MediaWiki próprio:
http://fedoraproject.org/wiki http://svn.wikimedia.org/viewvc/mediawiki/trunk/phase3/languages/Names.php?view=markup
Por favor, mantenha a lista em ordem alfabética. Isso quer dizer que Alemão (de) deve vir antes de Inglês (en), por exemplo.
Começando a Nova página
Clique no link vermelho para seu idioma para iniciar uma nova página. Adicione o modelo { { autolang } } ao topo da página, assim a lista de idiomas estará lá. Tenha certeza de não incluir "base=yes" para páginas secundários que não sejam em inglês.
Movendo Páginas da Antiga Configuração de Idioma
Para páginas traduzidas que não estiverem no local correto, siga os passos 1-4. Depois copie o título da nova página (ex. Fedora Project Wiki/de). Clique no link "move" no topo da página antiga no campo "para novo título". Edite a nova página e adicione o modelo { { autolang } } ao topo.