                        YahTeX 0.51

0. 이름
        Yet Another Hangul TeX.
        원래 이름이 hanTeX이었으나 또 하나의 한글 TeX인 hTeX과 구별되기 위함.

1. 제작자
        김 명준
        대전시 유성구 구성동 한국과학기술원 전산학과
        mjkim@jupiter.kaist.ac.kr
        042-869-3568

2. 설명
        TeX을 위한 한글 지원 패키지로 명조, 고딕 폰트 지원.
        1991 겨울에 물리과 친구의 닥달로 만들어져 물리학과를 중심으로
        사용되어 왔음. 실행시 hLaTeX version 0.5 by M. J. Kim 이라고
        표시되는 PC용 한글 TeX이 본인의 것임.
        지금은 몇가지 기능을 보강하고 80여 페이지의 TeX 매뉴얼 포함하여
        Version 0.51로 발표합니다.

2.1 History

1991/11/21      Ver 0.5
                한TeX 초기 버전. KAIST, 경북대 등에서 사용.

....            long time is spended - I am busy, I am lazy.

1994/5          한TeX 매뉴얼 초고 작성. 저자 최 영석, 김 명준

1993/6/14       Ver 0.51
                yahTeX (Yet Another Hangul TeX)으로 이름 변경.
                verbatim에서 한글 가능.
                Bug fix : han 옵션 없이도 수행가능.
                Automatic translation.
                        .htx -> .tex
                        .hbb -> .bib
                        .hst -> .sty
                한글 색인 가능.

3. 운영 환경
        DOS
        emTeX 필요

        emTeX은 PC용 TeX 패키지이며, YahTeX은 emTeX에서 한글을
        가능하게 하는 패키지 임.

4. 설치
        1. pkunzip -d yahtex.zip 으로 화일들을 yahtex이란 디렉토리에 저장.
        2. 다음과 같이 path와 SET 변수를 지정한다.

set path= ... c:\emtex;c:\yahtex ...

rem *** for TeX
set texinput=c:\yahtex\texinput;c:\emtex\texinput;
set tfm=c:\yahtex\tfm;c:\emtex\tfm
set texfmt=c:\yahtex\texfmts;c:\emtex\texfmts;
set textfm=c:\yahtex\tfm;c:\emtex\tfm
set emtexopt=/mf:65500

rem *** for DVIDRV
set dvidrvinput=c:\emtex\doc
set dvidrvfonts=c:\yahtex\fonts;c:\texfonts;
set dvidrvgraph=c:\emtex\doc\gr$r

rem *** for BibTeX
set bibinput=c:\emtex\bibinput

rem *** for Big TeX
set btexfmt=c:\emtex\btexfmts

rem *** for METAFONT
set mfinput=c:\emtex\mfinput
set mfbas=c:\emtex\mfbases
set bmfbas=c:\emtex\bmfbases
set mfjob=c:\emtex\mfjob

        이미 emTeX을 사용하시는 분들은 TeX, DVIDRV에 관한 set 변수와
        path 만을 고치시면 됩니다. 위의 내용은 set.bat 이름의 화일에
        있음.

        3. yahTeX 디레토리에 있는 lj.cnf, p6l.cnf 화일을 emTeX 디렉토리에
        복사. emTeX에 있는 lj.cnf, p6l.cnf 화일을 수정하는 과정임.

        4. c:\yahtex\fonts 디렉토리에는 다음과 같이 폰트 화일이 들어있는데
        사용중인 프린터와 맞는 것 외에는 지워도 괜찮음.
                hlj_0.fli       HP LaserJet
                hp6l_0.fli      24 pin dot 프린터
 
        5. config.sys : SET 변수가 많기 때문에 다음과 같이 SET 변수 영역을
        확장해 주어야한다.

                shell=c:\dos\command.com c:\dos /e:4096 /p


4. 화일 목록
        \yahtex\
                htex.exe        : yahTeX translator
                hlatex.bat      : yahTeX trandlator for LaTeX
                mkidx.exe       : 한글 색인 처리용 makeindex 프로그램 
                readme          : 바로 이 화일
                manuel.dvi      : yahTeX 매뉴얼
                manuel.ps       : yahTeX 매뉴얼 PostScript
        \yahtex\fonts\
                한글 폰트
        \yahtex\texfmts\
                TeX 포맷 화일
        \yahtex\texinput\
                한글용 style 화일
                        article.sty
                        report.sty
                        book.sty
        \yahtex\tfm\
                한글 폰트 metric

5. 사용 방법

    5.1 입력 화일
        상용 조합 한글 코드로 TeX 화일을 작성한다.
        화일 이름의 확장자는 반드시 .htx로 한다.

    5.2 hlatex, htex의 수행
        hlatex(htex)은 일단 수행되면 현재 디렉토리에 있는 모든 .htx
        화일로 부터 .tex 화일을 만든다.  변환된 .tex 화일은 영문
        TeX으로 한글을 처리할수 있도록 수정된 화일이다.
        변환이 끝나면 hlatex은 인수(argument)로 주어진 화일을 latex으로
        포맷팅한다. 예를 들어, hlatex sample이라고 하면 sample.htx에서 sample.tex
        화일이 생성되고 latex sample.tex이 수행된다. 

    5.3 htx 화일이 여러개일 경우
        예를 들어, 화일이 A.htx와 B.htx에 나뉘어져 있고 all.htx에서
        \input 명령으로 A.htx와 B.htx를 합치고 싶은 경우에는,
        우선 다음과 같이 all.htx화일을 작성한다.
                ...
                \input{A}
                \input{B}
                ...
        이제, hlatex all을 수행시키면 A.tex, B.tex, all.tex이 각 htx화일로
        부터 생겨나고 all.tex의 포맷팅이 수행된다.

    5.4 자동 변환에 대해
        htx화일에서 tex화일로의 자동 변환은 htx화일이 수정된 경우에만
        일어난다. 또한 실수로 사용자의 tex화일을 덮어 쓰는 것을 막기 위해,
        사용자의 화일이 같은 이름으로 존재하는 경우에는 자동 변환을
        하지 않는다.

        또한, htx외에 다음 화일에 대해서도 자동 변환을 수행한다.
                hbb -> bib
                hst -> sty

    5.5 스타일(style) 화일
        LaTeX에서 han옵션을 사용하면 Contents, Chapter, Section, 등과 같은
        단어들을 차레, 장, 절, 등으로 바구어 준다.

        report, article, book 스타일은 한글 처리를 위해 수정되어 있다.

    5.6 한글 BIB화일 만들기
        .hbb 확장자를 사용하여 한글 BIB화일을 만든다. htex이나 hlatex을
        수행하면 이로 부터 bib화일이 생성된다. 주의 사항,
                + 저자가 두명 이상인 경우는 "and"로 구분한다.
                + BibTeX이 한글 약자를 만들수 있도록 성씨에 중괄호를 한다.
                예) {김} 명준 and {최} 영석

    5.7 한글 색인
        makeindx 대신 yahTeX에서 제공하는 mkidx를 사용하면 한글 색인을
        사용할 수 있다.

6. Limitation
        + 한글 색인의 글자수는 10자 이내 이어야 한다.
        + 상용 조합 코드만을 지원한다.
        + 현재 PC 버전만 제공된다.

7. Copyright
        Copyright 김 명준, CS dept KAIST Korea.
        YahTeX은 public domain 소프트웨어입니다.
        개인적인 용도로 복사, 사용할수 있으며,
        허가 없이 상업적으로 이용될수 없읍니다.


