KTUGFaq

KTUG FAQ

로그인:
비밀번호:
가입
Economy makes men independent.
FrontPage › Hangul-ucs

목차

1 프로젝트 이동 알림
2 소개
3 AUTHORS
4 개발 동기
5 명칭/COPYING
6 구성
7 다운로드
8 설치
8.1 요구사항
8.2 권장 설치 사항
9 플랫폼별 설치 패키지
9.1 Debian GNU/Linux
9.2 Ubuntu Dapper Drake (6.06)
9.3 Ubuntu Breezy Badger (5.10)
9.4 Linux/Fedora Core
9.5 Gentoo Linux
9.6 pkgsrc: The NetBSD Packages Collection
9.7 Windows
9.7.1 KTUG Collection 2006
9.7.2 MiKTeX 2.6
9.8 Mac OS X
9.9 [http]Cygwin
10 What's New
11 문서
12 테스트해보기 및 활용 팁
12.1 한글 책갈피 만들기
12.2 한글 인덱스 만들기
13 PDFLaTeX의 사용
14 DHUcs의 응용과 확장
14.1 hozemanucs
15 문제점과 버그
16 관련 자료 및 링크

1 프로젝트 이동 알림

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

2 소개

DHUcs(Hangul-ucs)는 LaTeX-ucs 패키지를 이용하여 UTF-8 유니코드 입력한 한글 문서를 처리하기 위한 LaTeX 패키지이다.

3 AUTHORS

  • DohyunKim
  • Karnes

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

4 개발 동기

DohyunKim, 2004-12-14
UTF-8환경에서 옛한글을 제외하고 라틴문자와 한글, 한자만 쓴다면 latex-ucs를 활용하는 방법도 고려할 필요가 있지 않을까 합니다. omega는 아직 한계가 많으니까요. pdftex을 이용할 수도 없구요. 그래서 latex-ucs에서 한글쓰기를 잠시 테스트를 해 보았습니다.

5 명칭/COPYING

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

6 구성

  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
    HLaTeXUHC글꼴 가운데 명조, 고딕, 그래픽, 타자 네 개의 글꼴을 dhucs에서 사용하도록 한 폰트 관련파일 모음이다. UHC글꼴을 설치해야 한다.

8 설치

8.1 요구사항

  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] dhucs ver4.0 이후로는 이 패키지를 필요로 하지 않는다.

8.2 권장 설치 사항

  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/ 아래에 오도록 하면 됩니다.

9 플랫폼별 설치 패키지

설치 패키지 제작 관리자와 기여자분들께 감사드립니다.

9.1 Debian GNU/Linux

# apt-get install latex-hangul-ucs

9.2 Ubuntu Dapper Drake (6.06)

Debian unstable/testing 설명에 따라 그냥 설치하면 된다. 또는 [http]KLDP내용을 참고하라.

9.3 Ubuntu Breezy Badger (5.10)

현재 안정판인 Breezy Badger (5.10)에는 teTeX 3.0이 포함되어 있지 않다. 그러므로 6월 1일 최종 발표 예정인 Dapper Drake (6.06)의 소스 패키지를 이용하여야 한다.

  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부터 시작하자.
  5.   # 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
      
  6. 나머지 패키지 컴파일 및 패키징
    위와 마찬가지로 각각의 소스 패키지 디렉토리에 들어가서 컴파일 및 바이너리 패키지를 빌드한다.
      # cd tetex-bin-3.0
      # sudo debian/rules binary
      
  7. 모든 패키지의 빌드를 완료하면 작업 디렉토리 안에 여러 개의 deb 파일들이 생성되어 있을 것이다.

  8. 패키지 설치
      # 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
      
  9. 즐기세요.

기타 설정 등에 관한 사항은 Debian의 설명을 참고할 것.

9.4 Linux/Fedora Core

See KTUGContrib:3052(by WkPark) i386/ 의 ttf2pk-*.rpm, dvipdfmx-*.rpm을 먼저 설치한 다음 noarch/의 hangul-ucs-*.rpm을 설치한다.
  1. hangul-ucs-2.*-.rpm과, -unttf-*.rpm은 필수.
  2. -uhc-*.rpm은 HLaTeX이 미리 설치되어 있어야 한다. HLaTeX 없이 Hangul-ucs만 사용하려 한다면 설치하지 말 것.
  3. 은글꼴이 설치되어 있어야 한다.

