목차

• 2004년부터 개발되어 온 Hangul-ucs는 2007년 6월을 기하여 HLaTeX과 통합되어 ko.TeX (Korean TeX) 프로젝트로 이동하였습니다.
• KTS에서 개발을 주관하는 ko.TeX은 Hangul-ucs의 다음 버전입니다. Hangul-ucs의 개발자들은 ko.TeX 개발에 참여합니다. ko.TeX 프로젝트 하에서 더 좋은 한글 텍을 만나게 되기를 원합니다.
• 이 페이지는 2007-07-12 이후로 수정되지 않습니다.

• DohyunKim
• Karnes
  
  스타일의 핵심 부분인 한글 처리, 자동조사, 그리고 인덱스 작성 부분은 DohyunKim이 작성하였고, Karnes는 폰트 선택, 한글 서식 및 잡다한 조판상의 개선에 기여하고 문서화를 담당하였다.
  
  

1. 이 패키지 묶음에 포함된 파일군을 모두 총칭하여 Hangul-ucs 패키지라고 부른다.
2. 라이센스는 GNU GPL을 따른다.
   
   

1. dhucs
   유니코드 한글 문서를 조판하기 위한 스타일 패키지이다.
2. oblivoir
   dhucs를 사용하여 memoir 한글 문서를 작성하는 memhangul-ucs 및 oblivoir 스타일 패키지이다.
3. fonts-unttf
   은글꼴 트루타입을 TeX/LaTeX에서 사용하도록 하기 위한 파일 모음이다. 은글꼴을 설치해야 한다.
4. fonts-unfonts-type1
   은글꼴 type 1. 바탕, 돋움, 그래픽, 타자.
5. fonts-trivcj
   AdobeReader의 중국어, 일본어 언어팩에서 제공되는 otf 파일을 이용하여 다국어 식자에 활용할 수 있도록 하는 폰트 관련파일 모음이다. dhucs의 trivcj 스타일과 함께 사용할 수 있다. AdobeReader의 중국어, 일본어 언어팩을 설치해야 한다.

   http://www.adobe.com/products/acrobat/acrrasianfontpack.html 에서 리눅스용 중국어, 일본어 언어팩을 내려받을 수 있습니다.
6. fonts-uhc-unicode
   HLaTeX의 UHC글꼴 가운데 명조, 고딕, 그래픽, 타자 네 개의 글꼴을 dhucs에서 사용하도록 한 폰트 관련파일 모음이다. UHC글꼴을 설치해야 한다.
   
   

1. TeXImplementations
   TeXLive 2007, teTeX 3.0 이상
2. LaTeX-ucs는 반드시 설치해야 한다.[1]
   Linux/debian의 경우 apt-get install latex-ucs latex-ucs-contrib.
3. 은글꼴이 설치되어 있어야 한다. 패키지의 기본 글꼴임.
   은글꼴은 실제 트루타입 글꼴을 말한다. 은글꼴을 hangul-ucs에서 쓰기 위해서는 .tfm과 map 파일들이 필요한데 이것은 위의 fonts-unttf가 제공한다. 그러므로 반드시 은글꼴 트루타입 글꼴을 설치한 다음 fonts-unttf를 texmf 트리에 넣어두어야 hangul-ucs를 사용할 수 있다. 은글꼴 설치에 대해서는 http://kldp.net/projects/unfonts 또는 은글꼴 참고.
   
   

1. ttf2pk 1.5
   dvi viewer를 통하여 출력물을 보기 위해서 필요합니다. See ttf2pk
2. DVIPDFMx
   PDF 출력을 위한 DVI드라이버입니다. 20050831 이후 버전을 권장합니다. 2004년 이전 버전은 map 파일을 인식하지 못하는 문제가 있을 수 있습니다.
3. Adobe CMap
   trivcj를 사용하려면 몇 개의 adobe cmap(nonfree)이 필요합니다. cmap 파일의 위치는 [texmf]/fonts/cmap/ 아래에 오도록 하면 됩니다.

