HieroTex is a TeX-package by S. Rosmorduc which allows you to type hieroglyphs in LaTeX, an advanced typesetting application. It gives a very high quality output (as pdf- or PostScript files) and has lots of options for typesetting (stacking and shading hieroglyphs, writing from left to right of from right to left, writing in columns, etc. You can also easily include transliteration, translation and grammatical rules).

However, HieroTex is officially not tested on Mac OS nor guaranteed to work. If you want to install HieroTeX on your Mac, please follow the installation instructions below.

As there are so many ways to install LaTeX on OS X, it is essential that you use the same installation method as I did, as I won’t be able to help you if you installed LaTeX in a different way! The instructions below are only tested on Mac OS X 10.5 and 10.6. However, some users have successfully installed HieroTeX on Mac OS X 10.7, using the fix explained in step 6. below. As I currently don't have a Mac OS X 10.7-system myself, I cannot provide any support for this though.

Note: for older versions of Mac OS X, you may (or may not) have more succes if you follow the manual installation instructions on my older website. Although a bit outdated, there’s still some useful information for those who have used another LaTeX-installer for Mac OS X (e.g. teTeX, Fink, ...). In those cases, (1) specifying the location where LaTeX is installed (by adapting the $TEXPATH-variable); (2) copying sesh to another directory (preferably in the same directory as pdflatex) if /usr/texbin doesn’t exist and (3) copy the web2c-file from its proper location will probably solve any problems you encounter.

  1. 1. download and install MacTeX (available for OS X 10.3–10.6). This is a rather huge download (1.6GB), but it is the most complete LaTeX-distribution for Mac OS X and the easiest way to install it.

    Note: this installation procedure has been tested with MacTeX 2007 on Mac OS X 10.5 and MacTeX 2010 on Mac OS X 10.6. I did not test other combinations, so your mileage may vary...

  2. 2. download the files HieroTeXMac.tar.bz2
    and
    HieroTypeMac.tar.bz2 and save them on your desktop.

    Note: these files include the sesh executable, which has been compiled for the PowerPC-architecture some years ago by one of my friends. This version of sesh runs on both newer (Intel) Macs as older (PowerPC) Macs. I’m not planning to recompile sesh for Intel Macs, as I don’t know anymore how we got sesh compiled in the past (it was not as easy as grabbing the sources from Rosmorduc’s site and using the default makefile).

  3. 3. open a terminal window and copy and paste the following lines:
    export TEXPATH="/usr/local/texlive/texmf-local/"
    cd ~/Desktop
    tar -xvjf HieroTeXMac.tar.bz2
    sudo mkdir -p ${TEXPATH}/doc/latex/ ${TEXPATH}/fonts/source/public/ ${TEXPATH}/tex/latex/
    sudo cp -v sesh /usr/texbin/
    sudo chmod 755 /usr/texbin/sesh
    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/
    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
    sudo texhash

  4. 4a. For Mac OS X 10.5 / MacTeX 2007 only: copy the web2c-configuration file to your desktop from a terminal window using this command:
    sudo cp /usr/local/texlive/2007/texmf-var/web2c/updmap.cfg ~/Desktop/updmap.cfg
    ...open it in TextEdit by double-clicking on it and add the next two lines at the end of this file:
    Map hierofonts.map
    Map diacrFonts.map
    ... and save the file and copy it back to its original location:
    sudo cp ~/Desktop/updmap.cfg /usr/local/texlive/2007/texmf-var/web2c/updmap.cfg

  5. 4b. For Mac OS X 10.6 / MacTeX 2010 only: create a file /usr/local/texlive/texmf-local/web2c/updmap-local.cfg which contains the next two lines:
    Map hierofonts.map
    Map diacrFonts.map

  6. 5a. For Mac OS X 10.5 / MacTeX 2007 only: run this command in a terminal window:
    sudo updmap; sudo texhash; sudo updmap-sys

  7. 5b. For Mac OS X 10.6 / MacTeX 2010 only: run this command in a terminal window:
    sudo tlmgr generate updmap; sudo updmap-sys

  8. 6. For Mac OS X 10.7 only: the sesh-executable included in the files you've downloaded in step 2 has been compiled for PowerPC only. Starting from OX S 10.7, Apple dropped support for PowerPC-binaries, so you need to replace it with a version compiled for Intel. Steven Hamblin provided me the following fix for this issue (see his blog for more details): download sesh_intel.zip, unzip it on your desktop and run this command:
    cd ~/Desktop; sudo cp sesh /usr/texbin

  9. 7. That’s all! You should have a working HieroTeX installation on your Mac now. If you’ve carefully followed the installation instructions above and still have problems running HieroTeX, you can always e-mail me and I’ll try to help you ;-)

For more information about HieroTeX, please visit HierTeX's CTAN page. You can also read more about HieroTeX and various other Mac-applications for egyptologists at my older website, which will not be updated anymore.