| 1 |
XeTeX-ko Package version 4.6 (2025/08/24) |
| 2 |
========================================= |
| 3 |
|
| 4 |
XeTeX-ko is a macro package for Xe(La)TeX which supports typesetting |
| 5 |
Korean documents including Old Hangul texts. Though XeTeX itself |
| 6 |
already has basic facility to typeset Korean texts, this package |
| 7 |
provides some enhanced features for quality products adapted to |
| 8 |
Korean culture. |
| 9 |
|
| 10 |
This package requires cjk-ko package for its full functionality. |
| 11 |
|
| 12 |
|
| 13 |
License |
| 14 |
------- |
| 15 |
This package is licensed under LPPL (LaTeX Project Public License). |
| 16 |
|
| 17 |
See each file for details. |
| 18 |
|
| 19 |
|
| 20 |
Author |
| 21 |
------ |
| 22 |
Please report any errors or suggestions to |
| 23 |
Dohyun Kim <nomosnomos at gmail com> |
| 24 |
or leave messages in the issue tracker at: |
| 25 |
<http://github.com/dohyunkim/xetexko> |
| 26 |
|
| 27 |
|
| 28 |
Files |
| 29 |
----- |
| 30 |
|
| 31 |
### TeXinputs |
| 32 |
|
| 33 |
xetexko.sty -> tex/xetex/xetexko/ |
| 34 |
xetexko-font.sty -> tex/xetex/xetexko/ |
| 35 |
xetexko-hanging.sty -> tex/xetex/xetexko/ |
| 36 |
xetexko-josa.sty -> tex/xetex/xetexko/ |
| 37 |
xetexko-space.sty -> tex/xetex/xetexko/ |
| 38 |
xetexko-vertical.sty -> tex/xetex/xetexko/ |
| 39 |
hanja_hangul.tab -> tex/xetex/xetexko/ |
| 40 |
hanjacom_hangul.tab -> tex/xetex/xetexko/ |
| 41 |
hanjaexa_hangul.tab -> tex/xetex/xetexko/ |
| 42 |
|
| 43 |
### Documents |
| 44 |
|
| 45 |
xetexko-doc.pdf -> doc/xetex/xetexko/ |
| 46 |
xetexko-doc.tex -> doc/xetex/xetexko/ |
| 47 |
README (this file) -> doc/xetex/xetexko/ |
| 48 |
ChangeLog -> doc/xetex/xetexko/ |
| 49 |
|
| 50 |
|
| 51 |
Loading |
| 52 |
------- |
| 53 |
If you are a LaTeX user, declaring |
| 54 |
|
| 55 |
\usepackage{xetexko} |
| 56 |
or |
| 57 |
|
| 58 |
\usepackage{kotex} |
| 59 |
is sufficient to load the package. Notice that kotex.sty is a file |
| 60 |
provided by cjk-ko package. |
| 61 |
|
| 62 |
Under plain TeX: |
| 63 |
|
| 64 |
\input xetexko.sty |
| 65 |
|
| 66 |
|
| 67 |
Package Options |
| 68 |
--------------- |
| 69 |
|
| 70 |
[hangul] |
| 71 |
Load Hangul captions. Besides, this option also adjusts interline |
| 72 |
spacing. |
| 73 |
|
| 74 |
[hanja] |
| 75 |
Load Hanja captions. Also adjusts spacing as [hangul] option does. |
| 76 |
|
| 77 |
Note that [unfonts] option is removed starting with v2.10, and so |
| 78 |
Un TrueType will be used when no Hangul/Hanja font is declared. |
| 79 |
|
| 80 |
|
| 81 |
Hangul Font Commands |
| 82 |
-------------------- |
| 83 |
|
| 84 |
\setmainhangulfont |
| 85 |
\setsanshangulfont |
| 86 |
\setmonohangulfont |
| 87 |
Same as \setmainfont etc. provided by fontspec package, except that |
| 88 |
these affect only Hangul characters and related symbols. |
| 89 |
|
| 90 |
\setmainhanjafont |
| 91 |
\setsanshanjafont |
| 92 |
\setmonohanjafont |
| 93 |
Same as \setmainfont etc. except that these affect only Hanja |
| 94 |
characters. |
| 95 |
|
| 96 |
In like manner, these commands are available as well: |
| 97 |
|
| 98 |
\hangulfontspec \hanjafontspec |
| 99 |
\newhangulfontfamily \newhanjafontfamily |
| 100 |
\addhangulfontfeature \addhanjafontfeature |
| 101 |
|
| 102 |
If \fallbackhanjafont is defined, it is used as a final fallback font. |
| 103 |
|
| 104 |
|
| 105 |
Hangul Font Options |
| 106 |
------------------- |
| 107 |
|
| 108 |
[InterLatinCJK=<dimen>] |
| 109 |
Set spacing between Hangul/Hanja and Latin characters. |
| 110 |
|
| 111 |
[InterHangul=<dimen>] |
| 112 |
Set spacing between Hangul characters. |
| 113 |
|
| 114 |
[CharRaise=<dimen>] |
| 115 |
Raise the baseline of Hangul/Hanja characters. |
| 116 |
|
| 117 |
|
| 118 |
Other User Commands |
| 119 |
------------------- |
| 120 |
|
| 121 |
\dotemph{...} |
| 122 |
Emphasise Hangul or Hanja by putting dot above. |
| 123 |
|
| 124 |
\begin{vertical}{<dimen>} |
| 125 |
\end{vertical} |
| 126 |
This environment makes a vbox vertically typeset. <dimen> is an |
| 127 |
argument to indicate the box height. When <dimen> is \empty, an hbox |
| 128 |
with natural height will be made. For vertical typesetting of |
| 129 |
entire document, use the command \verticaltypesetting instead. |
| 130 |
|
| 131 |
\은 \는 \이 \가 \을 \를 \와 \과 \로 \으로 \라 \이라 |
| 132 |
Commands for automatic Josa selection. Unlike those of cjk-ko |
| 133 |
package, these commands work correctly even after Hangul or Hanja. |
| 134 |
|
| 135 |
|
| 136 |
*END of README* |