Entendendo Subversion
O Subversion é um software para controle de versão dos arquivos traduzidos, é uma maneira de controlarmos as diversas versões existentes dos arquivos e alinharmos o trabalho em equipe dos desenvolvedores ao redor do mundo.
Para saber mais acesse o site: http://subversion.apache.org/faq.html
Para acessar os tutoriais oficiais do KDE, acesse o site: https://techbase.kde.org/Getting_Started/Sources/Subversion.
Instalação do Subversion
Para baixarmos/enviarmos os arquivos para traduzir, precisamos da versão cliente do Subversion, que deve ser instalado (caso sua distro não traga instalado por padrão) conforme as instruções abaixo de acordo com a sua distribuição:
Gentoo
[root@cascao ~]$ emerge -vk subversion
Debian,(K)Ubuntu
[root@cascao ~]# apt-get install subversion
Fedora
[root@cascao ~]# yum install subversion
Distribuições que suportam RPM
[root@cascao ~]# rpm -i subversion
Se houver algum erro de dependências provavelmente você terá que instalar também os seguintes pacotes: libapr0 e neon
Acesso ao repositório do KDE
Existem basicamente dois tipos de acesso ao repositório do KDE: o acesso autenticado e o acesso anônimo.
O acesso autenticado é utilizado por tradutores veteranos ou programadores do KDE. Este tipo de acesso permite não somente ler a partir do KDE, mas também alterar o conteúdo do repositório (por exemplo, atualizando traduções). O acesso anônimo está dentro do espírito do ‘software livre’. Qualquer um pode usá-lo para obter todo o código-fonte do KDE, incluindo os arquivos para a tradução. Neste documento, será apresentado o procedimento a ser adotado para obter os dados necessários para a tradução do KDE, tanto para o tradutor veterano como para o tradutor novato ou sem acesso de escrita ao SVN.
Administrar sua conta
A conta no repositório do Subversion do KDE é criada após um certo tempo de contribuição ao projeto. No link abaixo é explicado o processo de solicitação: https://techbase.kde.org/Contribute/Get_a_Contributor_Account
Atenção, apenas os tradutores veteranos serão aprovados. Se nenhum dos administradores pediu para você criar uma conta, não adianta solicitar, pois a criação necessita de nossa aprovação.
Baixando os arquivos
Usando o Instalador do KDE pt-BR
Todos os tradutores podem baixar os arquivos necessários para contribuir para o projeto a partir do SVN, seja através de um acesso autenticado ao SVN ou de um acesso anônimo. O Instalador KDE pt-BR deve ser usado para baixar estes arquivos, e ele permite os dois tipos de acesso ao SVN, facilitando em muito o trabalho de obtenção dos arquivos de tradução. Note que no padrão nosso adotado (caso use o instalador), os arquivos para traduzir ficarão em algum subdiretório de ~/kde.
O processo de baixar o arquivo para a sua máquina (KDE.ORG -> LOCALHOST) é conhecido como checkout. Para o acesso autenticado, existe o modo seguro de fazer isso (via SSL) e o comum. Na criação da conta você escolhe qual tipo deseja utilizar. Nesse exemplo a conta criada (boaglio) é segura, no comando abaixo a única diferença de sintaxe em relação ao comum é “+ssh”:
[fb@cascao ~]$ cd ~/kde
[fb@cascao kde]$ svn checkout svn+ssh://svn@svn.kde.org/home/kde/trunk/l10n/pt_BR/messages
U messages/kdeadmin/kpackage.po
U messages/kdeadmin/kpackage.po
U messages/extragear-multimedia/amarok.po
U messages/extragear-multimedia/desktop_extragear-multimedia_k3b.po
U messages/extragear-multimedia/desktop_extragear-multimedia_kmplayer.po
U messages/extragear-multimedia/kmplayer.po
…
U messages/extragear-graphics/gwenview.po
U messages/extragear-graphics/kst.po
U messages/extragear-utils/krecipes.po
U messages/extragear-utils/desktop_extragear-utils_krecipes.po
U messages/extragear-utils/desktop_extragear-utils_kdiff3.po
U messages/extragear-utils/desktop_extragear-utils_keurocalc.po
U messages/extragear-security/desktop_extragear-security_pwmanager.po
U messages/kdeaddons/uachangerplugin.po
Checked out revision 430090.
[fb@cascao kde]$
O comando acima baixa todos os arquivos de tradução da interface (messages) do nosso idioma (pt_BR). Para entender esta organização é necessário conhecer a estrutura do SVN do KDE.
Para obter o mesmo efeito usando o acesso anônimo, o comando seria o seguinte:
[fb@cascao kde]$ svn co svn://anonsvn.kde.org/home/kde/trunk/l10n-kde4/pt/messages
Observe que para o exemplo também foi criado um diretório “kde” na pasta do usuário local.
Enviando os arquivos
O envio de arquivos diretamente para o SVN só pode ser feito por tradutores veteranos, que possuem acesso de escrita ao SVN. Para os demais tradutores, siga o roteiro das atividades de tradução definido pelo projeto.
Para enviar o seu arquivo traduzido para o servidor do KDE (LOCALHOST -> KDE.ORG) fazemos o commit. Cada commit normalmente é feito por arquivo e obriga algum comentário seu:
[fb@cascao kde]$ cd messages/kdeadmin
[fb@cascao kdeadmin]$ svn ci -m “[KDE-i18n-pt_BR] traduzido por Fernando Boaglio” kpackage.po
Sending kpackage.po
Transmitting file data .
Committed revision 430094.
[fb@cascao kdeadmin]$
Note que nesse exemplo foi commitado o arquivo kpackage.po com o comentário “[KDE-i18n-pt_BR] traduzido por Fernando Boaglio”.
Para enviar arquivos de um diretório inteiro, use o comando:.
[fb@cascao kde]$ cd messages/kdeaddons
[fb@cascao kdeaddons]$ svn ci -m “[KDE-i18n-pt_BR] traduzido por Fernando Boaglio”
Enter passphrase for key ‘/home/fb/.ssh/id_dsa’:
Sending kdeaddons/ktimemon.po
Transmitting file data .
Committed revision 518817.
[fb@cascao kdeaddons]$
Adicionando arquivos
Novamente, esta tarefa só pode ser feita diretamente por tradutores veteranos.
Talvez não exista o arquivo que você deseja traduzir, para isso é necessário criar um arquivo .po e adiciona-lo ao projeto, e em seguida commitar.
#svn add arquivo.po
#svn ci -m “[KDE-i18n-pt_BR] traduzido por <SEU_NOME>” arquivo.po
Para criar um arquivo .po serão necessários os arquivos de template, ou seja, os arquivos .pot. Eles estão em um diretório separado, para baixá-los faça o comando:
#svn checkout svn+ssh://rpadula@svn.kde.org/home/kde/trunk/l10n/templates
Baixar atualizações do servidor
Este procedimento é o mesmo, seja para o acesso autenticado, seja para o acesso anônimo. Depois de baixar os arquivos você precisa baixar somente as atualizações.
[fb@cascao messages]$ svn up
Enter passphrase for key ‘/home/fb/.ssh/id_dsa’:
U extragear-utils/desktop_extragear-utils_kcfgcreator.po
U extragear-utils/desktop_extragear-utils_knetload.po
U extragear-utils/desktop_extragear-utils_kcpuload.po
A extragear-utils/desktop_extragear-utils_ktranslator.po
…
U extragear-utils/desktop_extragear-utils_kdiff3.po
U extragear-utils/desktop_extragear-utils_filelight.po
U extragear-utils/desktop_extragear-utils_keurocalc.po
U kdelibs/desktop_l10n.po
U kdelibs/desktop_kdelibs.po
U kdelibs/katepart.po
U kdelibs/kdelibs.po<br>
Updated to revision 518812.
[fb@cascao messages]$