1. 준비 사항
   • 은글꼴 패키지를 아직 설치하지 않았다면 설치할 것.

        # sudo apt-get install ttf-unfonts
       

   • 하드디스크의 용량이 충분한지 확인하고 임시 디렉토리를 하나 만들고 그 안에서 작업을 시작한다.
     
     
2. /etc/apt/sources.list에 다음 추가

     deb-src http://archive.ubuntu.com/ubuntu dapper main
     deb http://people.debian.org/~alee alee main
     

3. 소스 패키지 및 이의 컴파일에 필요한 패키지 내려받기

     # sudo apt-get update
     # sudo apt-get build-dep tex-common
     # sudo apt-get source tex-common
     # sudo apt-get build-dep libpoppler-dev
     # sudo apt-get source libpoppler-dev
     # sudo apt-get build-dep tetex-bin
     # sudo apt-get source tetex-bin
     # sudo apt-get build-dep tetex-base
     # sudo apt-get source tetex-base
     

   주의: 사용자 시스템의 상태에 따라 경고나 오류가 있을 수 있다. 예를 들어 글쓴이의 경우 tetex-bin 패이지의 컴파일을 위해서 libxaw8-dev가 요청되었는데 breezy에 있는 libxaw-headers로 대체되었다. 요구되는 패키지가 breezy에 없을 때에는 그 패키지도 소스를 내려받아서 컴파일해야 한다.
   
   
4. libpoppler-dev 컴파일, 패키징, 설치
   tetex-bin 패키지의 컴파일에 필요한 libpoppler-dev부터 시작하자.

  # cd poppler-0.5.1/
  # sudo debian/rules binary
  # cd ..
  # sudo dpkg --install libpoppler1_0.5.1-0ubuntu6_i386.deb
  # sudo dpkg --install libpoppler-dev_0.5.1-0ubuntu6_i386.deb
  

5. 나머지 패키지 컴파일 및 패키징
   위와 마찬가지로 각각의 소스 패키지 디렉토리에 들어가서 컴파일 및 바이너리 패키지를 빌드한다.

     # cd tetex-bin-3.0
     # sudo debian/rules binary
     

모든 패키지의 빌드를 완료하면 작업 디렉토리 안에 여러 개의 deb 파일들이 생성되어 있을 것이다.


6. 패키지 설치

     # sudo dpkg --install tex-common_0.15build1_all.deb
     # sudo dpkg --install libkpathsea4_3.0-13ubuntu5_i386.deb
     # sudo dpkg --install libkpathsea4-dev_3.0-13ubuntu5_i386.deb
     # sudo dpkg --install tetex-base_3.0-15build1_all.deb
     # sudo dpkg --install tetex-bin_3.0-13ubuntu5_i386.deb
     # sudo dpkg --install tetex-extra_3.0-15build1_all.deb
     # sudo apt-get install dvipdfmx freetype1-tools latex-hangul-ucs
     

7. 즐기세요.
   
   

• http://chem.skku.ac.kr/~wkpark/project/ktug/RPMS/
• http://chem.skku.ac.kr/~wkpark/project/ktug/SRPMS/

1. hangul-ucs-2.*-.rpm과, -unttf-*.rpm은 필수.
2. -uhc-*.rpm은 HLaTeX이 미리 설치되어 있어야 한다. HLaTeX 없이 Hangul-ucs만 사용하려 한다면 설치하지 말 것.
3. 은글꼴이 설치되어 있어야 한다.

PORTDIR_OVERLAY="/usr/local/portage" 

• http://freedesktop.org/~terry/hlatex_gentoo_overlays/

# emerge -av hangul-ucs

• pkgsrc
• tex-dhucs README

• MacOS에서설치하기

1. dhucs 4.0, oblivoir/memhangul 1.5.0
2. unfonts-type1
3. see dhucs 4.0 무엇이 달라졌나?

1. ucs 패키지를 사용하는 마지막 버전 dhucs 3.2.2의 릴리스 날짜를 2007-05-07로 함.

1. dhucs 3.2.1, [finemath] option
2. oblivoir
3. font map : UCS2.sfd

