[[TableOfContents]]

== 요약 ==
Korean Style Package는 KTUGCollectionProject의 일부로서, LaTeX(Lambda가 아님) 한글 문서 작성을 위한 통합 스타일이다.
KTUG Collection CD를 설치하면 HLaTeX, DHHangul, DHUcs 등 여러 가지 한글 작업 환경을 설치해주는데, 그 가운데 HLaTeX과 DHUcs를 선택적으로 사용하여 문서를 작성할 수 있게 한다. HLaTeX은 euc-kr 인코딩의 문서를 작성할 때 사용하고 dhucs는 UTF-8 문서를 작성할 때 사용하도록 하는 것이다. 문서의 한글 인코딩에 따라서 `[utf]` 또는 `[euc]` 옵션을 지정할 수 있다.
이 스타일을 이용하여, 기존에 HLaTeX으로 작성되어 있던 문서를 DHUcs 문서로 간단히 변환하도록 하려는 목적도 있다.

== 다운로드와 설치 ==
KTUG Collection CD를 설치하면 이 패키지가 함께 설치된다.

개별적으로 설치하려 할 때는 다음 파일을 이용한다. 이 경우, HLaTeX, HANGULkStyle, DHUcs가 시스템에 설치되어 있어야 한다.(은글꼴 포함.)
Download : [http://my.ktug.or.kr/~karnes/testtest/koreanpackage-0.12.zip koreanpackage-0.12.zip]

압축 파일을 풀면 `korean.dtx`와 `korean.ins` 두 개의 파일이 있다. 다음 순서로 실행하면 스타일 파일과 패키지 문서를 얻는다.
{{{
#> latex korean.ins
#> latex korean.dtx
#> makeindex -s gind.ist korean
#> latex korean.dtx
}}}

`korean.sty`를 `[localtexmf]/tex/latex/korean` 폴더 아래에 가져다두고 Refresh Filename Database를 실행한다.

== 사용방법 ==

{{{
\usepackage[utf]{korean}
\KoreanSetup{
  <옵션들>
}
\SetKoreanDocument
}}}

(1) 패키지 옵션 또는 `\KoreanSetup` 명령의 옵션으로 문서 작성 환경을 설정한다.
(2) `hangul-k` 또는 `dhucs` 등을 불러서 문서를 조판한다.
(3) *-interword나 setspace 등을 자동으로 로드한다.

더 자세한 옵션의 지정 방법은 패키지 문서를 참고할 것.

== EUC 문서를 UTF 문서로 변환 ==

예를 들어서 다음과 같은 preamble을 가진 hlatex-k 문서가 있다고 하자.
{{{
\usepackage{hangul-k}
\usepackage{xxttf}
\usepackage[dvipdfm,CJKBookmarks]{hyperref}
\AtBeginDvi{\special{pdf: tounicode KSCms-UHC-UCS2}}
}}}

이 부분을 다음과 같이 고친다.
{{{
\usepackage[utf]{korean}
\SetKoreanDocument
\usepackage[dvipdfm,CJKBookmarks]{hyperref}
\AtBeginDvi{\special{pdf: tounicode UTF8-UCS2}}
}}}

(tounicode `CMap` 지정을 바꾸는 것은 어쩔 수 없이 수작업으로 해야 한다.)
그런 다음 이 파일 전체의 인코딩을 utf-8로 바꾼다. 파일 이름이 foo.tex이라면,

{{{
#> iconv -f EUC-KR -t UTF-8 foo.tex > fooutf.tex
}}}

LaTeX을 실행한다.

{{{
#> latex fooutf
}}}

약간의 제한(예를 들면 현재는 쓰지 않는 예전 글꼴 지정 명령(`\gt` 등)이 없다면 대부분의 경우 문서가 안전하게 컴파일될 것이다.

== 관련 페이지 ==
 * [HLaTeX]
 * [HANGULkStyle]
 * [Hangul-ucs]
 * [LaTeX-ucs]