Archive Viewer

ARCHIVE VIEWER LANGUAGE SUPPORT Language support in Archive Viewer resides in two files: ARCV_xx.MSG - User interface text (compiled from ARCV_xx.MKM) ARCV_xx.HLP - Help file (compiled from ARCV_xx.IPF) where 'xx' is the two-letter language code (see below). By default, Archive Viewer automatically sets the language it uses by checking the %LANG% environment variable for the current system language, and loading the above files for that language if they exist. (If files for that language do not exist, the English files are used instead.) You can force Archive Viewer to use a particular language by dragging a supported locale item from the Locale object under System Setup into the Archive Viewer window. Archive Viewer will then use that language in the future. (This is stored in the settings file ARCVIEW.INI, which resides in the same directory as OS2.INI, normally <bootdrive>\OS2. You can revert to the automatic language selection behaviour by editing the file with REGEDIT2 or the equivalent, and deleting the key "Archive Viewer" -> "Locale".) TRANSLATING ARCHIVE VIEWER To translate the above files into your language, you need the English source files ARCV_EN.MKM and ARCV_EN.IPF. These can be downloaded from the NetLabs VXApps SVN repository at: http://trac.netlabs.org/vxapps/browser/projects/arcview/v2/trunk/en Copy these two files to ARCV_xx.MKM and ARCV_xx.IPF respectively, where 'xx' is the two-letter abbreviation for your language (see below). The language abbreviation generally corresponds to the two-character ISO language codes used in OS/2 locale names, with the exception of those for Simplified and Traditional Chinese (for which see the items marked '*' in the list below). Some of the more common language codes are: * CX Chinese, Simplified (used in China - PRC) * TW Chinese, Traditional (used in Taiwan and Hong Kong) NL Dutch EN English FR French DE German IT Italian JA Japanese KO Korean PO Portuguese RU Russian ES Spanish SV Swedish NOTE: The SVN repository contains translated files for a number of languages which were used with older versions of the Archive Viewer. The following languages are currently out-of-date and/or incomplete with respect to the current version; however, they may be useful as a starting point for translation: FR, NL, SV, TW Translate the files as needed into your language. Both files use specific structures, but this is the same for all languages, so you can generally focus on simply translating the text itself. ARCV_xx.MKM is an OS/2 message source file. The syntax should be reasonably self-explanatory; refer to the "Tools Reference" book included with the IBM Developer's Toolkit for details. ARCV_xx.IPF is an IPF (IBM Information Presentation Facility (IPF) source file. This is a simple SGML-style markup language similar to HTML, albeit with its own particular syntax rules. Refer to the "IPF Programming Guide and Reference" book included with the IBM Developer's Toolkit for details. Once you have translated the files, you can build them yourself if you have the means to do so (see below); you are advised to do this if possible, in order to be able to verify that the translation works properly. When finished, please send the translated files to the Archive Viewer developer (via the email address listed at the end of this file). Even if you have built the compiled language files yourself, please send the translated source files as well. BUILDING THE LANGUAGE FILES Building the files requires that you have the IBM Developer's Toolkit installed (version 4.52 is recommended, although most versions should work). ARCV_xx.MKM must be compiled using the IBM Make Message File Utility (MKMSGF.EXE). The syntax (shown here for the English files) is: mkmsgf arcv_en.mkm arcv_en.msg Additional parameters might be needed for compiling languages other than those which use the Latin-1 character set (i.e. Russian and the East Asian languages); refer to the documentation for more information. ARCV_xx.IPF must be compiled using the IBM IPF Compiler (IPFC.EXE). The syntax (shown here for English) is: ipfc arcv_en.ipf Again, additional parameters might be needed for compiling certain languages; refer to the documentation for more information. DEVELOPER CONTACT INFORMATION Alex Taylor - alex (at) altsan (dot) org http://www.altsan.org/