summaryrefslogtreecommitdiff
path: root/language/ethiopia/ethtex/readme.eth
blob: 0a36c9277903e4e1fdb1295a8163e77b49c555d4 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290

~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
README.ETH                  V. 1.0                              January, 1994
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

* Introduction
  
  The EthTeX Package is a bundle of many people's work--TeX by Donald Knuth,
  emTeX ported to personal computer by Eberhard Mattes, LaTeX by Laslie
  Lamport, and many more.

  In addition to standard features of TeX, the package provides suitable 
  environment for the Ethiopian Script users.  More than anything else, the
  purpose of the package is to open up the world of TeX to the users who until
  now lack the means to produce beautiful books or documents with Ethiopian
  Script beyond a word processor's scope.  

  Books, the users may want to explore are:
  
  [1] The TeXbook;  Donald Knuth

      A principal guide for TeX typesetting system.

  [2] LaTeX: A Document Preparation System;  Laslie Lamport

      A guide for producing books, reports, articles, letters, and so on.

  [3] The METAFONTbook; Donald Knuth

      A reference manual for designing font with a METAFONT system.    
  
  [4] Mestahafe eLaTeX (written in Amharic); Abass Alamnehe

      An Amharic guide for producing books, reports, articles, letters, 
      and so on with Ethiopian script in eLaTeX.  

  


  ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
* 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; and also 
  it is available from TeX User Group office.


* 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.
  eLaTeX--a modified version of LaTeX featuring Amharic commands
  Ethiopian fonts
  TeXshell
  MicroEMACS that includes EthioME for Ethiopic editing.
  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)

*  The EthTeX Package on floppy diskettes: There are ten minimum high density
   diskettes labeled as shown below.

   1. emTeX DISK 1 of 8
   2. emTeX DISK 2 of 8
   3. emTeX DISK 3 of 8
   4. emTeX DISK 4 of 8
   5. emTeX DISK 5 of 8
   6. emTeX DISK 6 of 8
   7. eLaTeX DISK 7 of 8
   8. EthioME DISK 8 of 8
   9. TeXfonts  DISK 1 of 2      (for a single specified printer)
  10. TeXfonts  DISK 2 of 2


*  Optional

   An Amharic Guide for eLaTeX document preparation Guide for sale.



  ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
*  Distribution

   The package is available from three sources:
 
   1.  Archive site in which the system can be retrieved using a ftp services.
       The sites includes:

       ftp.shsu.edu     [192.92.115.10]   tex-archive/languages/ethiopia/ethtex
       ftp.tex.ac.uk    [134.151.44.19]   tex-archive/languages/ethiopia/ethtex
       ftp.dante.de     [128.69.1.12]     tex-archive/languages/ethiopia/ethtex

   2.  It can be ordered directly from TUG (TeX Users Group) office. For more
       information write or call the office.

       TeX Users Group
       P.O. Box 869
       Santa Barbara, CA 93102 USA
       Phone:  +1 (805)963-1338
       FAX:    +1 (805)963-8358
       email:  tug@tug.org

    3. It can be obtained directly from me also. For more information write 
       or call to:

       EthiO Systems 
       P.O. Box 36921
       Houston, TX 77236
       Phone: +1 (713)995-4360
       email: abassa@neosoft.com


  ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
* 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 DISK 1 of 8" into the floppy disk
        drive.

     3. While you are on floppy disk drive type "install" and press
        <enter>.  For example,

                 A:\>install <enter>

        then follow the program instruction until it tells you that the
        installation is complete.  Incase, if you want to quit installing
        just press <Esc>, 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 <enter>.

           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
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~