How to install HieroTex on Mac
OS X (manual installation instructions)
This
page is seriously outdated. If you're looking for an easy way to
install HieroTeX on Mac OS X 10.3-10.5, please check out my new webpage with updated
installation instructions.
Update
23/02/2007:
my older installation instructions apparently don't work with Mac OS X
10.4. If you're using this version, try the following steps to install
HieroTeX (this includes the installation of HieroType):
- extract the files
HieroTexMac.tar.bz2, HieroTypeMac.tar.bz2 and htx2tex.bz2 from the
installer application, save them on your desktop and navigate to the
Desktop-directory in the terminal (cd
~/Desktop): see steps 1 and 2 of the older installation
instructions below for more information.
- enter one of these commands
in a terminal window, depending on which method you used to install
LaTeX:
if you used Fink to install teTeX:
export
TEXPATH="/sw/share/texmf"
if you used TeXShop/TeXLive-teTeX:
export TEXPATH="/usr/local/teTeX/share/texmf.tetex"
- then enter the following
commands in a terminal window: tar -xvjf HieroTexMac.tar.bz2
sudo mkdir -p ${TEXPATH}/doc/latex/ ${TEXPATH}/fonts/source/public/ ${TEXPATH}/tex/latex/ sudo cp -v sesh /sw/bin sudo cp -Rv
texmf/doc/latex/hierotex ${TEXPATH}/doc/latex/ sudo cp -Rv
texmf/fonts/source/public/hierotex ${TEXPATH}/fonts/source/public/ sudo cp -Rv
texmf/tex/latex/hierotex ${TEXPATH}/tex/latex/ sudo texhash
- now for installing
HieroType...: tar -xvjf
HieroTypeMac.tar.bz2 sudo mkdir -p ${TEXPATH}/fonts/map/dvips/hierotex/ ${TEXPATH}/fonts/afm/hierotex
${TEXPATH}/fonts/tfm/hierotex ${TEXPATH}/fonts/type1/hierotex cd texmf/dvips sudo cp -v diacrFonts.map
hierofonts.map ${TEXPATH}/fonts/map/dvips/hierotex/ cd ../fonts/type1 sudo cp *.afm
${TEXPATH}/fonts/afm/hierotex sudo cp *.tfm
${TEXPATH}/fonts/tfm/hierotex sudo cp *.*
${TEXPATH}/fonts/type1/hierotex
- edit the font configuration file, which you can find at/sw/share/texmf-dist/web2c/updmap.cfg (if
you used Fink to install LaTeX) or at /usr/local/teTeX/share/texmf.local/web2c/updmap.cfg
(if you used TeXShop/TeXLive-teTeX) and add these twolines: Map hierofonts.map Map diacrFonts.map
you can use emacs to
edit this file, which can be started by typing sudo emacs
/usr/local/teTeX/share/texmf.local/web2c/updmap.cfg in a
terminal window (Fink-users have to entersudo
emacs /sw/share/texmf-dist/web2c/updmap.cfg
of course). If you're done editing, you can save the file and quit
emacs by hitting ctrl-x ctrl-c.
- then finally run
this command: sudo texhash; sudo
updmap-sys
This should give you a working
HieroTeX installation on your Mac. Thanks
to Markus Kuschnik for helping me refining this installation
instructions to work with TeXShop and Mac OS X 10.4.
If you would like to use
HieroTeX as explained on the page 'How
to use HieroTeX on Mac OS X', you will need to install
htx2tex too, see the bottom of this page for more instructions.
For instructions about testing
the application please go back to the previous
page…
Now, after installing the
Tex-system, we can finally install the HieroTex package. You can either
choose to use the installer-application
I’ve written (recommended), or to follow the instructions for
a
manual install (only recommended if the installer fails), which are
discussed below.
First get the file HieroTexMac.tar.bz2. This is a
specially adapted version (for Mac OS X) of the files you can find on S. Rosmorducs
website, so they will run without problems. Anyway, don’t use
the
one you find on his website. They are not written for OS X and
won’t compile properly! This file is a part of the installer
application. Download the installer,
but do not run it. Instead, right-click on it, choose ‘Show
Package Contents’ and navigate to the folder
‘Contents/Resources/’. There you’ll find
the bzipped
tar-files you’ll need.
For your convenience, place this file on your
Desktop—it will be removed later (screenshot
4).
The file HieroTypeMac.tar.bz2 will be used in the following step of
this installation guide, so you don’t need it now yet.
Type
the following commands in a terminal window (screenshot
5),
hitting return after each line (you can also copy and paste them one by
one to ensure you won’t make a typing error. Don’t
try to
understand what you’re doing here, trust me
that it’ll
work).
To speed things up, you can also copy and paste the complete paragraph
of commands here, but then you first have to ensure you’re
running bash (which has become the standard shell from OS X 10.3, if
you use an older version of OS X or if have done an upgrade to OS X
10.3, you’ll probably use tcsh). If every line in your
terminal
(usually something like ‘[10-0-28-24:~] anoebis%’)
ends
with a ‘%’, you‘re running tcsh. So type
‘bash’ into your terminal, which will give you
something
like ‘10-0-28-24:~ anoebis$’. If every line thus
ends with
a ‘$’-sign, you can just copy and paste the next 7
lines in
one go: TEXPATH="/sw/share/texmf"
# if you use
teTex installed by Fink, use "/usr/local/teTeX/share/texmf.tetex" if
you installed Latex using TeXShop/TeXLive-teTeX) cd /sw ||
sudo mkdir /sw
cd /sw/bin || sudo mkdir /sw/bin
cd ~/Desktop
tar -xvjf HieroTexMac.tar.bz2
sudo cp -v sesh /sw/bin/
sudo cp -Rnv texmf/doc/latex/hierotex ${TEXPATH}/doc/latex/
sudo cp -Rnv texmf/fonts/source/public/hierotex
${TEXPATH}/fonts/source/public/
sudo cp -Rnv texmf/tex/latex/hierotex ${TEXPATH}/tex/latex/
sudo texhash
rm -Rv sesh texmf/
Now you can delete all the installation files and
folders on your Desktop, because they’ve all been copied.
Installing the high-resolution
Postscript fonts (older manual installation instructions)
This is how you have to install
the PostScript fonts manually:
First download HieroTypeMac.tar.bz2. This file is a
part of
the installer application. Download the installer, but do not run it.
Instead, right-click on it, choose ‘Show Package
Contents’
and navigate to the folder ‘Contents/Resources/’.
There
you’ll find the bzipped tar-files you’ll need.
For your convenience, place this file on your
Desktop—it will be removed later.
During installation, two configuration files will be
overwritten: config.ps and pdftex.cfg. If you have made changes to
them, you can make a backup of these files and compare them afterwards
with the newly creared files to add your changes again (note that you
do have to included the dot at the end of the two cp-lines: it
represents the current directory where the files will be copied to): TEXPATH="/sw/share/texmf"
# if you use
teTex installed by Fink, use "/usr/local/teTeX/share/texmf.tetex" if
you installed Latex using TeXShop/TeXLive-teTeX)
cp ${TEXPATH}/pdftex/config/pdftex.cfg .
cp ${TEXPATH}/dvips/config/config.ps .
Then run the following commands in a terminal window: TEXPATH="/sw/share/texmf"
# if you use
teTex installed by Fink, use "/usr/local/teTeX/share/texmf.tetex" if
you installed Latex using TeXShop/TeXLive-teTeX)
cd ~/Desktop
tar -xvjf HieroTypeMac.tar.bz2
cd texmf/fonts/type1
sudo mkdir ${TEXPATH}/fonts/afm/hierotex ${TEXPATH}/fonts/tfm/hierotex
${TEXPATH}/fonts/type1/hierotex
sudo cp *.afm ${TEXPATH}/fonts/afm/hierotex
sudo cp *.tfm ${TEXPATH}/fonts/tfm/hierotex
sudo cp *.* /${TEXPATH}/fonts/type1/hierotex
cd ../../dvips
sudo cp config.ps diacrFonts.map hierofonts.map ${TEXPATH}/dvips/config/
cd ../pdftex/config
sudo cp pdftex.cfg ${TEXPATH}/pdftex/config/
sudo texhash
Now you can delete all the installation files and
folders on your Desktop, because they’ve all been copied.
For
instructions about testing the application please go back to the previous
page…
This is how you have to install
the shell script htx2tex:
First download htx2tex. This file is a part of the
installer application. Download the installer, but do not run it.
Instead, right-click on it, choose ‘Show Package
Contents’
and navigate to the folder ‘Contents/Resources/’.
There
you’ll find the bzipped tar-files you’ll need.
For your
convenience, place this file on your Desktop—it will be
removed later.
Then run the following commands in a terminal window: cd ~/Desktop
bunzip2 htx2tex.bz2
sudo mv htx2tex /sw/bin/
Now you can delete the bzipped file, because the
script has been copied.
ìf things still
don’t work as they should do, please go to the troubleshooting page: your
problem might be listed there and can probably easily be solved.
Uninstalling the packages
(manual installation instructions)
If you ever want to uninstall
the different
packages (HieroTex, HieroType, htx2tex), and the installer
doesn’t work (or you no want to download it again just to
delete
some file), it can be done this way:
HieroTex: export
TEXPATH="/sw/share/texmf" # if you use
teTex installed by Fink, use "/usr/local/teTeX/share/texmf.tetex" if
you installed Latex using TeXShop/TeXLive-teTeX) sudo rm -f /sw/bin/sesh
cd $TEXPATH
sudo rm -rf doc/latex/hierotex/ tex/latex/HieroTex/
fonts/source/public/HieroTex/
sudo texhash
HieroType: export
TEXPATH="/sw/share/texmf" # if you use
teTex installed by Fink, use "/usr/local/teTeX/share/texmf.tetex" if
you installed Latex using TeXShop/TeXLive-teTeX) cd ${TEXPATH}/fonts
sudo rm -rf afm/hierotex/ tfm/hierotex/ type1/hierotex/
sudo texhash
Installing HieroTex (older
manual installation instructions)
Type
the following commands in a terminal window