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 <[email protected]> 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 > [email protected] > http://lists.osgeo.org/mailman/listinfo/portugal > >
_______________________________________________ Portugal mailing list [email protected] http://lists.osgeo.org/mailman/listinfo/portugal
