KTUGFaqKTUG FAQ
Expect a letter from a friend who will ask a favor of you.
FrontPage › HANGULkStyle
[편집]
2 자동조사 ¶
HLaTeX의 hangul.sty에는 아주 훌륭한 자동조사 기능이 있습니다. 그러나 이 자동조사 기능은 평상시에는 매우 편리하지만 PDF Hyperlink를 만들 때는 불편하였습니다.
그 때문에 PDF를 만들기 위해서는 그 동안 hangul에서 자동조사 기능을 제거한 hangul-nojosa가 쓰여왔습니다.
hangul-k는 이 hangul-nojosa를 기반으로 DohyunKim 님이 개발한 하이퍼링크-자동조사 루틴을 채택하여 PDF를 만들 때 자동조사가 작동하도록 한 것입니다. DohyunKim 님의 하이퍼링크-자동조사의 아이디어는 hyperref이 링크를 만들기를 기다려서 거기서 반환되는 문자열 또는 숫자를 직접 분해/분석하여 마지막 글자값을 정하고 여기에 맞는 자동조사를 붙여주는 방식입니다.
[편집]
3.1 주요 기능 ¶
일반적으로, hangul.sty에서 제공하는 자동조사 명령을 쓸 수 있습니다.
- 문서 작성 자체는 hangul을 사용할 때와 똑같이 하면 됩니다. 다만, \label은 반드시 영문 label을 붙여주기 바랍니다. hyperref은 한글 label을 처리하지 못합니다. \bibcite의 cite_key도 영문으로 사용할 것을 권장합니다.
- hangul.sty의 자동조사 기능을 채택하지 않았기 때문에 영문 스타일 파일과의 충돌을 최소한으로 줄여줍니다. PDF를 만드는 상황에서 HLaTeX의 hangul 스타일을 대체할 수 있도록 하려고 합니다.
- 자동조사 기능은 원칙적으로 \label, \ref, \pageref, \bibitem, \cite 등의 명령과 관계가 있습니다. 이 하이퍼링크-자동조사와는 별도로 RawJosa 기능, 즉 위의 하이퍼링크를 만들지 않는 경우의 자동조사 동작을 사용자가 지정할 수 있습니다.
![/!\](/wiki/imgs/smile/alert.png "/!\")
다만, 이 두 가지를 섞어서 사용할 수는 없습니다. 예컨대, \bibitemtestbib\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가 있는 곳입니다.)
[편집]
3.2 사용법 ¶
주요 사용법은 시험용 테스트 파일을 보시기 바랍니다. ![[http]](/wiki/imgs/http.png)
hangul-k-test.tex
hangul-k-test.tex
비참조 자동조사(즉 하이퍼링크가 만들어지지 않는 경우의 자동조사) 처리를 위해서는 \HNUM, \Gana, \OGana, \PEng, \OEng, \Jaso, \OJaso, \PJaso, \ONum, \PNum을 사용합니다. 예를 들면
위와 같은 코드는 HyperRef의 하이퍼링크와는 무관한 사용자 정의 카운터입니다. 이럴 경우에 \Gana 등을 쓰십시오. 반면
이 예에서와 같이 하이퍼링크를 만드는 카운터에는 \gana 등을 그대로 사용합니다. 하이퍼링크를 만드는 카운터는 주로 \ref나 \pageref 명령에 의해 불리는 것을 말합니다.
\newcounter{tmpcnt}
\setcounter{tmpcnt}{1}
\PJaso{tmpcnt}\가
\stepcounter
\PEng{tmpcnt}\를
\renewcommand\theenumi{\jaso{enumi}}
\begin{enumerate}
\item \label{enum:1}
\end{enumerate}
\ref{enum:1}\는
\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{페이지}}
과 같이 정의해둡니다.
[편집]
4 개정연혁 ¶
version 0.2
2004-05-11 (0.2c)
- 일부 오류 수정. hyperlink 중복정의(깜빡한 것이었음...) 삭제.
- \hroman, \hRoman 명령 도입. josa.tab 수정.
2004/05/03
2004/05/02
- \gana, \jaso, \onum 등 지원. Thanks to Dohyun Kim.
- 다만, 하이퍼링크가 걸리지 않는 \gana 등은 아직 지원되지 못함. 이 경우에는 \fjs 명령을 이용하여 직접 코딩할 것.
- hyperref의 디폴트 옵션을 bookmarks=false로 바꿈.
- 해결할 문제. 현재는 숫자 카운터에 대해서만 자동조사가 작동함
일반적 문자열을 사용자가 직접 \fjs를 넣어야 하는데, 이것을 자동화할 수 있으면 좋을 것임.
