ShalomScript10, ShalomStick10, ShalomOldStyle10
-----------------------------------------------
All three "Shalom" fonts have been created by Jonathan Brecher, 
of 9 Skyview Road, Lexington, MA 02173-1112 USA, 
e-mail: brecher@husc.harvard.edu (Internet)

All Shalom fonts have been  written in PostScript via Fontographer on a Mac.
The fonts have been converted to Metafont by Rama Porrat, using the
utility   typo  , a font editor + converter between font formats
(a commercial product).  ShalomScript10.mf is the Metafont
equivalent of ShalomScript.ps, ShalomStick10.mf came from ShalomStick.ps
and ShalomOldStyle10.mf originated in ShalomOldStyle.ps .

The fonts differ in the letters' style. ShalomScript10 contains
hand writing Hebrew letters; ShalomStick10 contains sans-serif letters,
and ShalomOldStyle10 contains old style letters.
All three fonts contain vowels (nikud).                       
While converting to Metafont, letters and symbols within the fonts have
been arranged so as to get a usable font for writing
Hebrew documents in TeX or LaTeX, with as well as without vowels.

Two versions are available - 7-bit and 8-bit for DOS.
In the 7-bit fonts Alef-Tav replace lower case English letters;
Alef is Ascii 96, Bet -> Tav are Ascii 97 -> 122.
The period, comma, semicolon, colon, slash, backslash, single quote, 
double quote, opening and closing brackets, and question mark are located 
in the regular Ascii locations, and can be used as usual. 

In the 8-bit DOS version, Alef is located at 128 (for PC).

How are vowels used?
--------------------
The vowels and the "dagesh" are denotes by seperate characters which
are to be typed next to the Hebrew letters they "belong" to. 
As there are various widths to different Hebrew letters, the thing is not
so simple.

The Hebrew letters in these fonts belong to one of two groups according
to their widths. The width of a letter is relevant for placing
the vowel in the right place relative to that letter; hence, 
there are groups of vowels, pertaining to different letters'
widths. However, the only difference between same vowels in different
groups is their horizontal locations compared to the letters they
go with.
The letter Resh has been assigned to group 2 although it is a wide
letter (Group 2 contains the narrower letters). The reason lies is
the fact that Resh, like Vav, takes the vowel underneath it's "leg"
(on the lower right corner) unlike other wide letters.
A third group of vowels is also supplied, where the vowels are a little
further to the right compared to vowels in groups 1 and 2. 
Those can also be used according to the user's taste.

Letters' groups:

Group 1                              Group 2 
---------------------------------------------------------
Alef, Bet, Dalet, He, Het            Gimel, Vav, Zayin, 
Tet, Kaf-Mem, Sameh - Koof,          Yod, Nun, Resh.
Shin (*), Tav.

(*) The Shin has, apart from the regular form, two other forms
which include the dot above the Shin. 
To get a Shin with dot you type \shindot, and to get a Sin
you type \sin.

If you use TeX--XeT (explanations below) in a right-to-left surroundings, 
you type the vowel BEFORE the "voweled" letter. 
In the following discussion I will assume that you use this method, and 
I will present the examples accordingly.
If you use the regular left-to-right TeX, you type the vowel AFTER the 
letter.

Vowels for group 1 letters
--------------------------
For Group 1 letters, vowels which come under the letters are denoted by
digits (Alas, ShalomScript10 has no numerals. To write digits, I use
math mode, e.g. $1992$). 
For example, to type a Kamats under a ("a" stands for Bet in this
context) you type    6a  .
Here is the list of vowels for Group1 letters:

0 Hirik
1 Tsere
2 Segol
3 Shva
4 Kubuts
5 Patah
6 Kamats
7 Hataf Segol
8 Hataf Patah
9 Hataf Kamats

However, note the following special cases:
U   Shva for Kaf Sofit
V   Kamats for Kaf Sofit
W   Dagesh (for all Group1 letters)


Vowels for group 2 letters
--------------------------
For Group2 letters, vowels which come under the letters are denoted by
uppercase English letters. For example, to type a Kamats under b 
("b" stands for Gimel in this context) you type    Gb  .
Here is the list of vowels for Group2 letters:

A Hirik
B Tsere
C Segol
D Shva
E Kubuts
F Patah
G Kamats
H Hataf Segol
I Hataf Patah
J Hataf Kamats

X   Dagesh (for all Group2 letters except Yod)
Y   Dagesh for Yod


Additional vowels, moved a little to the right
----------------------------------------------
Those are additional vowels, denoted by other uppercase English letters. 
Use them if you prefer vowels which are shifted a little bit further
to the right as compared to the letter above them.
For example, to type a Kamats under y ("y" stands for Shin in this 
context) you type    Qy  .
Here is the list:

K Hirik
L Tsere
M Segol
N Shva
O Kubuts
P Patah
Q Kamats
R Hataf Segol
S Hataf Patah
T Hataf Kamats


Additions pertaining to all letters
-----------------------------------
Other vowels and symbols are available as follows:

