[Qgis-community-team] doc translation

[matteo]

Meanwhile I paste my summary of the git commands, please 
add/correct/criticize:


*Step 1*

Get an account on github.com

*Step 2*

Search for QGIS-Documentation repository and fork the repository just 
pushing the fork button.

*Step 3*

Go on the main page of the repository and click on *Settings*and change 
the default branch from *master*to *manual_en_v1.8*

*Step 4*

Now you should copy the repository on your computer; open a the terminal 
and go in the folder in which you want and type:

*git clone https://github.com/*your_name_on_github*/QGIS-Documentation.git*

This command create an exactly copy of the QGIS-Documentation repository 
on your computer.

*Step 5*

In the terminal type

*sh scripts/pre_translate.sh en*

*en*has to be changed in the abbreviation of your language, e.g. *it*for 
Italian

*Step 6*

Go on and translate the files with a translation tools like QT-Linguist.

*Step 7*

When you are finished with the translations you can verify if the file 
is correct. Simply run:

*sh script/post_translate.sh en*

change *en* with your language

*Step 8*

Now you have to add the changes. Open a terminal and type:

*git add -f path_to_the_file.po*

And you have to add a comment to this file, type:

*git commit -m "comment_here"*

*Step **9*

The translated files are present only on your cloned repository. For 
sync the cloned repository to the forked one type:

*git push origin manual_en_v1.8*

*Step **10*

If you go on your homepage of github.com you will see that you 
repository has changed and the files you translated appear in the folders.

The final step is to sync your forked repository with the main one. Just 
click on the button *pull request *and confirm. If you want you can add 
another comment to the file.

When the maintainers of the master repository accept your request the 
files will be merged with the original one.

*Step 11*

Be aware that when you fork the main repository from github it's like 
you take a picture of that. The updated made on the main repository will 
not appear neither on your forked repository nor in your cloned one.

So once in a while you have to update both your repositories. Open a 
terminal, go in the directory where you cloned the repository and create 
a remote:

*git remote add upstream https://github.com/qgis/QGIS-Documentation.git*

Update the remote:

*git fetch upstream*

Copy the updates from the upstream to the manual_en_v1.8 branch

*git rebase upstream/manual_en_v1.8 branch*

Updates are only on the cloned repository, so sync it with the fork on 
github.com

*git push origin manual_en_v1.8*




-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.osgeo.org/pipermail/qgis-community-team/attachments/20130413/126b3e0c/attachment-0001.html>