diff --git a/How-to-translate.md b/How-to-translate.md index 70989e7..edfb7ec 100644 --- a/How-to-translate.md +++ b/How-to-translate.md @@ -1,10 +1,25 @@ This article will show you how you can help to translate this project. # General preparation -1. Install git, gettext and po4a. -2. Fork this project. -3. Clone your fork on your computer. -4. (Optional:) Get an editor for po files or use an online service for it. +It would be best if you create a Linux work environment. +If you're not familiar with Linux, try to take the [Distrochooser test](https://distrochooser.de/en/). +It might help you to choose one of the many Linux distributions. +Anyway, the following text will assume that you have chosen Ubuntu or Kubuntu or something like that. + +1. Install git on your computer. + > **git:** A versioning software so that you can keep track in software projects on which changing has taken place at what time and circumstances. This is what github is all about. + + **Installation on (K)Ubuntu:** Open the console and type `sudo apt-get install git`, type in your password (you won't see any dots or stars in there while typing) and it is going to be installed. + + +2. If not already done, create a github account. +then [add it to your github account](https://help.github.com/articles/adding-a-new-ssh-key-to-your-github-account/). +3. Go to [this github project page](https://github.com/pampanic/pam_panic/wiki/How-to-translate) and fork this project. (Click on **Fork** in the upper right.) + > **Forking:** You are about to create an own version of a project. It will copy its content to your account under a new project, and github will note that this fork exist. After you pressed the Fork button you will be in your **own** project afterwards. + +4. [Clone your fork](https://help.github.com/articles/cloning-a-repository/) you just made from this project +5. (Optional:) Get an editor for po files like `poedit` or use an online service for it. + **Installation on (K)Ubuntu:** `sudo apt-get install poedit` Are you new to .po files? You might want to read about [The .po structure](https://github.com/pampanic/pam_panic/wiki/The-.po-structure).