| 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} |