summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/generic/babel-belarusian/README
blob: 5db220e263075a0c604f9de54251786cd313b742 (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
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
----------------------------------------------------------------

Belarusian language module for Babel, v1.3h

Released under the LaTeX Project Public License v1.3c or later.
See http://www.latex-project.org/lppl.txt

The package provides support for use of Babel in documents written in Belarusian
(in both official and "classic" forms). The support is adapted for use both
under legacy TEX engines, and under X∃TEX and LuaTEX.

Based on Russian language module v1.3h by Igor A. Kotelnikov <kia999 at mail dot ru>
and Belarusian language module v1.1l by Aleksey Novodvorsky <aen@logic.ru>.

The Current Maintainer is Andrew Shadura <andrew@shadura.me>.

1. INSTALLATION

- unpack babel-belarusian.zip
- run "xelatex.exe belarusianb.dtx" (recommended)
  or "pdflatex.exe belarusianb.dtx";
  run "tex.exe belarusianb.dtx"
  or "tex.exe belarusianb.ins", if you don't need documentation
- move "belarusianb.ldf" to <textmf>/tex/generic/babel/contrib/
- move "belarusianb.pdf" and README to <textmf>/doc/latex/belarusian-babel/
- update filename base (see documentation for your TeX system)

2. USAGE

Belarusian language definition file can be used both with legacy 8-bit engines
(such as latex.exe or pdflatex.exe) and Unicode compilers (xelatex.exe or
lualatex.exe). The Unicode engines can be ran either in Unicode mode or 8-bit
compatibility mode, which emulates the legacy engines. The two modes differ by
a set of packages loaded in the preamble of a source TeX file. It is important
to keep recommended order of the packages loaded, especially when running
Unicode engines in a compatibility 8-bit mode.

In the examples below, it is assumed that a source file has utf8 input encoding.

2.1. 8-bit mode

2.1.1 PDFLATeX, LaTeX

    \usepackage[T1,T2A]{fontenc}
    \usepackage[utf8]{inputenc}
    \usepackage[english,belarusian]{babel}

2.1.2 LuaLaTeX

    \usepackage[T1,T2A]{fontenc}
    \usepackage[lutf8]{luainputenc}
    \usepackage[english,belarusian]{babel}

2.1.3 XeLaTeX

    \XeTeXinputencoding "bytes"
    \usepackage[utf8]{inputenc}
    \usepackage[T2A]{fontenc}
    \usepackage[english,belarusian]{babel}

2.2 Unicode mode, LuaLaTeX or XeLaTeX

    \usepackage{fontspec}
        \defaultfontfeatures{Ligatures={TeX}}
        \setmainfont{CMU Serif}
        \setsansfont{CMU Sans Serif}
        \setmonofont{CMU Typewriter Text}
    \usepackage[english,belarusian]{babel}

Instead of the Computer Modern Unicode (CMU) fonts loaded in this example,
you may use any True Type or Open Type fonts installed on your computer.

2.3 Using "classic" (Taraškievič) spelling

    \usepackage[english,belarusian]{babel}
    \languageattribute{belarusian}{classic}
or
    \usepackage[english,belarusian.classic]{babel}
or
    \usepackage[english,belarusian]{babel}
    \languageattribute{belarusian}{tarask}
or
    \usepackage[english,belarusian.tarask]{babel}

3. DOCUMENTATION

See belarusianb.pdf for more information.

4. KNOWN PROBLEMS

Before switching from a legacy 8-bit engine (tex, pdftex) to an Unicode
engine (xetex, luatex) and vise versa delete all .aux, .toc, .lot, .lof
files as they might have stored incompatible internal encodings.

5. CHANGES

2016-04-07 version 1.3h

    * Initial version

Original source:  russianb.dtx,
    2016-02-18 v1.3h Russian support from the babel system.

----------------------------------------------------------------