WHAT IS TRANSLIT PROGRAM ======================== The TRANSLIT program is used to transliterate character codes. The ASCII table of characters (containing characters with codes 0 to 127) is a table for English language. For other languages many different schemes are used to represent their respective alphabets. Some use codes larger than 127, some use multicharacter sequences to represent a single letter in foreign alphabets. There is also UNICODE and other proposed standards to use units larger than 8-bits(1 byte) to represent foreign alphabets. For example, UNICODE will use 16-bit(2 byte) codes. At this moment, the TRANSLIT program supports only 8-bit codes, but will be expanded to UNICODE if there is enough interest. It is frequently necessary to convert from one representation to another representation of the foreign alphabet. E.g., in the Library of Congress transliteration, the Russian letter sha is transliterated as two Latin letters "sh" while the popular word processors use a code 232 (decimal), the RELCOM network uses a code 221, and the KOI7 set uses character "[" for the same letter. So if your screen driver, printer, word processor, etc. uses different codes than your text, you need to transliterate. The TRANSLIT program is a powerful tool for such tasks. It converts an input file in one representation to the output file in another representation using an appropriate, user defined, transliteration table. Transliteration table allows for very elaborate transliteration tasks and includes provisions for plain character sequences, character lists, regular expressions (flexible matches), SHIFT-OUT/IN sequences and more. The program comes with documentation and examples of popular transliteration schemes for Russian language. Other files will be added with your collaboration. FILES IN THE PROGRAM DISTRIBUTION ================================ The following files are currently in the distribution. They are all ASCII (text) files (with the exception on translit.tar.Z and translit.zip). Please note that the copyright notice requires that, if you distribute this program, you have to distribute the complete set of files. TRANSLIT is copyrighted: Copyright (c) Jan Labanowski and JKL Enterprises, Inc. Name Description DOCUMENTATION readme.bugs List of known bugs in translit. This file may change daily. It also contains info which files contain fixed code/transliteration files. The fixed code will be a part of next release and it is given here for testing and is not a part of the current release. readme.doc This file translit.ps PostScript version of program documentation and installation procedure translit.1 [nt]roff version of the above in the format of UN*X man page (use -man option with [nt]roff) translit.txt Plain text version of the above. order.txt Order form for ordering the executable program (compiled with installation script and instructions) TRANSLITERATION TABLES FOR RUSSIAN (read comments in the files) alt-gos.rus ALT to GOSTCII table alt-koi8.rus ALT to KOI8 table gos-alt.rus GOSTCII to ALT table gos-koi8.rus GOSTCII to KOI8 table hex-text.rus hexnumbers (e.g., =A6) to actual codes k8-tavtt.rus KOI8 to Bill Tavolga cyrttf truetype font mapping koi7-8.rus KOI7 to KOI8 table koi7nl-8.rus KOI7 (no Latin) to KOI8 table koi8-7.rus KOI8 to KOI7 table koi8-alt.rus KOI8 to ALT table koi8-gos.rus KOI8 to GOSTCII table koi8-lc.rus KOI8 to Library of Congress table koi8-phg.rus KOI8 to GOST transliteration koi8-php.rus KOI8 to Pokrovsky transliteration koi8-tex.rus KOI8 to LaTeX conversion phg-koi8.rus GOST transliteration to KOI8 pho-8sim.rus Simple phonetic to KOI8 pho-koi8.rus Various phonetic to KOI8 php-koi8.rus Pokrovsky transliteration to KOI8 tex-koi8.rus LaTeX to KOI8 EXAMPLES example.alt.uu uuencoded example in ALT example.ko8.uu uuencoded example in KOI8 example.pho phonetic transliteration example example.tex LaTeX example TRANSLIT PROGRAM SOURCE in C. translit.c Main program paths.h Include file reg_exp.h Include file reg_exp.c Modified regular expression package by H. Spencer reg_sub.c Modified regular expression package by H. Spencer PACKED FILES CONTAINING THE WHOLE DISTRIBUTION FROM ABOVE translit.tar.Z --- Compressed tar file with the whole distribution. ON UN*X use: zcat translit.tar.Z | tar xvof - to get all individual files. This file is BINARY, and you should not attempt to obtain it via email. This is a best way to get the whole ditribution via ftp if you are on the UN*X machine. translit.tar.z.uu --- uuencoded file from the above. It can be transmitted via e-mail, but it is a large file, and if your mailer sets limits on your messages, it may not be correctly transmitted. To recover individual files from the email message, do: uudecode message_file where the mesage_file is a saved email message. You will obtain translit.tar.Z file which you can unpack as described above. translit.zip --- This is a "zipped" file (i.e., compressed with a ZIP program. It is binary (i.e., you cannot get it via e-mail, but you can get it via ftp with binary switch set) To get individual file do: unzip translit.zip (in UNIX) or PKUNZIP translit.zip (under MS-DOS) and you will obtain a full distribution. translit.zip.uu --- Uuencoded file from above. Can be sent via e-mail but it is big. To recover all files do: uudecode message_file where message_file is your saved message and then "unzip" it as shown above. HOW TO OBTAIN THE FILES: ======================= Via FTP (if you are on Internet): --------------------------------- ftp infomeister.osc.edu Login: anonymous Password: Your_email_address (Please...) ftp> ascii (or binary if you retrieve binary files) ftp> cd pub/russian/translit ftp> get file_name ..... (for each file) ftp> quit Via E-mail: ----------- Send message: select russian limit 1MB size 50k get translit/file_name .... (file_name is a name of the file given above) qui to MAILSERV@osc.edu You can retrieve more files with a single message by placing several lines of get ... The file(s) will be forwarded to your mailbox automatically. The "file_name" in the instructions above means any file from the list given above. If you do not know or have programs like uudecode, unzip, tar, zcat or uncompress, get all individual files one by one. If you know how to use the above programs it may be faster for you to get a tar or zip archive and unpack it. Program installation and compilation is described in the translit docs. Since the program requires that you make small changes to paths.h before compilation (depending on your system and environment), I cannot realy distribute generic executables (i.e., compiled programs). You have to modify paths.h to suit your needs and operating system and compile the program using your favorite C compiler. GETTING THE READY TO RUN PROGRAM ================================ If you do not have time, do not have resources, or for whatever reason you wish a ready to run executable of TRANSLIT, you can order it for a very modest fee from JKL ENTERPRISES, INC. as described in the file: order.txt. It will come with an easy installation script which will ask you a few simple questions and install the program. I invite, and will try to answer, bug reports, comments and suggestions. If there is an interest I will work on optimizing the program, on supporting the UNICODE, and other enhancements which you suggest. If you use the program for commercial purposes, and on many computers in your organization, you might want to buy the program from JKL ENTERPRISES, INC., to aid further development, though you are not required to do so. Enjoy, Author coordinates: Jan Labanowski P.O. Box 21821 Columbus, OH 43221-0821, USA jkl@osc.edu, JKL@OHSTPY.BITNET ------------------------------