=                    Holam Haser
>                    Holam Maleh
<                    Shuruk      
Z  or \lowquotes     Lower double quotes
[  or \revcomma      A reversed comma
@                    Elipsis, like  ...

There are more symbols which can be achieved by typing the following 
macro names:

\shindot       Shin with an upper right dot
\sin           Shin with an upper left dot
\alefpatah     Alef with Patah
\alefkamats    Alef with Kamats
\vavvav        Two Vavs
\vavyod        A Vav followed by Yod
\yodhirik      Yod with Hirik
\yodyod        Two Yods
\yodyodpatah   Two Yods + Patah
\highbar       High connecting bar
\overbar       Overbar
\dash          A regular "English" dash
\bigdash
\biggerdash
   

The macros (=keywords) mentioned above (e.g. \lowquote,
 \alefpatah etc.) are very simple, and are listed below.
You have to include them in your text if you are going to utilize then.

Macros to be included in your text, to be used later
----------------------------------------------------
\chardef\lowquotes=90
\chardef\revcomma=91
\chardef\alefpatah=16
\chardef\alefkamats=17
\chardef\vavvav=18
\chardef\vavyod=19
\chardef\yodhirik=20
\chardef\yodyod=21
\chardef\yodyodpatah=22
\chardef\highbar=25
\chardef\overbar=26
\chardef\bigdash=27
\chardef\biggerdash=28
\chardef\shindot=23
\chardef\sin=24
\def\dash{\rm -}


What is TeX--XeT and where can you get it?
------------------------------------------
TeX--XeT is the regular TeX program with an addition of the possibility
to write from right to left as well as from left to right.
There are currently two versions available: one for Unix, the other for
DOS PC.
Information, installation procedures and relevant data are located
at the anonymous ftp site   noa.huji.ac.il  [132.64.254.10]
in  tex/unix_tex--xet     for Unix      and
in  tex/pc_tex--xet  
     or tex/texshell      for PC.
Read the readme file in each directory.

The noa archive is in a constant modification process, as this whole
Hebrew TeX is new and developing. The Shalom fonts are a very nice
contribution and addition to it.
I would be glad to give more information on the subject.

Examples of using ShalomScript10
--------------------------------
The following examples pertain to usage of 7-bit fonts.
Lower case English characters stand for the Hebrew characters.
It is not possible to include here the DOS Hebrew characters.

1. Example using TeX--XeT.

%%% Macros to be inputted - here they are part of the inputfile itself.
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
\chardef\lowquotes=90
\chardef\revcomma=91
\chardef\alefpatah=16
\chardef\alefkamats=17
\chardef\vavvav=18
\chardef\vavyod=19
\chardef\yodhirik=20
\chardef\yodyod=21
\chardef\yodyodpatah=22
\chardef\highbar=25
\chardef\overbar=26
\chardef\bigdash=27
\chardef\biggerdash=28
\chardef\shindot=23
\chardef\sin=24
\def\dash{\rm -}
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
\input heb_macros
\sethebrew

\font\hebrew=ShalomScript10
\hebrew
Gx6nd Wt>Gxz, Dxg>a 5d0n3z5p8g0lim 5Wa6dx $9$, Dix<6y5lAim.
\medskip
6yl>m~!
\bigskip \bigskip

0y1y2y3y4y5y6y7y8y9y
Ki Li Mi Ni Oi Pi Qi Ri Si Ti 
                                         
Ax Bx Cx Dx Ex Fx Gx Hx Ix Jx 
0\shindot 1\shindot 2\shindot 3\shindot 4\shindot 5\shindot 6\shindot 7\shindot 8\shindot 9\shindot 
\vskip 2cm
\font\hebrew=ShalomScript10 scaled \magstep2
\hebrew
Gx6nd Wt>Gxz, Dxg>a 5d0n3z5p8g0lim 5Wa6dx $9$, Dix<6y5lAim.
\medskip
6yl>m~!
\bigskip \bigskip
0y1y2y3y4y5y6y7y8y9y
Ki Li Mi Ni Oi Pi Qi Ri Si Ti 
                                   
Ax Bx Cx Dx Ex Fx Gx Hx Ix Jx 
0\shindot 1\shindot 2\shindot 3\shindot 4\shindot 5\shindot 6\shindot 7\shindot 8\shindot 9\shindot 
\end

2. Example using regular TeX.

%%% Macros to be inputted - here they are part of the inputfile itself.
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
\chardef\lowquotes=90
\chardef\revcomma=91
\chardef\alefpatah=16
\chardef\alefkamats=17
\chardef\vavvav=18
\chardef\vavyod=19
\chardef\yodhirik=20
\chardef\yodyod=21
\chardef\yodyodpatah=22
\chardef\highbar=25
\chardef\overbar=26
\chardef\bigdash=27
\chardef\biggerdash=28
\chardef\shindot=23
\chardef\sin=24
\def\dash{\rm -}
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
\font\hebrew=ShalomScript10
\hebrew

\hfill .miAl6y<xiN ,$9$ xd6aW5 mil0g8p5z3n0d5 a>gxD ,zxG>tW
dn6xG
\bigskip
\hfill !! hpD>t ly2 it0>i df2

! m>l\shindot 6

y1y2y3y4y5y6y7y8y9y0
iK iL iM  iN iO iP iQ iR iS iT 
                                         
 xA xB xC xD xE xF xG xH xI xJ
  \shindot1 \shindot2 \shindot3 \shindot4 \shindot5 \shindot6 \shindot7 \shindot 8 \shindot9 \shindot0

\font\hebrew=ShalomScript10 scaled \magstep2
\hebrew
\hfill .miAl6y<xiN ,$9$ xd6aW5 mil0g8p5z3n0d5 a>gxD ,zxG>tW
dn6xG
\bigskip
\hfill !! hpD>t ly2 it0>i df2

! m>l\shindot 6

y1y2y3y4y5y6y7y8y9y0
iK iL iM  iN iO iP iQ iR iS iT 
                                         
 xA xB xC xD xE xF xG xH xI xJ
  \shindot1 \shindot2 \shindot3 \shindot4 \shindot5 \shindot6 \shindot7 \shindot 8 \shindot9 \shindot0

\end
------------------------------------------------------------------
Rama Porrat -- rama@noa.huji.ac.il -- The Hebrew University of Jerusalem.
