================================================================ hLaTeXp, a Hangul (Korean) LaTeX2e macro package 1995/04/28 Version Copyright (C) 1995 Jae Choon Cha. All Rights are reserved. ================================================================ hLaTeXp is a Hangul LaTeX2e macro package. The followings are some features of hLaTeXp: - Supports Hangul(Korean), Hanja(Chinese), symbol characters in LaTeX documents. All characters in KS C 5601 code system are supported. - Requires no converter. - Compatible with (non-localized) LaTeX2e (for English). - Compiles documents quickly, relative to other Hangul LaTeX2e. - Compatible with various (non-localized) TeX utilities. No patch versions are required in most cases. - Provides various fonts: 31 Hangul fonts, 2 Hanja fonts, 1 Symbol fonts. - Performs correct line breaking for paragraphs containing Hangul. - Provides commands that automatically determine the correct "Jo-Sa" according to its preceeding letter. - Provides Koreanized standard document classes: article, report, book and letter. - Provides Korean style enumeration (like Ga, Na, Da, ...) commands. - Displays Hangul correctly in error messages onto a terminal screen, and writes textual Hangul informations correctly into auxiliary files such as aux, toc, ind. To obtain compatiblity with various (non-localized) TeX utilities, and to display/write Hangul correctly, a TeX compiler, called hTeXp, of the same author is required. Because the information written into files such as aux, toc, ind files is very important in high-level LaTeX processing, it is strongly recommended to use hTeXp when using hLaTeXp. Usually you can get hTeXp from the site where you get hLaTeXp. A hLaTeXp document hltxpman.tex explains how to use hLaTeXp in detail. It is contained in the hLaTeXp distribution package. You can typeset it using hLaTeXp and can view using your dvi driver after installation. Installation ------------ (1) Necessary files To install hLaTeXp, you need: - hlatexp-YYMMDD.tar.gz (YYMMDD is the version of hLaTeXp) - A set of Hangul/Hanja/Symbol fonts - A (non-localized) LaTeX2e distribution (1994/12/01 or later version) You may get a set of Hangul/Hanja/Symbol fonts from the "htex-fonts" directory of a distribution site of hLaTeXp and hTeXp. You must determine what font files are required for your installation, by considering your printing devices. At this writing, 300 and 600 dpi PK format Hangul/Hanja/ Symbol fonts are provided. You must get all the tfm files of Hangul/Hanja/Symbol fonts. They are in "htex-fonts/htex-tfm" directory of the distribution site. You can install a part of entire PK fonts if you want to save space. Of course, you need usual TeX fonts for English. If a TeX system is already installed on your machine, then you already have them. (2) How to dump hLaTeXp First, install all TFM files and PK files of Hangul/Hanja/Symbol fonts into your TeX installation. Uncompressing hlatexp-YYMMDD.tar.gz, you get a directory named "hlatexp". To dump hLaTeXp, a complete non-localized LaTeX2e distribution package is necessary. For user's convinience, an recent version of non-localized LaTeX2e is included in hLaTeXp. If you want to use the included non- localized LaTeX2e, then you can perform the next step in the directory "hlatexp/unpacked". This directory will be called unpacked directory. If not, that is, if you want to use other version of non-localized LaTeX2e, then you must create a directory containing all unpacked files of your non-localized LaTeX2e following the documentations of your non-localized LaTeX2e, and then copy all files from "hlatexp" directory into the directory containing your unpacked files of non-localized LaTeX2e. This directory will be your unpacked directory. In both cases, you have an unpacked directory. At your unpacked directory, try to dump original LaTeX2e following the documentation of the non- localized LaTeX2e. Usually no configuration is needed and a running of "initex" on the file latex.ltx suffices. If you use hTeXp, which is the recommended TeX compiler for hLaTeXp, then htexp latex.ltx will work. If you use typical un*x version TeX, then initex latex.ltx will work. If you failed, then refer documentations of your TeX compiler and your non-localized LaTeX2e. If you successfully dumped the non-localized LaTeX2e, now dump hLaTeXp at your unpacked directory using your initex. htexp hlatex.ltx or initex hlatex.ltx will work. Test hLaTeXp by a command like: htexp "&hlatex" hltxpman You can view hltxpman.dvi via your dvi driver if you installed tfm files and PK files correctly. (3) Copy files into TeX system directories Copy the following files from the unpacked directory into your TeX format directory (e.g. /usr/local/tex/htexpformats): hlatex.fmt latex.fmt Copy the following files from the unpacked directory into your TeX input directory (e.g. /usr/local/tex/htexpinputs): dbfont.map hltxpman.tex latexbug.tex testpage.tex lablst.tex idx.tex nfssfont.tex small2e.tex sample2e.tex docstrip.tex *.sty *.cls *.clo *.sty *.fd *.def *.cfg If you want to use MakeIndex, copy the following files into your MakeIndex input directory: *.idx Now the installation is completed. You can use hLaTeXp by commands like: htexp "&hlatex" thesis It is strongly recommended to create a shell script named "hlatex" such that "hlatex thesis" is equivalent to "htexp &hlatex thesis". User's manual ------------- A hLaTeXp document "hltxpman.tex" is provided. It explains how to use various features of hLaTeXp. It must be processed using hLaTeXp. Please send any comments on hLaTeXp to the author: jccha@math.kaist.ac.kr. Licensing agreement ------------------- Copyright (C) 1995 Jae Choon Cha. All Rights are reserved. The author of hLaTeXp grants to any individual or non-commercial organization the right to use and to make an unlimited number of copies of hLaTeXp package when this is done without charge and has attached this file with licence agreement. No part of hLaTeXp can be sold or distributed as a part of any commercial product, and used in any commercial organization, without additional agreement with the author.