summaryrefslogtreecommitdiff
path: root/macros/latex/contrib/koi8/readme
blob: 94416548723e432bf70096d98a43cca02bdb992e (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
                    PACKAGES KOI8 AND RAWPRINT

                        September 24, 1996

These packages are intended for typesetting Russian texts. 

1. Package koi8 (written by Uri Blumenthal <uri@watson.ibm.com> with
minor modifications by Boris Veytsman <boris@plmsc.psu.edu>).

It performs internal translation from the KOI-8 encoding (de-facto
standard of the UNIX world) to the so called ``alternative encoding''
used by most Cyrillic packages. You still need one of these packages
for the acual Russian typesetting. The style works with all major
Cyrillic packages: cmcyr, cmcyralt, LH. The usage is very simple:

In LaTeX2e
\documentclass{article}
\usepackage{lh,koi8}
\begin{document}
  SOME TEXT IN KOI-8
\end{document}

In LaTeX2.09
\documentstyle{lh,koi8,article}
\begin{document}
  SOME TEXT IN KOI-8
\end{document}


Substitute cmcyr or cmcyralt for lh if you use these packages.


2. Package rawprint 

This package is intended for ``quick and dirty'' printing of raw
(i.e. non-TeX) Russian texts by persons who (like me) do not have
Russian printer fonts (but have Cyrillic TeX). It makes #, $, % and &
``normal'' letters and converts the ``unisex'' quote character " into
Russian-style << and >> quotes. The usage (in LaTeX2e) is:

\documentclass{article}
\usepackage{lh,rawprint}
\begin{document}
\input{document_in_alt_encoding.txt}
\end{document}

\documentclass{article}
\usepackage{lh,koi8,rawprint}
\begin{document}
\input{document_in_koi8_encoding.txt}
\end{document}

and the LaTeX2.09 usage should be quite obvious.

Please note that making % a letter is a rather drastic solution. Since
most LaTeX style files have some comments delimited by the percent
signs, the package rawprint must be invoked as the LAST one. The line
\usepackage{rawprint,lh} will cause you lots of grief.

Happy LaTeXing in Russian!

                Boris Veytsman <boris@plmsc.psu.edu>