*** README.ks ***

서 언:
------

TeX와 같은 좋은 문서작성기로 우리의 글을 쓸 수 있다는 것은 너무도
기쁜 일입니다. 한글LaTeX에서는 한글뿐만 아니라 한자도 쓸 수 있으며 KSC
5601에서 정의되어 있는 심벌도 모두다 쓸 수 있읍니다.

앞으로는 한국인이면 누구나가 다 자유롭게, (La)TeX를 사용하여 한글 문서를
작성할 수 있게 되기를 바랍니다.

프로그램 개요:
--------------
이 프로그램은 HLaTeX 0.91(백윤주)과 jhtex-0.7(은광희)을 바탕으로
\LaTeXe를 통해 한글과 漢字를 사용하여 한글문서를 작성할 수 있도록 만든
프로그램입니다. 이제는 이전과 같이  ks-to-tex converter인 htex를 통해
KS코드를 전처리할 필요가 없고 일본한자를 쓰지 않게 되었읍니다. 원래는
HLaTeX-0.92로 발표될 예정이었으나 HLaTeX 0.91의 저자 백윤주님과의
연락이 두절된 관계로 마지막 두가지 사항에 대한 합의가 이루어지지 않은
채 저(은광희) 혼자만의 결정으로 이름을 한글LaTeX-0.92e로 하여 일반에
공개되게 되었읍니다.
글꼴의 사용이 원만하지 않았기에, 새로운 글꼴들을 만들어 MetaFont 쏘스로
공급할 수 있게 되었읍니다. 이전의 KAIST식 글꼴배치를 벗어나
KS완성형으로 글꼴을 만들게 되어서 한글LaTeX-0.95부터는 많은
하드디스크용량을 필요로 하게 되었음을 미리 알려드립니다.
하드디스크의 용량에 제한을 받을 경우에는 이전의 KAIST식 글꼴이나
조합형글꼴을 사용할 수 있읍니다. KAIST식 글꼴의 경우에는 300dpi와
600dpi의 프린터만 이용할 수 있고 조합형글꼴은 모든 해상도의 인쇄기를
다 쓸 수 있읍니다. -- 질은 완성형에 비해 떨어집니다.

변경사항에 대해서는 changelog.ks를 참조하시기 바랍니다. news.ks에는
사용자의 입장에서 새로운 점들이 씌여 있읍니다.

hlguide.tex 내지는 hlguide.ps에는 한글LaTeX의 사용설명과 설치방법
등이 수록되어있읍니다. hlguide.tex을 latex으로 직접 처리할 때 다음과
같은 점을 염두에 두시기 바랍니다. web2c-7.0이 나옴으로서 (1997/2)
TeX이 한 문서를 처리할 때 사용할 수 있는 글꼴의 수가 2000개까지로
늘어났읍니다. 이전의 TeX에서는 그 수가 256으로 제한되어 있읍니다. 위의
가이드에서는 370개 이상의 글꼴을 필요로 하고 있으므로 옛 판의 TeX을
쓸 때는 이 가이드를 끝까지 처리할 수 없읍니다.

사용에 필요한 한글 및 한자 글꼴들은 직접 만드시기
바랍니다. PostScript자형이나 MetaFont쏘스는 가까운 CTAN이나
cair-archive에서 가져오실 수 있읍니다.

CTAN: ~ftp/tex-archive/fonts/korean/HLaTeX
cair-archive.kaist.ac.kr: ~ftp/pub/hangul/tex/HLaTeX/...



프로그램 설치:
--------------
이하의 설명에서 texmf는 TDS (TeX Directory Standard)에 의거합니다.
1.LaTeX2e를 설치합니다.
  LaTeX2e package는 현재 공식적 LaTeX버전으로서 가까운 CTAN site에서
  anonymous ftp로 구할 수 있읍니다. (cair-archive.kaist.ac.kr 내지는
  ftp.dante.de)

