From d8036e4bbf64b38fa2a77bb483a07a7aa9d8006b Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Helge-Mikael=20Nordg=C3=A5rd?= Date: Mon, 4 Oct 2021 14:04:56 +0000 Subject: [PATCH] Update 'How to translate the program' --- How-to-translate-the-program.md | 22 ++++++++++++++++++++-- 1 file changed, 20 insertions(+), 2 deletions(-) diff --git a/How-to-translate-the-program.md b/How-to-translate-the-program.md index b04e9f5..741a94c 100644 --- a/How-to-translate-the-program.md +++ b/How-to-translate-the-program.md @@ -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): 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') -3. Navigate \ No newline at end of file +2. Open up a Git command line window. Under windows this should have been added to your start menu (search for *'git cmd'*) + * 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)*