Update 'How to translate the program'

Helge-Mikael Nordgård 2021-10-04 14:04:56 +00:00
parent b61f0d60ba
commit d8036e4bbf

@ -5,5 +5,23 @@ When you have downloaded and installed Qt Linguist, [head over to the repository
When you are done with the translation you can either send the translation file to the [master branch maintainer](https://git.outlands.no/heno), or upload it yourself using Git. Here is a short walkthrough using Git command line (there are graphical interfaces also, but for the sake of simplicity, I am only going to cover command line as this is easier to follow without pasting in screenshots): When you are done with the translation you can either send the translation file to the [master branch maintainer](https://git.outlands.no/heno), or upload it yourself using Git. Here is a short walkthrough using Git command line (there are graphical interfaces also, but for the sake of simplicity, I am only going to cover command line as this is easier to follow without pasting in screenshots):
1. [Download the git](https://git-scm.com/downloads) client and install it 1. [Download the git](https://git-scm.com/downloads) client and install it
2. Open up a Git command line window. Under windows this should have been added to your start menu (search for 'git cmd') 2. Open up a Git command line window. Under windows this should have been added to your start menu (search for *'git cmd'*)
3. Navigate * First we have to configure git by telling git your real name and email address. Do this with:
1. git config --global user.name "FIRST_NAME LAST_NAME"
2. git config --global user.email "MY_NAME@example.com"
on the command line. Make sure your email address matches the same email address you use on this repository
3. Navigate to the folder you want to download the source code repository
4. type 'git clone https://git.outlands.no/heno/Saeterprosjekt.git'
You now have an exact replica of the latest commit of the master branch of the entire source code tree. Open up your translation file under *'Saeterprosjekt/trans'* Make your changes, go back to the git command line window you opened under pt 2, and make sure you are in the *'Saeterprosjekt'* folder.
5. To upload the changes to the repository, type:
1. *'git add trans\TRANSLATION-FILE'* (substitute TRANSLATION-FILE with the name of the actual file)
2. *'git commit -m "[YOUR-COMMENT]"* (substitute YOUR-COMMENT with a descriptive comment about the work and/or changes)
3. Then finally: *'git push -u origin master'*
That is a brief and simple tutorial on how you not only translate the program, but also a very elementory introduction to git. If you want to dig deeper into this, you can head over and read the following resources from external sites:
* Read the [Qt Linguist Manual](https://doc.qt.io/qt-5/linguist-translators.html) *(from doc.qt.io)*
* Read a more comprehensive [introduction on Git](https://git-scm.com/docs/gittutorial) *(from git-scm.com)*
* Look through some [graphical Git interface alternatives](https://git-scm.com/download/gui/windows) *(from git-scm.com)*