summaryrefslogtreecommitdiff
path: root/language/korean/kotex-utf/README
blob: 8857f77c8b09d5d74a30328a46047e6fef21d927 (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
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
kotex-utf
=========

Introduction
------------

kotex-utf is a macro package for typesetting Hangul, the native 
alphabet of the Korean language. The input Korean text should be 
encoded in UTF-8.  kotex-utf belongs to ko.TeX, a comprehensive 
Korean typesetting system together with packages kotex-oblivoir, 
kotex-plain, kotex-utils, cjk-ko, xetexko, and luaxexko.

Dependencies
------------

kotex-utf depends on the following packages:

* xetexko: Hangul and hanja mapping tables
* cjk-ko: main style, Korean counters and captions

Files
-----

### TeXinputs

    dhucs-nanumfont.sty -> tex/latex/kotex/
    dhucs.sty -> tex/latex/kotex/
    hfontspec.default -> tex/latex/kotex/
    kosections-utf.sty -> tex/latex/kotex/
    kotex.cfg -> tex/latex/kotex/
    kotexutf.sty -> tex/latex/kotex/
    lucenc.dfu -> tex/latex/kotex/
    lucuhcmj.fd -> tex/latex/kotex/
    contrib/dhucs-cmap.sty -> tex/latex/kotex/contrib/
    contrib/dhucs-enumerate.sty -> tex/latex/kotex/contrib/
    contrib/dhucs-enumitem.sty -> tex/latex/kotex/contrib/
    contrib/dhucs-gremph.sty -> tex/latex/kotex/contrib/
    contrib/dhucs-interword.sty -> tex/latex/kotex/contrib/
    contrib/dhucs-paralist.sty -> tex/latex/kotex/contrib/
    contrib/dhucs-sectsty.sty -> tex/latex/kotex/contrib/
    contrib/dhucs-setspace.sty -> tex/latex/kotex/contrib/
    contrib/dhucs-trivcj.sty -> tex/latex/kotex/contrib/
    contrib/dhucs-ucshyper.sty -> tex/latex/kotex/contrib/
    contrib/dhucsfn.sty -> tex/latex/kotex/contrib/
    contrib/kotex-logo.sty -> tex/latex/kotex/contrib/
    contrib/kotex-varioref.sty -> tex/latex/kotex/contrib/

### TeX4ht

    tex4ht/dhucs.4ht -> tex/latex/kotex/tex4ht/
    tex4ht/dhucs.cfg -> tex/latex/kotex/tex4ht/
    tex4ht/kosections-utf.4ht -> tex/latex/kotex/tex4ht/

### Documents

    README (this file) -> doc/latex/kotex-utf/
    doc/kotexdoc.pdf -> doc/latex/kotex-utf/
    doc/kotexdoc.tex -> doc/latex/kotex-utf/
    doc/sample-finemath-setup.tex -> doc/latex/kotex-utf/
    doc/yettext.tex -> doc/latex/kotex-utf/
    doc/yettext.txt -> doc/latex/kotex-utf/
    doc/fig/allowbreak-dhucs.pdf -> doc/latex/kotex-utf/fig/
    doc/fig/fntexp.pdf -> doc/latex/kotex-utf/fig/
    doc/fig/fntnormal.pdf -> doc/latex/kotex-utf/fig/
    doc/fig/histkotex.jpg -> doc/latex/kotex-utf/fig/
    doc/fig/linebreaktest.pdf -> doc/latex/kotex-utf/fig/
    doc/fig/testdhucsallowbreak.pdf -> doc/latex/kotex-utf/fig/

Usage
-----

Call `kotex.sty` (in cjk-ko package) with package options as follows:

    \usepackage[<options>]{kotex}

When kotex-utf is installed and appropriate options are given,
kotex-utf will be used for Hangul typesetting.
Certain package options are inter-related to the TeX engines
that are used for compilation.
For pdfLaTeX and LaTeX, you can use *utf* option:

    \usepackage[utf]{kotex}

This will activate the default behavior of kotex-utf. The option 
*utf* does not need to be specified since it is a default option. 
You can use other common options such as *hangul*, *hanja*, 
and *nojosa*.

Calling kotex.sty in the following way

    \usepackage[cjk]{kotex}

will typeset Hangul using the cjk-ko package. Options *usedotemph* 
and *usecjkt1font* can be specified in addition to the common options. 

For XeLaTeX and LuaLaTeX, you can just load kotex.sty without 
any package options. kotex-utf will call XeTeX-ko or LuaTeX-ko accordingly.

Sample document
---------------

The following document is a sample document utilizing the iftex 
package for coping with multiple engines:

    \documentclass{article}
    \usepackage{amsmath,amssymb}
    \usepackage{hyperref}
    \usepackage[hangul]{kotex}
    \usepackage{kotex-logo}
    \usepackage{iftex}
    \ifPDFTeX
      \usepackage{dhucs-nanumfont}
      \hypersetup{pdftex,unicode,bookmarks}
      \input glyphtounicode
      \pdfgentounicode=1
    \else\ifXeTeX
      \setmainhangulfont[Ligatures=TeX]{HCR Batang LVT}
      \setsanshangulfont[Ligatures=TeX]{HCR Dotum LVT}
    \else\ifLuaTeX
      \hypersetup{unicode,bookmarks}
      \setmainhangulfont[Ligatures=TeX]{HCR Batang LVT}
      \setsanshangulfont[Ligatures=TeX]{HCR Dotum LVT}
    \fi\fi\fi
    \begin{document}
    \title{\koTeX-article 템플릿}
    \author{저자}
    \date{}
    \maketitle
    \section{절 제목}
    \subsection{소절 제목}
    이 문서는 \koTeX\ 문서입니다.
    \end{document}

For more information, please refer to the included documentation (written in Korean).

License
-------

kotex-utf is licensed under the LaTeX Project Public
License (LPPL) version 1.3c or later.

Contacts
--------

Please report any errors or suggestions to the package maintainer,
Kihwang Lee <leekh at ktug org>.