[[TableOfContents]] == Hangul-k == hangul-nojosa를 이어받은 한글 문서작성 스타일입니다. KTUGContrib:1554 및 거기에 딸린 글 참고. Uploads:hangul-k-20040512.sty (ver 0.2d) Uploads:josa.tab (for ver 0.2c or later) == 자동조사 == HLaTeX의 hangul.sty에는 아주 훌륭한 자동조사 기능이 있습니다. 그러나 이 자동조사 기능은 평상시에는 매우 편리하지만 PDF Hyperlink를 만들 때는 불편하였습니다. 그 때문에 PDF를 만들기 위해서는 그 동안 hangul에서 자동조사 기능을 제거한 hangul-nojosa가 쓰여왔습니다. hangul-k는 이 hangul-nojosa를 기반으로 DohyunKim 님이 개발한 하이퍼링크-자동조사 루틴을 채택하여 PDF를 만들 때 자동조사가 작동하도록 한 것입니다. DohyunKim 님의 하이퍼링크-자동조사의 아이디어는 hyperref이 링크를 만들기를 기다려서 거기서 반환되는 문자열 또는 숫자를 직접 분해/분석하여 마지막 글자값을 정하고 여기에 맞는 자동조사를 붙여주는 방식입니다. == 사용법과 주의사항 == === 주요 기능 === 일반적으로, hangul.sty에서 제공하는 자동조사 명령을 쓸 수 있습니다. * 문서 작성 자체는 hangul을 사용할 때와 똑같이 하면 됩니다. 다만, `\label`은 반드시 영문 label을 붙여주기 바랍니다. hyperref은 한글 label을 처리하지 못합니다. `\bibcite`의 `cite_key`도 영문으로 사용할 것을 권장합니다. * hangul.sty의 자동조사 기능을 채택하지 않았기 때문에 영문 스타일 파일과의 충돌을 최소한으로 줄여줍니다. PDF를 만드는 상황에서 HLaTeX의 hangul 스타일을 대체할 수 있도록 하려고 합니다. * 자동조사 기능은 원칙적으로 `\label, \ref, \pageref, \bibitem, \cite` 등의 명령과 관계가 있습니다. 이 하이퍼링크-자동조사와는 별도로 RawJosa 기능, 즉 위의 하이퍼링크를 만들지 않는 경우의 자동조사 동작을 사용자가 지정할 수 있습니다. /!\ 다만, 이 두 가지를 섞어서 사용할 수는 없습니다. 예컨대, `\bibitem[testbib\fjs{\jong}]{testo}`과 같은 형태의 명령은 에러를 냅니다. * `\cite`가 저자명이나 저서명을 인용하는 경우 자동조사가 실제 읽기와 일치하지 않는 경우가 있습니다. 부분적 개선이 0.2b에서 이루어졌지만 완전한 해결을 위해서는 사전을 사용하여야 할 것으로 생각됩니다. * 이 스타일은 내부적으로 HyperRef 패키지를 필요로 합니다. 만약 명시적으로 `hyperref`을 로드하지 않으면 기본값으로 불러옵니다. ''그 결과 cite, overcite 패키지의 일부 기능 등은 작동하지 않습니다. 이것은 원래 cite, overcite가 hyperref과 함께 쓰이지 않기 때문에 생긴 일입니다.'' * 자동조사 명령 `"\라"`, `"\이라"`가 추가되었습니다. * `\PageName` `\AltPageName` 명령이 정의되어 있습니다. 앞의 것은 "페이지" 뒤의 것은 "쪽"으로 페이지 이름을 사용합니다. * 카운터에 대한 자동조사는 한글 및 기호 문자 카운터에도 작동합니다. * `\hroman` 명령과 `\hRoman` 명령을 추가하였습니다. 카운터에 대해서 `\roman`, `\Roman`을 쓰는 경우와 동일하지만 한글 기호 문자의 로만 숫자를 찍어줍니다. 이 경우 자동조사가 작동하게 하려면 josa.tab을 교체하시기 바랍니다. (josa.tab의 위치는 HLaTeX 매크로 hangul.sty가 있는 곳입니다.) === 사용법 === 주요 사용법은 시험용 테스트 파일을 보시기 바랍니다. [http://my.ktug.or.kr/misc/hangul-k-test.tex hangul-k-test.tex] 비참조 자동조사(즉 하이퍼링크가 만들어지지 않는 경우의 자동조사) 처리를 위해서는 `\HNUM, \Gana, \OGana, \PEng, \OEng, \Jaso, \OJaso, \PJaso, \ONum, \PNum`을 사용합니다. 예를 들면 {{{ \newcounter{tmpcnt} \setcounter{tmpcnt}{1} \PJaso{tmpcnt}\가 \stepcounter \PEng{tmpcnt}\를 }}} 위와 같은 코드는 HyperRef의 하이퍼링크와는 무관한 사용자 정의 카운터입니다. 이럴 경우에 `\Gana` 등을 쓰십시오. 반면 {{{ \renewcommand\theenumi{\jaso{enumi}} \begin{enumerate} \item \label{enum:1} \end{enumerate} \ref{enum:1}\는 }}} 이 예에서와 같이 하이퍼링크를 만드는 카운터에는 `\gana` 등을 그대로 사용합니다. 하이퍼링크를 만드는 카운터는 주로 `\ref`나 `\pageref` 명령에 의해 불리는 것을 말합니다. `\fjs`나 `\xjs` 명령으로 특정 단어의 조사형태를 미리 지정해둘 수 있습니다. `\fjs`는 `\jung, \jong, \rieul` 가운데 하나를 인자로 취합니다. 반면 `\xjs`는 인자로 들어가는 단어를 그대로 표시하고 거기에 자동조사 처리를 위한 코드를 붙입니다. 예를 들어 {{{ \newcommand\goodman{good man\fjs{\jong}} \goodman\가 말하기를... => good man이 말하기를... }}} 이 때는 man의 끝소리를 사용자가 지정하였습니다. 반면 {{{ \newcommand\goodman{\xjs{좋은 사람}} \goodman\가 말하기를... => 좋은 사람이 말하기를... }}} 이 경우에는 "좋은 사람"의 마지막 "람"자를 기준으로 자동조사를 답니다. 다음과 같은 형태의 명령도 가능합니다. {{{ \pageref{exlabel}\PageName\을 }}} 이 경우 `\PageName`이 "페이지"이면 "를", "쪽"이면 "을"을 식자하게 하려면, {{{ \renewcommand\PageName{\xjs{페이지}} }}} 과 같이 정의해둡니다. == 개정연혁 == '''version 0.2''' [[Date(2004-05-12T18:27:27)]] * 자동조사 명령 `\이라` 추가. * `\Hnum` 일부 수정. [[Date(2004-05-11T11:09:30)]] (0.2c) * 일부 오류 수정. hyperlink 중복정의(깜빡한 것이었음...) 삭제. * \hroman, \hRoman 명령 도입. josa.tab 수정. [[Date(2004-05-09T19:57:52)]] (0.2b) * KTUGContrib:1622''''''의 영문자 처리루틴 개선 채택.(DohyunKim) 2004/05/04 (0.2a) * hyperref의 `[dvipdfm`과 `[pdftex]` 지원(DohyunKim) * hyperref 이후에 로드해야 하는 불편을 없앰. 2004/05/04 (0.2) * DohyunKim의 "일반화된 한글 기호문자 조사처리" 방식의 채택. 새 버전으로 릴리즈. * `\xjs, \DEFINEJOSA, \HNUM, \Gana, \OGana, \PEng, \OEng, \Jaso, \OJaso, \PJaso, \ONum, \PNum` 명령 정의. Raw Josa(hyperlink 없는 곳에서 자동조사 처리). * `\xjs`는 `\DEFINEJOSA` 명령과 동일함. 인자 한 단어를 반환하고 `\make@josa`를 정의. * `\fjs`는 하위호환성을 위해서 유지함. * hangul.sty `\hnum` 명령의 버그 수정. '''version 0.1''' 2004/05/03 * 김도현 님의 `\@jong` 추가 제안 채택. KTUG:1580 * `[nohyperref]` 옵션. 테스트 목적의 옵션임. 이 옵션을 주면 자동조사가 작동하지 않습니다. 2004/05/02 * `\gana, \jaso, \onum` 등 지원. Thanks to Dohyun Kim. * 다만, 하이퍼링크가 걸리지 않는 `\gana` 등은 아직 지원되지 못함. 이 경우에는 `\fjs` 명령을 이용하여 직접 코딩할 것. * hyperref의 디폴트 옵션을 `[bookmarks=false]`로 바꿈. * 해결할 문제. 현재는 숫자 카운터에 대해서만 자동조사가 작동함 일반적 문자열을 사용자가 직접 `\fjs`를 넣어야 하는데, 이것을 자동화할 수 있으면 좋을 것임. 2004/04/30 Karnes Kim의 hangul-nojosa와 Dohyun Kim의 autojosa 솔루션을 합침. hangul-nojosa와 마찬가지로 다른 영문스타일과의 충돌을 최소화하면서 Dohyun Kim의 자동조사 기능을 구현 ---- [CategoryTeXMacro]