[Portugal] qgis 2.0, tradução em PT_PT

[Alexandre Neto]

Bom dia a todos,

Depois de algumas lutas com o git (que é muito útil mas também algo
confuso), decidi escrever uma cábula como o "melhor" workflow para
contribuir para o projectos no github, neste caso adaptado à tradução do
QGIS. É um pouco extenso mas no final há uma cábula com os comandos mais
repetitivos.

Espero que seja útil a quem se quiser aventurar por esta via.

Alexandre Neto


*INSTALAR GIT*
*Windows*
Fazer download* *aqui <http://git-scm.com/download/win> e instalar o exe.
Depois de instalado, usa-se o atalho "git Bash" para abrir uma consola.

*Linux*
Abrir uma consola e fazer

    sudo apt-get install git
*
*
*CONFIGURAR*
*1. Criar uma conta em GitHub.com e aceder à mesma;*
*2. Procurar "Quantum-GIS" na pesquisa;*
*2. Criar um fork do Quantum-GIS na tua conta (canto superior direito);*
*3. Obter cópia local dos ficheiros do fork criado:*

Para copiar os todos os ficheiro para o computador local executar o
seguinte comando git na consola:

    git clone https://github.com/*username*/Quantum-GIS.git

Nesta fase, será criada uma pasta Quantum-GIS, com uma cópia local do
teu repositório, com uma ligação remota ao fork pessoal, ao que o git
dá o nome de "origin", e para onde podemos mais tarde enviar
alterações realizadas.


*4. configurar o repositório original*

Para se actualizar os ficheiros locais e remotos em relação ao
repositório "oficial" do QGIS (onde outras pessoas deram os seus
contributos) é necessário configurar a localização do mesmo,
chamando-lhe "upstream", já dentro da recém criada pasta "Quantum-GIS"
fazemos:

    git remote add upstream https://github.com/qgis/Quantum-GIS.git

*ROTINA HABITUAL PARA EFECTUAR ALTERAÇÕES*


*1. Actualizar ficheiros em relação ao origin (github pessoal)*

NOTA: Este passo só é necessário caso se usar mais do que um
computador (ou mais que uma pessoa usem o mesmo fork) para fazer
alterações, caso contrário a sua cópia local estará sempre mais actual
ou igual ao "origin". Para actualizar os ficheiros locais em relação
ao repositório pessoal remoto "origin":
    git pull origin

Que irá buscar todas as alterações que foram entretanto enviadas (de
outro computador) para o repositório pessoal remoto no github.

*2. Actualizar os ficheiros em relação ao upstream*

Para manter o seu fork actualizado, de cada vez que se pretender fazer
alterações aos ficheiros, convém verificar antes se houve alterações
no repositório original do Quantum-GIS (o "upstream"):
    git pull --rebase upstream master

Tendo havido alterações no upstream, a cópia local é actualizada, e as
alterações integradas nos seus ficheiros. (Nota: por causa do --rebase
qualquer alteração que já tenha sido feita por si, é colocada no topo
das alterações feitas por outros)

*3. Efectuar alterações ao ficheiros que desejar
*
(No caso das traduções editando e gravando o ficheiro
Quantum-GIS/i18n/qgis_pt_PT.ts com o QtLinguist)
*
4. registar as alterações feitas*

Depois de feitas alterações, gravamos o seu estado através do comando commit:

    git commit -ma "comentário sobre as alterações"

NOTA: cada commit representa um "ponto de restauro" ao qual podemos
voltar atrás em caso detectarmos algum problema.

*5. Arrumar a casa

Para "arrumar" os nossos repositórios pessoais (locais e remotos),
antes de fazer o pull request, podemos voltar a fazer um pull --rebase
com o upstream, para colocar as nossas alterações por cima de qualquer
coisa que tenha sido entretanto feita.

*

    git pull --rebase upstream master

*

6. Enviar as alterações para o seu repositório pessoal remoto*

Depois de efectuadas alterações depois de feito o commit, podemos
enviá-los para o nosso repositório pessoal (o fork criado
anteriormente):

    git push origin master


*SUBMETER ALTERAÇÕES AO PROJECTO OFICIAL
*Satisfeitos com o nosso trabalho e achando que o conjunto de
alterações feitas será de valor para o projecto, solicitamos a
integração do mesmo no repositório oficial através de um pull request.

O pull request é feito na conta do Github criada no site, no fork
pessoal criado, através do botão Pull request que está no topo da
página. Depois de enviado é aguardar que alguém com direitos de
escrita no projecto QGIS aceite as alterações.


*CÁBULA*

*   git pull origin

    git pull --rebase upstream master

--> Efectuar alterações <--

    git commit -ma "comentário"

    git pull --rebase upstream master

    git push origin master



2013/5/22 Luís de Sousa <luis.a.de.sousa  gmail.com>

Giovanni, só para confirmar que é este o ficheiro:
>
> https://github.com/qgis/Quantum-GIS/blob/master/i18n/qgis_pt_PT.ts
>
> Ainda indica a versão 1.8. Abraço,
>
> Luís
>
> _______________________________________________
> Portugal mailing list
> Portugal  lists.osgeo.org
> http://lists.osgeo.org/mailman/listinfo/portugal
>
>
-------------- próxima parte ----------
Um anexo em HTML foi limpo...
URL: <http://lists.osgeo.org/pipermail/portugal/attachments/20130523/70453dea/attachment.html>