Debian Codegraph @

texmf-dist/doc/lualatex/uninormalize/README.md

raw
1 # The `uninormalize` package
2
3 The purpose of this package is to provide Unicode normalization for LuaLaTeX. It is based on Arthur Reutenauer's
4 [code for GSOC 2008](https://code.google.com/p/google-summer-of-code-2008-tex/downloads/list), which was adapted a little bit to work with
5 current `Luaotfload`. For more information, see [this question on TeX.sx](http://tex.stackexchange.com/q/229044/7712).
6
7 ## What does that mean?
8
9 Citing [Wikipedia](https://en.wikipedia.org/wiki/Unicode_equivalence):
10
11 > Unicode equivalence is the specification by the Unicode character encoding
12 > standard that some sequences of code points represent essentially the same
13 > character. This feature was introduced in the standard to allow compatibility
14 > with preexisting standard character sets, which often included similar or
15 > identical characters.
16 >
17 > Unicode provides two such notions, canonical equivalence and compatibility.
18 > Code point sequences that are defined as canonically equivalent are assumed to
19 > have the same appearance and meaning when printed or displayed. For example,
20 > the code point `U+006E` (the Latin lowercase "n") followed by `U+0303` (the
21 > combining tilde) is defined by Unicode to be canonically equivalent to the
22 > single code point `U+00F1` (the lowercase letter "ñ" of the Spanish alphabet).
23
24 ## Basic usage
25
26
27 \documentclass{article}
28 \usepackage{fontspec}
29 \usepackage[czech]{babel}
30 \setmainfont{Linux Libertine O}
31 \usepackage{uninormalize}
32 \begin{document}
33
34 Some tests:
35 \begin{itemize}
36 \item combined letter ᾳ %GREEK SMALL LETTER ALPHA (U+03B1)
37 % + COMBINING GREEK YPOGEGRAMMENI
38 % (U+0345)
39 \item normal letter ᾳ % GREEK SMALL LETTER ALPHA WITH
40 %YPOGEGRAMMENI (U+1FB3)
41 \end{itemize}
42
43 Some more combined and normal letters:
44 óóōōöö
45
46 Linux Libertine does support some combined chars: \parbox{4em}{příliš}
47
48 Using the \verb|^^^^| syntax: ^^^^0061^^^^0301 ^^^^0041^^^^0301
49 \end{document}
50
51 ## Package options
52
53 This package has three options:
54
55
56 - **buffer** -- normalize processed document at the moment when it's
57 source file is read, before processing by \TeX\ starts. This is the default
58 option, it seems to work better than the next one.
59 - **nodes** -- normalize LuaTeX nodes. Normalization happens after the full processiny by \TeX.
60 - **debug** -- print debug messages to the terminal output
61
62 Both **buffer** and **nodes** options are enabled by default, you can disable any of them by using:
63
64 \usepackage[nodes=false,buffer=false]{uninormalize}