[[TableOfContents]] == 소개 == DHUcs는 [LaTeX-ucs] 패키지를 이용하여 UTF-8 유니코드 입력한 한글 문서를 처리하기 위한 LaTeX 패키지이다. == AUTHORS == * DohyunKim * [Karnes] 스타일의 핵심 부분인 한글 처리, 자동조사, 그리고 인덱스 작성 부분은 DohyunKim이 작성하였고, [Karnes]는 폰트 선택, 한글 서식 및 잡다한 조판상의 개선에 기여하고 문서화를 담당하였다. == 개발자 메시지 == DohyunKim, [[Date(2004-12-14T11:26:50)]] {{| UTF-8환경에서 옛한글을 제외하고 라틴문자와 한글, 한자만 쓴다면 latex-ucs를 활용하는 방법도 고려할 필요가 있지 않을까 합니다. omega는 아직 한계가 많으니까요. pdftex을 이용할 수도 없구요. 그래서 latex-ucs에서 한글쓰기를 잠시 테스트를 해 보았습니다. |}} == 명칭/COPYING == 1. 이 패키지 묶음에 포함된 파일군을 모두 총칭하여 hangul-ucs 패키지라고 부른다. 1. 라이센스는 GNU GPL을 따른다. == 구성 == 1. dhucs [LaTeX-ucs] 기반으로 한글 문서를 조판하기 위한 스타일 패키지이다. 1. fonts-unttf [은글꼴] 트루타입을 TeX/LaTeX에서 사용하도록 하기 위한 파일 모음이다. [은글꼴]을 설치해야 한다. 1. fonts-trivcj AdobeReader의 중국어, 일본어 언어팩에서 제공되는 otf 파일을 이용하여 다국어 식자에 활용할 수 있도록 하는 폰트 관련파일 모음이다. dhucs의 trivcj 스타일과 함께 사용할 수 있다. AdobeReader의 중국어, 일본어 언어팩을 설치해야 한다. http://www.adobe.com/products/acrobat/acrrasianfontpack.html 에서 리눅스용 중국어, 일본어 언어팩을 내려받을 수 있습니다. 1. fonts-uhc-unicode HLaTeX의 [UHC글꼴] 가운데 명조, 고딕, 그래픽, 타자 네 개의 글꼴을 dhucs에서 사용하도록 한 폰트 관련파일 모음이다. [UHC글꼴]을 설치해야 한다. == 다운로드 == === dhucs snapshot === dhucs 2.7.0 cvs (2006-03-28); ucsplain 0.3.1 http://ftp.ktug.or.kr/KTUG/hangul-ucs/dhucs-cvs-snapshot-current.tar.gz === fonts snapshot === * http://ftp.ktug.or.kr/KTUG/hangul-ucs/fonts-unttf.tar.gz (new:20060215) * http://ftp.ktug.or.kr/KTUG/hangul-ucs/fonts-uhc-unicode.tar.gz * http://ftp.ktug.or.kr/KTUG/hangul-ucs/fonts-trivcj.tar.gz == cvs 저장소 == http://cvs.ktug.or.kr/viewcvs/hangul-ucs {{| [[Date(2005-10-07T14:34:20)]] DHUcs는 cvs로 개발공간을 이전하였습니다. 앞으로 모든 개발은 cvs를 통해서 이루어집니다. {{{ #> cvs -d :pserver:anonymous@cvs.ktug.or.kr:/home/cvsroot login #> cvs -d :pserver:anonymous@cvs.ktug.or.kr:/home/cvsroot co hangul-ucs }}} |}} == 설치 == === 요구사항 === 1. TeXImplementations Windows의 경우는 MiKTeX 2.4, Linux의 경우 되도록 [teTeX] 3.0 이상이 설치되어 있을 것을 권장한다. 1. [LaTeX-ucs]는 반드시 설치해야 한다. Linux/debian의 경우 {{{apt-get install latex-ucs}}}. Windows/MiKTeX의 경우는 패키지 매니저에서 {{{unicode}}} 패키지를 선택 설치한다. 1. [은글꼴]이 설치되어 있어야 한다. 패키지의 기본 글꼴임. [은글꼴]은 실제 트루타입 글꼴을 말한다. [은글꼴]을 hangul-ucs에서 쓰기 위해서는 {{{.tfm}}}과 map 파일들이 필요한데 이것은 위의 fonts-unttf가 제공한다. 그러므로 반드시 [은글꼴] 트루타입 글꼴을 설치한 다음 fonts-unttf를 texmf 트리에 넣어두어야 hangul-ucs를 사용할 수 있다. 은글꼴 설치에 대해서는 http://kldp.net/projects/unfonts 또는 [은글꼴] 참고. === 권장 설치 사항 === 1. ttf2pk 1.5 dvi viewer를 통하여 출력물을 보기 위해서 필요합니다. See [ttf2pk] 1. DVIPDFMx PDF 출력을 위한 [DVI드라이버]입니다. 20050831 이후 버전을 권장합니다. 2004년 이전 버전은 map 파일을 인식하지 못하는 문제가 있을 수 있습니다. 1. Adobe CMap trivcj를 사용하려면 몇 개의 adobe cmap(nonfree)이 필요합니다. cmap 파일의 위치는 {{{[texmf]/fonts/cmap/}}} 아래에 오도록 하면 됩니다. === KTUG collection === KTUGCollectionProject에 hangul-ucs가 포함되어 있다. === Debian GNU/Linux === See KTUGContrib:3027''''''(by ALee) '''{{{/etc/apt/sources.list}}}에 다음 행 추가''' stable(sarge): {{{ deb http://people.debian.org/~alee/hangul-ucs stable main }}} testing(etch): {{{ deb http://people.debian.org/~alee/hangul-ucs stable main }}} '''설치''' {{{ # apt-get update # apt-get install freetype1-tools dvipdfmx latex-hangul-ucs }}} === Linux/Fedora Core === See KTUGContrib:3052''''''(by WkPark) * http://chem.skku.ac.kr/~wkpark/project/ktug/RPMS/ * http://chem.skku.ac.kr/~wkpark/project/ktug/SRPMS/ === Gentoo Linux === (by bluetux) /etc/make.conf 에 {{{ PORTDIR_OVERLAY="/usr/local/portage" }}} 추가 후 * http://freedesktop.org/~terry/hlatex_gentoo_overlays/ 이하 파일을 /usr/local/portage/ 에 복사.. {{{ # emerge -av =tetex-3.0-r4 hangul-ucs }}} 주의) tetex 버전은현재 제가 테스트 해봤을때 tetex-3.0-r4 가 좋았습니다.. tetex-3.0_px 버전은 버그가 있는듯했습니다. 아직 미비한 ebuild 이지만.. 혹 보완 고칠점 등 의견이 있으시면.... bluetux_at_gmail.com로 연락 주세요.. === Windows === MiKTeX 2.4에 대하여 다음 설치 방법이 제안되어 있다. * cf. [Windows에서설치하기/간단하게따라하기] * cf. KTUGContrib:3002 * [http://ftp.ktug.or.kr/~karnes/PRIVATE/experimental/hangul-ucs-2.6.1.exe hangul-ucs-2.6.1.exe] === Mac OS X === * [http://ftp.ktug.or.kr/~karnes/PRIVATE/experimental/Hangul-ucs-2.7.0-1.dmg Hangul-ucs-2.7.0-1.dmg] * cf. KTUGContrib:3137 * cf. [MacOS에서설치하기] == What's New == [[Date(2006-03-26T21:20:43)]] : '''dhucs 2.7.0''' 1. {{{dhucs-cmap.sty}}} 도입. pdflatex에서 한글 텍스트 검색추출 1. [http://my.ktug.or.kr/~karnes/testtest/from_261_to_270.zip from_261_to_270.zip] [[Date(2006-02-08T20:50:58)]] : dhucs 2.6.1 1. remove {{{UnTazaDH.ttf}}} [[Date(2005-12-24T09:06:28)]] 1. ALee 님의 Debian 설치 패키지, WkPark 님의 Fedora Core rpm 설치 패키지 추가. [[Date(2005-12-17T15:23:03)]] 1. DHUcs 페이지 명칭을 Hangul-ucs로 변경함. Hangul-ucs는 dhucs, fonts-unttf, fonts-uhc-unicode, fonts-trivcj를 포함하는 프로젝트 전체의 명칭으로 함. [[Date(2005-10-07T14:34:20)]] : moved to KTUG cvs 1. `UTF8-UCS2` cmap 파일을 제외하고 dhucs-ucshyper를 추가함. [[Date(2005-08-26T14:33:01)]] : dhucs 2.6 1. 영문 기본 글꼴을 CM으로 바꿈 (cm-super 등을 요구하지 않음) 1. 폰트 선택 방식 변경, unihangulchar 알고리듬 개선 1. 기타 오류 및 불일치 개선 1. dhucs-trivcj를 포함함 == 문서 == 일반적인 설치 사용법에 관해서는 포함된 [http://my.ktug.or.kr/~karnes/testtest/dhucsdoc.pdf dhucsdoc.pdf]를 읽어보라. 이 문서의 소스는 http://cvs.ktug.or.kr/viewcvs/hangul-ucs/dhucs/doc/ 에서 찾을 수 있다. 패키지로 설치한 경우에는 {{{[texmf]/doc/latex/dhucs/}}} 아래에서 찾을 수 있다. 다음은 이 문서를 컴파일하는 방법에 관한 지침이다. 1. PDFLaTeX으로 문서를 빌드하려 하는 경우에는 EPS 그림을 JPG나 PDF로 변환해둔다. 1. 문서 컴파일 조건을 {{{dhucsdoc.cfg}}} 파일을 편집함으로써 조절할 수 있다. 기본값은 다음과 같다. 1. `OT1` 글꼴 인코딩 : `\otfontfalse`로 바꾸면 `T1` 글꼴 인코딩이 된다. 1. CM 글꼴 : `OT1` 글꼴 인코딩에서는 CM만을 사용해야 한다. `T1`을 설정하였다면 lmodern 글꼴(`\lmfonttrue`) 또는 pxfonts 글꼴(`\pxfonttrue`)을 지정할 수 있다. 1. fonts-uhc-unicode 지원 : 디폴트는 이 부분을 제외하는 것이다. fonts-uhc를 설치한 다음에 활성화해야 한다. 1. trivcjfont 지원 : 디폴트는 제외하는 것이다. fonts-trivcj를 설치한 다음에 활성화해야 한다. trivcj 글꼴은 DVI 뷰어로는 볼 수 없고 PDFTeX으로도 처리되지 않는다. 오직 DVIPDFMx만 사용할 수 있음에 유의할 것. 1. [teTeX] 설치 패키지만을 지원 : 디폴트는 추가 패키지 없이 (Debian의) `tetex-base`와 `tetex-extra`만 설치한 상태에서 컴파일이 되도록 하였다. 추가 패키지를 CTAN을 통하여 내려받고 시스템에 설치할 수 있다면 이것을 false로 바꾸어서 시도해볼 수 있다. 1. 위의 공개 문서는 T1, pxfonts, uhc, trivcj, additional packages를 모두 활성화한 상태에서 컴파일한 결과이다. == 테스트해보기 및 활용 팁 == 파일 묶음 안에 들어 있는 doc/ 아래의 예제 파일은 패키지 문서를 겸하므로 컴파일하여 살펴볼 것을 권장한다. 1. 문서는 반드시 [UTF-8] 인코딩의 유니코드로 입력되어야 한다. 1. PDFLaTeX으로 컴파일하여 PDF 문서를 얻을 수도 있고, LaTeX -> DVIPDFMx로 처리할 수도 있다. 1. 한글 찾아보기(인덱스)를 만들기 위한 makeindex wrapper인 {{{makeindex-dhucs.pl}}} Perl Script가 포함되어 있다.(by DohyunKim) === 한글 책갈피 만들기 === {{{#!vim tex \usepackage{dhucs-ucshyper} }}} 이 패키지는 hyperref을 로드한다. 그러므로 hyperref을 별도로 선언할 필요는 없다. hyperref 설정을 바꾸려면 이 선언 이후에 {{{\hypersetup}}} 명령을 이용한다. === 한글 인덱스 만들기 === 한글 그룹별 헤딩을 주고 싶다면 {{{ makeindex-dhucs.pl -s dhucs [확장자 없는 tex 파일명(.aux 파일명)] }}} 헤딩없이 그룹구분만 하고 싶으면 {{{ makeindex-dhucs.pl [확장자 없는 tex 파일명(.aux 파일명)] }}} * Windows 에서 perl 없이 makeindex-dhucs.pl 을 사용하고자 하시는 분들을 위해 ActiveState Perl 5.8.7과 PAR-0.89를 사용하여 makeindex-dhucs.exe를 만들었습니다. 도은이 아버님의 재배포에 문제가 없을것이라는 말씀에 용기를 얻어 다른 분들을 위해 아래 링크에 업로드해 둡니다. 모든 경우에 테스트해본 것은 아니니 이상이 있으면 말씀해주십시오. -Leo cf. KTUGSetup:8271 Uploads:makeindex-dhucs.exe.zip 저의경우 Win XP에서 실행시 perl58.dll failed - aborting with 22. 이라는 에러메시지를 내면서 실패합니다.(Active Perl은 깔지 않았습니다.)다른 분들은 어떠신가요? 위의 설치 섹션의 Windows 항목에 연결된 게시판 글에 가면 제공되는 설치 파일(msi)에 Perl을 별도로 요구하지 않는 윈도 실행파일이 들어 있습니다. == PDFLaTeX의 사용 == PDF를 얻기 위해서 PDFLaTeX을 DVIPDFMx 이외에 PDFLaTeX을 사용할 수 있다. 여기서는 은글꼴 관련 map 파일의 이름이 `unttf-pdftex-dhucs.map`이라고 한다.(데비안 설치 패키지와 윈도 간단설치 파일에서 이렇게 되어 있다.) 최근의 PDFTeX은 `pdftex.cfg`를 사용하지 않으므로 다음과 같은 조치가 필요하다. * {{{unttf-pdftex.map}}}의 내용을 PDFTeX이 읽는 map 파일에 붙여넣는다. 일반적으로 {{{[texmf]/fonts/map/pdftex/updmap/pdftex.map}}}일 수 있음. MiKTeX의 경우는 {{{[localtexmf]/pdftex/config/psfonts.map}}}. 패키지를 업그레이드할 때마다 이 파일의 내용이 변하므로 이 과정을 매번 다시 실행해주어야 하는 불편이 있다. * 또는, 원본 문서에서 다음과 같은 매크로를 넣어둔다. {{{#!vim tex \pdfmapfile{+unttf-pdftex-dhucs.map} }}} /!\ PDFLaTeX로 작성한 PDF는, 트루타입 글꼴의 fake slanted, fake bold 등을 지원하지 않습니다. * PDFLaTeX에서 한글 텍스트의 검색과 추출을 위해서 다음 스타일을 로드한다. {{{ \usepackage{dhucs-cmap} }}} * 일반적으로 다음과 같은 코드를 preamble에 넣어두는 것이 좋다. {{{ \usepackage{dhucs-ucshyper} % ifpdf 패키지를 불러준다. \ifpdf \pdfmapfile{+unttf-pdftex-dhucs.map} \usepackage{dhucs-cmap} \uscpackage[pdftex]{graphicx,color} \else .... (dvipdfmx를 위한 설정) \fi }}} == DHUcs의 응용과 확장 == === memhangul-ucs === {{{memoir}}} 패키지 한글판. See MemhangulClass. === hozemanucs === See [hoze매뉴얼프로젝트] == 문제점과 버그 == 문제점과 버그에 대한 토론은 [DHUcs/대화]를 볼 것. == 관련 자료 및 링크 == * [LaTeX-ucs] * [DHUcs/대화] * [http://kldp.net/projects/pkgsrc-wip pkgsrc-wip kr] cf. [http://kldp.net/forum/forum.php?forum_id=2814 tex-dhucs] * [UTF8한글조판] * HLaTeX2DHUcs ---- Maintained by DohyunKim and [Karnes]