2.한글LaTeX-0.98을 가까운 CTAN에서 가져와서 풉니다.

	mkdir hlatex-0.98
	cd hlatex-0.98
	ftp ftp.dante.de
	ftp> bin
	ftp> cd tex-archive/languages/korean/
	ftp> get HLaTeX.tar.gz
	ftp> quit
	zcat HLaTeX.tar.gz | tar xvf -

  HLaTeX 디렉토리에 있는 VERSION?.?? 파일은 현재의 한글LaTeX 버전을
  알려주는 파일이므로 이 파일을 통해 현재 가져오시는 한글LaTeX의
  버전을 알 수 있읍니다.

3.hfont.tex, hangul.sty, hfont.sty, hfontold.tex, josa.tab,
  oldhan.tab, h*.fd, hfont.cfg, hltx209.cfg, hsfonts.def를
  texmf/tex/latex/hlatex 디렉토리에 복사합니다.

	mkdir texmf/tex/latex/hlatex
        cp hangul.sty texmf/tex/latex/hlatex
	cp ...

3.한글자형을 설치합니다.
  emTeX을 사용할 경우에는 emtex/readme를 참고하십시요.

(a) MetaFont의 경우.
    먼저 MetaFont쏘스를 CTAN이나 cair-archive등에서 가져옵니다.

	ftp ftp.dante.de
	ftp> cd tex-archive/fonts/korean/HLaTeX
	ftp> bin
	ftp> get wsmj.tar.gz
	ftp> ...
	ftp> bye

    기본글꼴:
	wsmj.tar.gz (명조)
	wsgt.tar.gz (고딕)
	hanja-myoungjo.tar.gz (한자 명조)
	hanja-gothic.tar.gz (한자 고딕)
	hsym.tar.gz (한글 심벌: 명조, 고딕)

    다음의 매크로파일은 없어서는 않됩니다:
	common.tar.gz (공용 driver)
    여기에는 한글LaTeX에 공통으로 필요한 ligature나 매크로를 정의한
    파일들이 있읍니다.

    한글LaTeX에 쓸 수 있는 다른 글꼴들도 여럿 있읍니다:
	taza.tar.gz (타자)
        wsgr.tar.gz (그래픽)
	wsgs.tar.gz (궁서)
	wsmg.tar.gz (목각)
        wsyt.tar.gz (옛글)
        wssm.tar.gz (새명조)
        wspg.tar.gz (필기)
        wspn.tar.gz (펜글씨: 정자체+흘림체)
        wsbm.tar.gz (봄글씨)
        wsol.tar.gz (외곽)
	jamo.tar.gz (자모형 한글 글꼴: 명조, 고딕, 소라, 노벨)
	hanja-gungseo.tar.gz (한자 궁서)

    LaTeX호환모드에서 슬라이드를 작성할 때에는 다음의 글꼴이 필요합니다.
	hslide.tar.gz

  (a-1) pk 글꼴을 미리 만들어 시스템에 설치할 때
        위의 mf글꼴들을 fonts디렉토리에서 풉니다.

	cd fonts
	gzip -cd ../wsmj.tar.gz | tar xvf -
	...

        Makefile을 수정하고 이 Makefile에 설명이 되어 있는데로 글꼴을
        만듭니다.
	(주의:  hslide.tar.gz은 vf글꼴들이므로 그저 texmf/fonts
         디렉토리에서 풀어 놓으면 됩니다.

	 cd texmf/fonts
	 gzip -cd ..../hslide.tar.gz | tar xvf - )

  (a-2) mf쏘스를 시스템에 설치할 때
	이 경우 pk 글꼴들은 MakeTeXPK의 자동생성기능으로, 설치된
	mf쏘스코드로 부터 만들어 집니다.
	mf글꼴들을 texmf/fonts 디렉토리에서 풉니다.

	cd texmf/fonts
	gzip -cd ..../wsmj.tar.gz | tar xvf -
	...

	web2c-7.0이전의 TeX을 사용할 경우에
	fonts/config 디렉토리에 있는 special.map을 TeX의 special.map에
	추가시킵니다.

	cat fonts/config/special.map >> texmf/fontname/special.map

	이 파일은 MakeTeXPK등의 pk글꼴자동생성기능을 쓸 때, 만들어진
	글꼴이 texmf/fonts디렉토리의 어느 곳에 위치하게 될 것인가를
	결정하는데 필요합니다. 이 파일이 없을 경우에는
	unknown/unknown으로 간주되게 되어 있읍니다.

  teTeX이나 web2c-7.0 등의 경우 새로 설치한 글꼴들을 database에
  등록시켜야 합니다.

	texhash		(teTeX의 경우)
	MakeTeXls-R	(web2c-7.0의 경우)

