### Add a new language to pmt (guide)

On this page, I will tell you how to add languages to pmt. This is not a difficult thing :)

##### Send ready stuff
 - Send ready translations via pull requests. After making the necessary checks, if there is no problem, I will accept it.
 - Proper commit messages are required.
 - If there is an error, I will mention it in the pull request comments.
 - Once you accept it, I (YZBruh) will implement the rest of the necessary things.
 - It may take 5 days for me to notice :P

##### Little important notes
 - You don't have to be a professional to do this thing.
 - There will be only one place you need to pay attention to, I will explain it.
 - There is no need to know C.
 - You can edit existing translations.
 - You may need ready pmt to understand some things.
 - If you are on an x86 PC, you can compile and use it, but the functions will never work.

##### Understanding general logic
 All the texts (strings) in pmt are like variables in bash. I mean:

 ```
 Bash
     export missing_operand="missing operand."

     APPLYING:
          ~ $ echo -n "$missing_operand\n" # for more detail I used the -n argument
          missing operand
          ~ $ 

 C / C++
     const char* _Nonnull missing_operand = "missing operand.";
     const std::string missing_operand = "missing operand.";

     APPLYING (C / C++):
          printf("%s\n", missing_operand); // Move to new line with '\n' character
          std::cout << missing_operand << std::endl; // Move to new line with std::endl
 ```

 For example, let's take the output directly in pmt without any arguments and process the variables and structures behind the work.

 ```
 Shell
      ~ $ pmt
      pmt: missing operand
      Try `pmt --help' for more information.
      ~ $

 Code pieces (C)
      struct pmt_langdb_general en = {
          // other translations
          .missing_operand = "missing operand",
          .try_h = "Try",
          .for_more = "for more information",
          // other translations
      }

      // pmt code functions [ logging ]
      LOGE("%s\n%s `%s --help' %s.\n, missing_operand, try_h, argv[0], for_more); // LOGE is error logger (pmt). argv[0] = execution name
 ```

In short, there are variables for texts. And I made these dynamic by using [struct](https://chatgpt.com/share/a798b57c-7e29-4b17-8887-f230414e57bd) method in C. You just need to add translation :)

##### Translating main program texts (relevant part)

 - Let's open our jni/languages.c source file.
 - Now, let's create the translation with the ready-made struct structure (see jni/include/pmt-stringkeys.h for the structure).
 ```
 // Main
 struct pmt_langdb_general <LANGUAGE_PREFIX> = { // LANGUAGE_PREFIX must be the corresponding abbreviation of the language in English. For example, it's like en in English.
      // translations
 }

 // Example
 struct pmt_langdb_general en = {
      // translation
 }
 ```
 - We need to add some information about the language.
 ```
 struct pmt_langdb_general <LANGUAGE_PREFIX> = {
      .lang_by_s = // Names of those who made the translation. It's up to you. Do you use & between more than one person?
      .language = // Language name. For example English
      .lang_prefix = // Language prefix. For example en
      // other translations
 }

 // Example
 struct pmt_langdb_general en = {
      .lang_by_s = "YZBruh & r0manas",
      .language = "English",
      .lang_prefix = "en",
      // other translations
      .by_str = "By" // Example for end translate
 }

 // CRITIC WARNING: Do not add ',' to the end of the last translation text. But others always...
 ```
 - Now do the others :)
 - Now let me explain the documentation...

##### Document texts translation (relevant part)

 - Let's open our jni/languages.c source file.
 - Now, let's create the translation with the ready-made struct structure (see jni/include/pmt-stringkeys.h for the structure).
 ```
 struct pmt_langdb_docs <LANGUAGE_PREFIX>_docs = {
      // translations
 }

 // Example
 struct pmt_langdb_docs en_docs = {
      // translations
 }

 // CRITIC WARNING: Do not add ',' to the end of the last translation text. But others always...
 ```
 - Make translations by taking examples from existing ones. And definitely do it regularly by getting help message from pmt :D

##### General things to do in translation

 - Open jni/languages.c
 - Go down a bit...
```
struct pmt_langdb_langs lang[] = {
    {"en"},
    {"tr"},
    // language prefix. {"<LANGUAGE_PREFIX>"},
    {NULL} // PLEASE DO NOT ADD IT UNDER 'NULL'!
};

// Example
struct pmt_langdb_langs lang[] = {
    {"en"},
    {"tr"},
    {"az"},
    {NULL}
};

// Add the language you are translating into these existing language prefixes. I will fix the errors here (if there is an error)
```

##### Notes
 - Apologies for the crappy current language control structure :(
 - You can ask your questions: <t.me / ShawkTeam | Topics | pmt>