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.
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
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
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:
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)
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:
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):
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)
get translit/file_name .... (file_name is a name of the file given above)
to MAILSERV@ccl.net 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.
P.O. Box 21821
Columbus, OH 43221-0821, USA