~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ README.ETH V. 1.0 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ * The EthTeX Package The system comes with ten 5.25" floppy diskettes and it is also available in a number of archive sites through FTP (File Transfer Protocol.) To get it via ftp, you must have an access to a network with an ftp service. If you don't have one, you may get the package from me, but you must cover the expense--material and shipping & handling. * Hardware Requirement IBM pc or compatible with 8086, 80286, 80386, or 80486 640MB RAM EGA, or VGA display adapter About 8MB hard disk space * The System features emTeX : TeX, LaTeX, METAFONT, and others stuff. MicroEMACS that includes EthioME for Ethiopic editing. TeXshell eLaTeX--a modified version of LaTeX featuring Amharic commands Ethiopian fonts including source code Installer * Documents All the following documents are included in distribution and can be processed and printed. They are located in "C:\EMTEX\DOC\AMHARIC" directory. README.ETH : This file READ1ST.TEX : Introduction and installation guide (Amharic--TeX file) VIEWER.TEX : Users guide for dvi file viewing (Amharic--TeX file) PRTDVR.TEX : Users guide for printing dvi files (Amharic--TeX file) TEXSHELL.TEX : Introductory TeXshell users guide (Amharic--TeX file) ETHIOME.TEX : An Amharic reference manual for ETHIOME (a TeX file) * Optional An Amharic eLaTeX document preparation Guide $xx.xx ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ * Installing the EthTeX Package There are two ways of installing the EthTeX package---automatic installation with an installer program or else manual using PKUNZIP program. * With Installer The installer will allow you to install a minimum pre-configured system. To do so follow the instruction below: 1. It is always a good practice to make a back copy of all original diskettes; therefore, before you install the system, backup the diskettes. 2. Insert the diskette labeled "emTeX #1/8" into the floppy disk drive. 3. While you are on floppy disk drive type "install" and press . For example, A:\>install then follow the program instruction until it tells you that the installation is complete. Incase, if you want to quit installing just press , but the installation part that was done until the time of the "quit" command is given will not be undo. NOTE: The installer program will not install every component of the package; therefore, it will skip a number diskettes during installation. * Using PKUNZIP: Here, you should be familiar with TeX, LaTeX, and METAFONT in general. You must know what part of the system you want to install. README.ENG (Disk #1): Read this file for more information on emTeX. README.INS (Disk #7): Read this file for more information on eLaTeX, TeXshell, EthioME, and fonts. PKUNZIP.EXE (Disk #1) can be used to decompress the necessary files. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ * Modifying AUTOEXEC.BAT and CONFIG.SYS The installer program knows how to update these files. However, if you have preferred to install the system with PKUNZIP, you should check and make an update to AUTOEXEC.BAT and CONFIG.SYS yourself. * Defining the environment: TeX and METAFONT must know where some part of files are located. There is a file called "set-tex.bat" which will take care of this for you. However, in order to use the system, either you have to run it every time you turn on the machine, or you should make a call from your AUTOEXEC file so that whenever the machine is turned on, it automatically set the environment. To call from AUTOEXEC: 1. Edit the AUTOEXEC.BAT file with your favorite editor 2. And, insert "call set-tex" at the end of the file, at least below the "PATH" definition. * Setting the PATH: If you want to run TeX from other directories other than "c:\emtex" directory, you need to specify the directory in the PATH section of AUTOEXEC.BAT file. You should also includes other related directories to the PATH. Here is what exactly should be added to the path c:\emtex;c:\mytex;c:\emacs;c:\emacs\ethiome; * Modifying CONFIG.SYS This system file among other things specify how many files DOS can open at the same time. At least, number of "files" and "buffers" has to be or above as shown below FILES=20 BUFFERS=20 To insure that enough environment space is available, you need also to include at the first line of this file: SHELL=command.com /E:1000/P ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ * Getting Started There are a number of ways of invoking TeX. The easy one might be to use TeXshell. TeXshell is a menu driven environment to edit, compose, view, and print TeX's documents. TeXshell is set to suit eLaTeX, but you can change this configuration yourself whenever you want. It is good to invoke TeXshell in "c:\mytex" directory since this directory serve you to organize your documents. Here is what you should: 1. Type "cd c:\mytex" 2. Type "texshell sample.tex" 3. Now you are in TeXshell environment. Press F4 4. You should be now in EthioME mode with "sample.tex". Examine the file, but don't make a change. For more information on EthioME, please retrieve "ETHIOME.TEX", compose it, and print it. It is an Amharic reference manual for EthioME (EthioMicroEmacs.) 5. When you finish looking at the "sample.tex", press F10 to exit from EthioME. By this time you are back to TeXshell environment. 6. To process "sample.tex", press F6. TeX now reads "sample.tex" and produce a final version of "sample.tex", which is "sample.dvi". This is the file used to view or print. While TeX is working on the document, it displays information on screen telling you what it is really doing. If it encounters an error, it will stop and tell where the error has occurred. 7. To view the document that TeX has produced, press F8. This will take you to a previewer. The previewer displays the first page of the document zoomed at higher level. You can reduce the zoom by pressing "-" or increase by pressing "+". For more information, compose and print VIEWER.TEX. 8. When you finish viewing the document, press "q", then you are back to TeXshell environment. 9. The final act of this process is to print the document on your printer. a. Press F9 b. Press . The driver now sends the document to the printer one page at a time until the entire document is printed. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ Abass B. Alamnehe P.O. Box 36921 Houston, TX 77236 e-mail: abassa@neosoft.com ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~