summaryrefslogtreecommitdiff
path: root/indexing/upmendex/README.md
blob: f0f8df4ca5102082587f259dff08e95aafff10b7 (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
upmendex  --- Multilingual index processor
==========================================

2020.02.22 Ver0.54

TANAKA, Takuji
<ttk(at)t-lab.opal.ne.jp>


### About upmendex
upmendex is a multilingual index processor with following features:

 * Mostly compatible with makeindex and
   upper compatible with mendex,
   based on mendex version 2.6f by ASCII media works.
 * Unicode for internal process and
   support UTF-8 encoding for input/output.
   Will work with upLaTeX, XeLaTeX and luaLaTeX.
 * Support Latin (including non-English), Greek, Cyrillic,
   Korean Hangul and Han (Hanzi ideographs) scripts
   as well as Japanese Kana.
 * Apply International Components for Unicode (ICU)[4]
   for sorting process.

### Contents
 * README.md :: This file
 * source/ :: sources
 * doc/ :: documents
 * doc/samples/ :: samples for test.
   More samples are distributed at GitHub[2] than at CTAN[5].
 * man/ :: manuals

### Building upmendex
The source files are distributed at GitHub[2] and work with TeX Live svn r53427.
Ref. [TeX Live and Subversion](http://www.tug.org/texlive/svn/)

Tested with ICU 65.1 .

### Status
Beta version.
No warranty.

### Copyright
Lisence notice is written in [COPYRIGHT](./COPYRIGHT).
It is as same as [the BSD 3-Clause License](https://opensource.org/licenses/BSD-3-Clause)

### Supported locale
In ICU collator, default "root" locale covers several lauguages:
English, French, Germany, Italian and so on.
Follows are available for setting into "icu_locale".

#### Latin script
  "az" (Azerbaijani), "ca" (Catalan), "cs", "cs@collation=search" (Czech),
  "da" (Danish), "de@collation=phonebook" (German), "eo" (Espelanto),
  "es", "es@collation=traditional", "es@collation=search" (Spanish),
  "fi" (Finnish), "gl" (Galician),
  "hr", "hr@collation=search" (Croatian), "hu" (Hungarian),
  "lt" (Lithuanian), "nb", "nn", "no" (Norwegian),
  "pl" (Polish), "ro" (Romanian), "sk", "sk@collation=search" (Slovak),
  "sl" (Slovenian), "sq" (Albanian),
  "sr-Latn", "sr-Latn@collation=search" (Serbian), "sv" (Swedish),
  "tr" (Turkish), "vi" (Vietnamese)

#### Cyrillic script
  "be" (Belarusian), "bg" (Bulgarian), "ru" (Russian),
  "sr" (Serbian), "uk" (Ukraine)

#### Greek script
  "el" (Greek)

#### CJK (Han script (Hanzi), Hangul, Kana)
  "ja", "ja@collation=unihan" (Japanese),
  "ko", "ko@collation=search", "ko@collation=unihan" (Korean),
  "zh", "zh@collation=unihan", "zh@collation=stroke", "zh@collation=zhuyin" (Chinese)

### References
1.  [ASCII Nihongo TeX (Publishing TeX)](https://asciidwango.github.io/ptex/)
    ASCII MEDIA WORKS (web site by DWANGO Co., Ltd.)
2.  [Source/Document distribution of upmendex --- multilingual index processor @ GitHub](https://github.com/t-tk/upmendex-package)
3.  [upTeX, upLaTeX ― unicode version of pTeX, pLaTeX](http://www.t-lab.opal.ne.jp/tex/uptex_en.html)
4.  [International Components for Unicode (ICU)](http://site.icu-project.org/)
5.  [upmendex @ CTAN](https://ctan.org/pkg/upmendex/)