XYplorer Beta Club

Code: Select all

========================================================================
XYPLORER TRANSLATION GUIDE - 2012-10-31 20:36
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

IMPORTANT NOTE TO TRANSLATORS
=============================
Do not start yet with the serious work! This first version is just for 
playing. Try something. Look for questions and problems. Give feedback.

Download Test Package
~~~~~~~~~~~~~~~~~~~~~
Download link to "Reference.lng" which you can use together with "Language.ini" for playing:

  http://www.xyplorer.com/download/Language.zip

The test "Reference.lng" has two translations right at the beginning just show that it works:
  co.0001= OK--- O.K.
  co.0002= Cancel--- Abbrechen

Files
~~~~~
- "Language.ini" in App Data Folder points to the current language file
  Sample contents of "Language.ini":
    [Settings]
    LanguageFile=Reference.lng
  Without "Language.ini" the app will load with embedded English strings.
- You must restart XYplorer to reread an updated language file.
- "TipOfTheDay.htm" contents are NOT included. This file should be translated by itself if desired.
- "CatalogDefault.dat" contents are NOT included. This file should be 
  translated by itself if desired. (Currently the app will NOT load 
  "CatalogDefault.dat" when a language other than English is loaded.

Format of Reference.lng
~~~~~~~~~~~~~~~~~~~~~~~

- The file is organized in various sections. For internal reasons 
  mostly. Ultimately it's all about speed and memory.

- sample entry:
  co.0074= Toggle Info Panel--- Toggle Info &Panel
  -------  -----------------    ------------------
  ID       ORIGINAL             TRANSLATION

- do not change ID
- do not change ORIGINAL
- do not change the order of items
- just work on the TRANSLATION
- keep spaces left and right
- some ORIGINALs are prefixed with a tzype descriptor to guide the translator:
  - caption:    -> mind the length!! (GUI item should not break layout)
  - menu:       -> length not important.
  - tooltip:    -> length not important.
  - tag:        -> length not important.
- do not translate <$variables>
- ; you can add comment lines as you like by prefixing them with ;
- Line feeds are written as \n.
- Tabs are written as \t.
- Accelerators (&Panel) can be given in TRANSLATION. They are not shown in ORIGINAL.

Grammatical Number
~~~~~~~~~~~~~~~~~~
Examples:
  <#> <file;files> found
  <#> <file;~s> found
  <#> <file;~s> <has been;have been> found
  <#> <file;~s> and <2:#> <2:folder;~s>
Explanation:
  <#>   = the number itself
  <singular form;plural form> = a word (noun/adj/verb) in agreement to this number
  ~     = placeholder for the first form (practical in many languages with affixing morphology)
  <2:#> = a second number itself (agreeing with <2:folder;~s>)

- Grammatical number is preset to Western European (English, German, Italian, Portuguese, Spanish) type <one;other>
- Note that French (n3) might need <zero/one;other> (ask me for details)
- Other number systems are supported (ask me for details), e.g. Russian/Slavic (n5) <one;few;many;other>
- There is a scripting function for debugging grammatical number:
  ::lang_testnum "<#> <n5:файл;файла;файлов;файлов>", 11

Suffixes
~~~~~~~~
- Do not translate {suffixes}; they are just there for disambiguation, e.g.: cut{noun} vs cut{infinitive} vs cut{imperative} vs cut{perfect participle}
- "{dropdown}": careful with the the commas or semicolons; don't add or remove!! a mistake will confuse the commands!!
- "{menu}": careful with the the commas or semicolons; don't add or remove!! a mistake will confuse the commands!!
========================================================================

Code: Select all

 $refNm = "Reference.lng";
 $sep = "--- ";
 $tart = "12"; // adjust here so you can resume your work peacefully...
 $base = readfile("<curitem>");
 $filename = "<curname>";
 $tt = gettoken($base, count, "<crlf>");
 IF ($refNm == $filename) { }
 ELSEIF ($refNm != $filename) {
//a cool 'ok/cancel' feature is planned... someday, one day...
 echo "warning!<crlf>Chosen<crlf>'$filename'doesn't match expected<crlf>'$refNm' for the file name...";
            }
 $ttfix = $tt - $tart;
 while($tart <= $tt) {
 $tart++;
 $tk = gettoken($base, $tart, "<crlf>");

 $ctrl++;
 $tst = gettoken($tk, 2, "$sep");
 IF ($tst == "") { continue; }
 ELSEIF ($tst != "")   {

 $src = gettoken($tk, 1, "$sep");
//expect better output for ops to go the same day the 'ok/cancel' reaches the light...
 $tr = input("Enter the string to be translated, please! (# $ctrl processing now, $ttfix to go...)", "Source: $src", $tst, w, , 1240);
 writefile ("XYtranslation" . "$filename", "$src" . "$sep" . "$tr<crlf>", a);
           }
         }


 echo "Now, publish it!<crlf>(don't forget to adjust the header for the produced file...)";

Code: Select all

    + MLS: Now the *.LNG file may also be in ASCII format (non-Unicode).
      For most West-European languages ASCII is okay.