(b) 포스트스크립트의 경우
    포스트스크립트자형을 CTAN에서 가져옵니다.

	ftp ftp.dante.de
	ftp> cd tex-archive/fonts/korean/HLaTeX
	ftp> bin
	ftp> get pkmj.tar.gz
	ftp> ...

    기본글꼴:
	pkmj.tar.gz (명조)
	pkgt.tar.gz (고딕)
	pshanja-myoungjo.tar.gz (한자 명조)
	pshanja-gothic.tar.gz (한자 고딕)
	phsym.tar.gz (한글 심벌: 명조, 고딕)

    한글LaTeX에 쓸 수 있는 다른 글꼴들도 여럿 있읍니다:
	ptaza.tar.gz (타자)
        pkgr.tar.gz  (그래픽)
	pkgs.tar.gz  (궁서)
	pkmg.tar.gz  (목각)
        pkyt.tar.gz  (옛글)
        pksm.tar.gz  (새명조)
        pkpg.tar.gz  (필기)
        pkpn.tar.gz  (펜글씨: 정자체+흘림체)
        pkbm.tar.gz  (봄글씨)
        pkol.tar.gz  (외곽)
	pjamo.tar.gz (자모형 한글 글꼴: 명조, 고딕, 소라, 노벨)
	pshanja-gungseo.tar.gz (한자 궁서)

    LaTeX호환모드에서 슬라이드를 작성할 때에는 다음의 글꼴이 필요합니다.
	phslide.tar.gz

    PS글꼴들을 시스템의 texmf/fonts 디렉토리에서 풉니다.

	cd texmf/fonts
	gzip -cd ..../pkmj.tar.gz | tar xvf -
	...

    fonts/config디렉토리에는 다음과 같은 파일들이 있읍니다.
	special.map:		TeX preview용
	hlatex.upr:		TeX preview용 (ps2pk 버전 1.5에 필요)
	psfonts.map:		TeX print용
	hlatex.enc:		pfb에 내장된 encoding vector.
	Fontmap:		ghostscript를 사용할 때. gsftopk에서 필요.

    special.map은 mf글꼴설치에서 설명한 것과 같이 TeX의 special.map에
    추가시킵니다. 마찬가지로, web2c-7.0이후의 TeX버전에서는 설치하지
    않아도 됩니다.

	cat fonts/config/special.map >> texmf/fontname/special.map

    psfonts.map은 dvips로 print할 때나 xdvi로 preview할 때
    필요합니다. dvips디렉토리의 psfonts.map에 삽입합니다.

	cat fonts/config/psfonts.map >> texmf/dvips/psfonts.map

    ghostscript를 사용하지 않고 직접 포스트스크립트 프린터로 프린트할
    때에는 ps글꼴을 download해야 하므로 각각의 줄 끝에 "<???.pfb"를
    덧붙입니다. 예로

	pkbmm00 Hangul-BomA-Medium <pkbmm0.pfb
	pkbmm01 Hangul-BomA-Medium " .167 SlantFont " <pkbmm0.pfb


    ghostscript를 써서 포스트스크립트 프린터로 프린트할 때에는
    Fontmap을 ghostscript의 Fontmap에 삽입하면 됩니다. 이때 Fontmap안에
    적혀진 글꼴디렉토리를 확인하여, 경우에 따라서 고쳐야 합니다.

	sed -e 's'/usr/teTeX'/usr/share' fonts/config/Fontmap >> \
	  /usr/local/share/ghostscript/4.03/Fontmap

    hlatex.enc은 꼭 필요하지 않습니다.

    hlatex.upr은 포스트스크립트글꼴 resource파일로서 ps2pk 버전 1.5를 사용할
    때 있어야 됩니다. preview때 필요한 pk파일을 만드는데 이용되는데 버전
    1.5는 처리속도가 빠르고 처리방법도 간편함으로 이를 이용하시기
    바랍니다. HLaTeX에서 만든대로 사용할 경우에는 파일이 있는 디렉토리
    이름을 수정해야 합니다. 예를들어 즉 6번째 줄의
	//usr/teTeX/texmf/fonts
    를
	//usr/share/texmf/fonts
    로 (이 디렉토리는 사용자가 설치한 곳으로 해야 합니다.) 자신이 새로
    이 파일을 만들려면 다음과 같이 합니다.

	mkpsres -o hlatex.upr /usr/share/texmf/fonts/{afm,type1}/korean

    이 파일을 그대로 \verb|ps2pk|의 configuration 디렉토리에 복사합니다.

	cp hlatex.upr texmf/dvips/ps2pk

    teTeX이나 web2c-7.0 등의 경우 새로 설치한 글꼴들을 database에
    등록시켜야 합니다.

	texhash		(teTeX의 경우)
	MakeTeXls-R	(web2c-7.0의 경우)