9.5 Gentoo Linux

(by bluetux) /etc/make.conf 에
PORTDIR_OVERLAY="/usr/local/portage" 
추가 후 이하 파일을 /usr/local/portage/ 에 복사..
# emerge -av hangul-ucs

-- 현재 버전이 문제가 있어.. 빌드가 되지 않습니다.. hangul-ucs 가 버전업되면서 뭐가 변경 되어 3.1.6 버전까지 현재 완성 되었고 4.0.0 이빌드를 제작 시도 중입니다.. (아직 업로드는 않되어 있음..)

-- 의견이 있으시면.... bluetux_at_gmail.com로 연락 주세요..

9.6 pkgsrc: The NetBSD Packages Collection

9.7 Windows

9.7.1 KTUG Collection 2006

윈도에서 Hangul-ucs 사용은 KTUGCollection2006을 권장한다. KTUGCollection2006에 이미 포함되어 있으므로 별도의 조치 없이 바로 문서작성에 이용할 수 있다.

10 What's New

2007-06-12 : dhucs 4.0.0
  1. dhucs 4.0, oblivoir/memhangul 1.5.0
  2. unfonts-type1
  3. see [http]dhucs 4.0 무엇이 달라졌나?
2007-05-07 : dhucs 3.2.2
  1. ucs 패키지를 사용하는 마지막 버전 dhucs 3.2.2의 릴리스 날짜를 2007-05-07로 함.
2007-04-27 : dhucs 3.2.1
  1. dhucs 3.2.1, [finemath] option
  2. oblivoir
  3. font map : UCS2.sfd

11 문서

일반적인 설치 사용법에 관해서는 포함된 [http]dhucsdoc.pdf를 읽어보라.(2007-06-03, dhucs 4.0,0)

이 문서의 소스는 http://cvs.ktug.or.kr/viewcvs/hangul-ucs/dhucs/doc/ 에서 찾을 수 있다. 패키지로 설치한 경우에는 [texmf]/doc/latex/dhucs/ 아래에서 찾을 수 있다. 다음은 이 문서를 컴파일하는 방법에 관한 지침이다.
  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-basetetex-extra만 설치한 상태에서 컴파일이 되도록 하였다. 추가 패키지를 CTAN을 통하여 내려받고 시스템에 설치할 수 있다면 이것을 false로 바꾸어서 시도해볼 수 있다.
    6. 위의 공개 문서는 T1, pxfonts, uhc, trivcj, additional packages를 모두 활성화한 상태에서 컴파일한 결과이다.

12 테스트해보기 및 활용 팁

파일 묶음 안에 들어 있는 doc/ 아래의 예제 파일은 패키지 문서를 겸하므로 컴파일하여 살펴볼 것을 권장한다.

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

12.1 한글 책갈피 만들기

PDFLaTeX
\usepackage[unicode]{hyperref}
DVIPDFMx
\usepackage[unicode,dvipdfm]{hyperref}
dvips/ps2pdf (ver 2.7.0)
\usepackage[unicode,dvips]{hyperref}

12.2 한글 인덱스 만들기

한글 그룹별 헤딩을 주고 싶다면
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을 별도로 요구하지 않는 윈도 실행파일이 들어 있습니다.

13 PDFLaTeX의 사용

PDF를 얻기 위해서 PDFLaTeXDVIPDFMx 이외에 PDFLaTeX을 사용할 수 있다. 여기서는 은글꼴 관련 map 파일의 이름이 unttf-pdftex-dhucs.map이라고 한다.(데비안 설치 패키지와 윈도 간단설치 파일에서 이렇게 되어 있다.) 최근의 PDFTeXpdftex.cfg를 사용하지 않으므로 다음과 같은 조치가 필요하다.
  • 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
    

14 DHUcs의 응용과 확장


15 문제점과 버그

문제점과 버그에 대한 토론은 DHUcs/대화를 볼 것.

16 관련 자료 및 링크


^
Valid XHTML 1.0! Valid CSS! powered by MoniWiki
last modified 2008-02-03 11:34:44
Processing time 0.2292 sec