1. PDFLaTeX으로 문서를 빌드하려 하는 경우에는 EPS 그림을 JPG나 PDF로 변환해둔다.
2. 문서 컴파일 조건을 dhucsdoc.cfg 파일을 편집함으로써 조절할 수 있다. 기본값은 다음과 같다.
   1. OT1 글꼴 인코딩 : \otfontfalse로 바꾸면 T1 글꼴 인코딩이 된다.
   2. CM 글꼴 : OT1 글꼴 인코딩에서는 CM만을 사용해야 한다. T1을 설정하였다면 lmodern 글꼴(\lmfonttrue) 또는 pxfonts 글꼴(\pxfonttrue)을 지정할 수 있다.
   3. fonts-uhc-unicode 지원 : 디폴트는 이 부분을 제외하는 것이다. fonts-uhc를 설치한 다음에 활성화해야 한다.
   4. trivcjfont 지원 : 디폴트는 제외하는 것이다. fonts-trivcj를 설치한 다음에 활성화해야 한다. trivcj 글꼴은 DVI 뷰어로는 볼 수 없고 PDFTeX으로도 처리되지 않는다. 오직 DVIPDFMx만 사용할 수 있음에 유의할 것.
   5. teTeX 설치 패키지만을 지원 : 디폴트는 추가 패키지 없이 (Debian의) tetex-base와 tetex-extra만 설치한 상태에서 컴파일이 되도록 하였다. 추가 패키지를 CTAN을 통하여 내려받고 시스템에 설치할 수 있다면 이것을 false로 바꾸어서 시도해볼 수 있다.
   6. 위의 공개 문서는 T1, pxfonts, uhc, trivcj, additional packages를 모두 활성화한 상태에서 컴파일한 결과이다.

1. 문서는 반드시 UTF-8 인코딩의 유니코드로 입력되어야 한다.
2. PDFLaTeX으로 컴파일하여 PDF 문서를 얻을 수도 있고, LaTeX -> DVIPDFMx로 처리할 수도 있다.
3. 한글 찾아보기(인덱스)를 만들기 위한 makeindex wrapper인 makeindex-dhucs.pl Perl Script가 포함되어 있다.(by DohyunKim)

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. 8271
  makeindex-dhucs.exe.zip

  저의경우 Win XP에서 실행시 perl58.dll failed - aborting with 22. 이라는 에러메시지를 내면서 실패합니다.(Active Perl은 깔지 않았습니다.)다른 분들은 어떠신가요? 위의 설치 섹션의 Windows 항목에 연결된 게시판 글에 가면 제공되는 설치 파일(msi)에 Perl을 별도로 요구하지 않는 윈도 실행파일이 들어 있습니다.

• unttf-pdftex.map의 내용을 PDFTeX이 읽는 map 파일에 붙여넣는다. 일반적으로 [texmf]/fonts/map/pdftex/updmap/pdftex.map일 수 있음. MiKTeX의 경우는 [localtexmf]/pdftex/config/psfonts.map. 패키지를 업그레이드할 때마다 이 파일의 내용이 변하므로 이 과정을 매번 다시 실행해주어야 하는 불편이 있다.
• 또는, 원본 문서에서 다음과 같은 매크로를 넣어둔다.

  \pdfmapfile{=unttf-pdftex-dhucs.map}
  

  PDFLaTeX로 작성한 PDF는, 트루타입 글꼴의 fake slanted, fake bold 등을 지원하지 않습니다.
• PDFLaTeX에서 한글 텍스트의 검색과 추출을 위해서 다음 스타일을 로드한다.

  \usepackage{dhucs-cmap}
  

• 일반적으로 다음과 같은 코드를 preamble에 넣어두는 것이 좋다.

  \usepackage{ifpdf} % ifpdf 패키지를 불러준다.
  \ifpdf
   \pdfmapfile{=unttf-pdftex-dhucs.map}
   \usepackage{dhucs-cmap}
   \usepackage[pdftex]{graphicx,color}
   \usepackage[unicode,pdftex]{hyperref}
  \else
   .... (dvipdfmx를 위한 설정)
  \fi
  

• LaTeX-ucs
• DHUcs/대화
  
  
• UTF8한글조판
  
  
• HLaTeX2DHUcs