home *** CD-ROM | disk | FTP | other *** search
/ Amiga Format CD 1 / amigaformatcd01.iso / pd / text_editors / bed / localizationkit / readme < prev    next >
Encoding:
Text File  |  1996-04-30  |  3.7 KB  |  120 lines
  1.                  ---------------------------------------------
  2.                  --- $VER: Localization Kit 1.0 (14.01.96) ---
  3.                  ---                                       ---
  4.                  ---         LOCALIZATION KIT              ---
  5.                  ---------------------------------------------
  6.  
  7.  
  8.   This Localization Kit is composed by the following files:
  9.  
  10.   <*> BED.cd      - Descriptor file. Contains the built-in english strings.
  11.   <*> BED.ct      - CT file. File ready to be filled with the translated strings.
  12.   <*> Startup.dfn - Definition file.
  13.   <*> Install     - Installer script strings.
  14.   <*> Read Me     - This help file.
  15.  
  16.  
  17.   To make a localization for Blacks Editor you have to edit three files:
  18.  
  19.   1) Install
  20.   2) Startup.dfn
  21.   3) BED.ct
  22.  
  23.  
  24.   - 1) Install --------------------------------------------------------------
  25.  
  26.   This file will be used to create a installer script for your language.
  27.  
  28.   Translate the quoted strings into your language, keeping the special
  29.   characters as \n, %s, %ld, etc.
  30.  
  31.  
  32.   - 2) Startup.dfn ----------------------------------------------------------
  33.  
  34.   This file will be used to have BED default menus in your language.
  35.  
  36.   Translate the menu labels into your language.
  37.  
  38.  
  39.   - 3) BED.ct ----------------------------------------------------------
  40.  
  41.   This file will be used to create a BED.catalog for your language and
  42.   localize all the strings of BED.
  43.  
  44.   To produce the catalog file you must have the CatComp utility, distributed
  45.   by Commodore in the Developer Utility Package.
  46.  
  47.   Otherwise you can produce anyway the translation and sent it to me, then I
  48.   will make the catalog and include it in the next update of Blacks Editor.
  49.  
  50.   I cannot include the Catcomp utility directly because it is copyright by
  51.   Commodore.
  52.  
  53.  
  54.   ---------------------------------
  55.   --- How to make a translation ---
  56.   ---------------------------------
  57.  
  58.   A translation is actually a .ct file containing the translated strings. This
  59.   kit has a BED.ct file, which is ready to be filled with your translation. I
  60.   advise not to edit it directly, but to make a copy of it for each
  61.   translation, naming it for example italiano.ct, français.ct or deutsch.ct.
  62.   Then for each .ct file follow these steps:
  63.  
  64.   1) Load the <filename>.ct file within BED or another text editor.
  65.  
  66.   2) Substitute the XXX in the three first lines with:
  67.      * the filename, the version number, the date.
  68.      * the codeset must be 0
  69.      * the language is français, deutsch, or whatever you choose.
  70.  
  71.   3) Fill the empty lines with the translation of the strings.
  72.  
  73.     For example, the first string is:
  74.  
  75.  
  76.     ;
  77.     STRING_OPEN_FILE
  78.  
  79.     ; Open File
  80.  
  81.  
  82.     For an Italian translation you must fill it like this:
  83.  
  84.     ;
  85.     STRING_OPEN_FILE
  86.     Apri File
  87.     ;Open File
  88.  
  89.  
  90.   ---------------------------------------
  91.   --- How to produce the catalog file ---
  92.   ---------------------------------------
  93.  
  94.   (Only of you have the CatComp utility)
  95.  
  96.   If you have translated all the strings you can produce the catalog file
  97.   entering in the Shell the following command:
  98.  
  99.   CatComp BED.cd <filename>.ct CATALOG=<filename>.catalog
  100.  
  101.  
  102.   --------------------------------------
  103.   --- How to send me the translation ---
  104.   --------------------------------------
  105.  
  106.   If you have made a correct .ct file then send it to me at the following
  107.   address:
  108.  
  109.   <Marco Negri> s592345@vm.uni-bocconi.it
  110.  
  111.   The best thing is to make a .lha file with your translations and send it to
  112.   me uuencoded.
  113.  
  114.   If you can produce a final catalog file then you can upload it directly on
  115.   Aminet. (Maybe it'll be included in an Aminet CD, and can receive it for
  116.   free)
  117.  
  118.   In this case I ask you to send the catalog to me too, so I can include it in
  119.   the next update of Blacks Editor.
  120.