* 위키 패키지 목록: [패키지목록]
== 개요 ==
 * xetex-ko는 XeTeX 엔진을 위한 한국어 식자 및 조판 패키지로 [ko.TeX]의 일부이다.
 * xetex-ko의 개발자는 김도현이며, 2014년 현재 최신판은 2.9이다.

== 배포와 설치 ==
 * xetex-ko는 [http://ftp.ktug.org/tex-archive/macros/xetex/generic/xetexko/ CTAN]을 통해 배포된다.
 * TeX Liv에 xetex-ko가 포함되어, 다음와 명령으로 설치할 수 있다.{{{#!bash
# sudo tlmgr install xetexko
}}}

== 사용법 ==
=== 패키지 호출 ===
 * 프리앰블에서 다음과 같이 호출한다.{{{#!tex
\usepackage{xetexko}
}}}
=== 패키지 선택 사항 ===
 * {{{hangul}}}: ‘제1장’, ‘표’, ‘차례’ 등 한글 표제를이용한다. 절 제목 이하에는 한글 표제가 붙지 않고 숫자로만 표현된다. 한글이 주된 언어라고 인식하여 줄간격 조정도 수행한다.
 * {{{hanja}}}: ‘第1章’, ‘表’, ‘目次’ 등 한자 표제를 이용한다. 절 제목 이하에는 한자 표제가 붙지 않고 숫자로만 표현된다. 한글이 주된 언어라고 인식하여 줄간격 조정도 수행한다.
 * {{{unfonts}}}: 은글꼴을 불러온다. (예전 버전에서는 이 옵션을 주지 않아도 은글꼴이 기본 한글 폰트였으나, 현재 버전에서는 나눔 트루타입 폰트가 기본 한글 폰트이다.)
=== 글꼴 명령 ===
 * 글꼴 지정은 다음과 같이 한다.{{{#!tex
\setmainfont{Linux Libertine}[Ligatures=TeX]
\setmainhangulfont{나눔명조}[Ligatures=TeX]
\setmainhanjafont{은 바탕}[Ligatures=TeX]
}}}
 * 글꼴 속성 등의 설정은 fontspec을 따른다.
 * 위와 마찬가지로 다음 명령들도 제공한다.{{{#!tex
\setsansfont \setsanshangulfont \setsanshanjafont
\setmonofont \setmonohangulfont \setmonohanjafont
}}}

=== 기호 글꼴 명령 ===
라틴 문자나 CJK 기호를 어떤 폰트로 식자할 것인가를 사용자가 지정할 수 있다.{{{#!tex
\xetexkofontregime{인자}[key=value]
}}}
 * 인자: latin, hangul, hanja, prevfont
 * 옵션 키
   1. alphs: 라틴 알파벳 및 아래에 해당하지 않는 모든 라틴 문자
   1. nums: 라틴 숫자 (수식 제외)
   1. parens: 라틴 괄호, 중괄호, 대괄호, 꺾쇠
   1. quotes: accent grave, apostrophy 및 이들의 리거처
   1. colons: 라틴 콜론, 세미콜론, en dash, em dash
   1. hyphens: 하이픈, 하이픈으로 이루어지는 리거처, 슬래시
   1. puncts: 마침표, 물음표, 느낌표, 쉼표
   1. cjksymbols: CJK 구두점, 괄호 및 상징기호
예){{{#!tex
\xetexkofontregime{latin}[puncts=prevfont, colons=prevfont, cjksymbols=hangul]
}}}

== 그밖 ==
 * 간격 조정, 옛한글 사용 등에 관해서는 [http://ftp.ktug.org/tex-archive/macros/xetex/generic/xetexko/xetexko-doc.pdf 설명서]를 참고하라.
 * [https://github.com/dohyunkim/xetexko github 저장소]에서 개발상황을 살펴보거나 버그 및 개선점을 제출할 수 있다.