Debian Codegraph @

texmf-dist/doc/luatex/luavlna/README.md

raw
1 # Luavlna, version 0.1n, 2025-10-29
2
3 # Introduction
4
5 `Luavlna` is a small package for plain LuaTeX and LuaLaTeX. In some languages,
6 like Czech or Polish, there should be no single letter words at the
7 line end, according to the typographical norms. There exists some
8 external commands (like `vlna`) or packages (`encxvlna` for encTeX,
9 `xevlna` for XeTeX, `impnattypo` for LuaLaTeX).
10
11 Other feature of this package is including of non-breakable space after initials,
12 like in personal names, after or before academic degrees
13 and between numbers and units (SI and others).
14
15 The code is modified version of Patrick Gundlach’s answer on
16 TeX.sx[^1]. The difference is that it is possible to specify which
17 single letters should be taken into account for different
18 languages.
19 The support for degrees and units was added as well.
20
21 # Usage
22
23 The usage is simple:
24
25 \input ucode
26 \uselanguage{czech}
27 %% in the case of luacsplain, use instead:
28 %% \chyph
29 %% but language code for Czech is different than in LaTeX or normal
30 %% LuaTeX, so you will need to set single letters with somethinh like:
31 %% \singlechars{5}{AIiVvOoUuSsZzKk}
32 \input luavlna
33 \preventsingledebugon
34 \input luaotfload.sty
35 \font\hello={name:Linux Libertine O:+rlig;+clig;+liga;+tlig} at 12pt
36 \hsize=3in
37 \hello
38 Příliš žluťoučký kůň úpěl ďábelské ódy.
39 Text s krátkými souhláskami a samohláskami i dalšími jevy
40 z nabídky možností (v textu možnými).
41
42 I začátek odstavce je třeba řešit, i když výskyt zalomení není pravděpodobný.
43
44 Co třeba í znaky š diakritikou?
45
46 Různé možnosti [v závorkách <i jiných znacích
47
48 Podpora iniciál a titulů: M. J. Hegel, Ing. Běháková, Ph.D., Ž. Zíbrt.
49
50 Podpora jednotek: 100,5 MN\cdot{}s, 100.5 kJ, 200 µA, $-1$ dag, 12 MiB, 1 m$^3$/s.
51
52 \preventsingledebugoff
53 \bye
54
55
56 It is also possible to use the package with lua, just use
57
58 \usepackage{luavlna}
59
60 in the preamble.
61
62 # Commands
63
64 \singlechars{language name}{letters}
65
66 Enable this feature for certain letters in given language.
67
68 Default values:
69
70 %% only Czech and Slovak are supported out of the box
71 \singlechars{czech}{AIiVvOoUuSsZzKk}
72 \singlechars{slovak}{AIiVvOoUuSsZzKk}
73
74 \compoundinitials{language name}{compounds}
75
76 Declare compound letters for given language. Second argument should be comma
77 separated list of compound letters, in exact form in which they can appear.
78
79 Default values:
80
81 \compoundinitials{czech}{Ch}
82
83 ##Turning off language switching
84
85 By default, language of the nodes is taken into account. If you want to use
86 settings for one language for a whole document, you can use following command:
87
88 \preventsinglelang{language name}
89
90 ##Turning off processing
91
92 If you want to stop processing of the spaces in the document you can use
93 command
94
95 \preventsingleoff
96
97 To resume processing, use
98
99 \preventsingleon
100
101 ## Debugging commands
102
103 \preventsingledebugon
104 \preventsingledebugoff
105
106 Insert debugging marks on/off. Default off.
107
108 # Authors
109
110 Michal Hoftich
111 Miro Hrončok
112
113 # License
114
115 Permission is granted to copy, distribute and/or modify this software
116 under the terms of the LaTeX Project Public License, version 1.3.
117
118 [^1]:
119 <http://tex.stackexchange.com/a/28128/2891>