(c) 조합형글꼴을 사용하고자 할 때
    조합형글꼴은

	johab.tar.gz	(mf글꼴: 명조, 고딕, 펜글씨 정자체)
	pjohab.tar.gz	(ps글꼴: 명조, 고딕, 펜글씨 정자체)

    위의 글꼴을 (a)나 (b)에서 설명한 방법으로 설치합니다. 완성형에서
    빠진 글꼴을 쓰고자 할 때는 해당하는 완성형글꼴을 추가로 설치하시면
    됩니다.

사용법:
------
    \documentclass[hanja,...]{article}
    \usepackage{hangul}
    \begin{document}

  로 문서의 서두를 시작하여 KS완성형으로 한글 및 漢字를 쓰고

    \end{document}

  로 문서작성을 마칩니다.
  여기서의 hanja option은 \tableofcontents, \thechapter등이 한자로
  표현될 수 있도록 하기 위함입니다. 이 option을 선택하지 않으면 한글로
  표현됩니다. 다른 option들로는 hardbold, pshan이 있읍니다. hardbold는
  두꺼운 글씨체를 mf에서 만들어 사용하도록 하고 pshan은 한글PS글꼴을
  쓰도록 합니다. nojosa는 자동조사처리기능을 마비시키므로서 TeX의
  기억용량을 절약합니다.
  LaTeX2e 호환모드에서의 option처리는 hltx209.cfg파일을 작성함으로서,
  기본글꼴치를 시스템 administrator의 입장에서 설정할 때는 hfont.cfg를
  작성하면 됩니다. 이에 대해서는 `한글LaTeX 가이드'를 참고하기
  바랍니다. 이 서류철은 texmf/tex/latex/local에 둡니다.

  그저 한글만 문서에 찍히도록 할 경우에는
  \usepackage{hangul} 대신에 \usepackage{hfont}를 씁니다.

  작성된 문서를 latex으로 돌려 dvi파일을 만든 후 print하거나 preview합니다.
  혹시 프린트하는데 문제가 있으시면 문서를 한꺼번에 모두 프린트하지 않고
  다섯장씩 정도로 나누어 프린터에 보냅니다.
         dvips -Ppslocal -S5 <document>.dvi
  위의 경우 dvips는 다섯장씩을 단위로 dvi파일을 ps파일로 변환시킨후
  (S5), 프린터 pslocal에 (-Ppslocal) 보냅니다.

  hlguide.tex을 참조하면 여기에 대해서 좀 더 상세히 알 수 있읍니다.

문제점:
-------
만일 사용상에 문제점이 있거나 개선을 제의하실 것이 있으면 다음의 E-Mail 주소로
연락해 주시기 바랍니다. 편지는 한글로 써서 보내도 됩니다.

        koaunghi.un@student.uni-tuebingen.de

*** 끝 ***
