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.

If you’ve not yet installed Latex already on your Mac, please read the first part of the installation guide first…

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 enter sudo 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…

Screenshot 4: the two HieroTex-files on the DesktopInstalling HieroTex (older manual installation instructions)

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.

  1. 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.
  2. 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:

    1. 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.
    2. For your convenience, place this file on your Desktop—it will be removed later.
    3. 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 .
    4. 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
    5. 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…

    Installing htx2tex (manual installation instructions)

    This is how you have to install the shell script htx2tex:

    1. 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.
    2. For your convenience, place this file on your Desktop—it will be removed later.
    3. Then run the following commands in a terminal window:
      cd ~/Desktop
      bunzip2 htx2tex.bz2
      sudo mv htx2tex /sw/bin/
    4. Now you can delete the bzipped file, because the script has been copied.


    For instructions about how to use the script, read on to part two (How to use HieroTex on Mac OS X)…

    ì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:

    1. 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
    2. 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
    3. htx2tex:
      sudo rm -f /sw/bin/htx2tex

    ©2006 F. Vervloesem.


    The author of this page claims no rights on the HieroTex-package, which is © S. Rosmorduc.
    Please go to his website for any further information on HieroTex.

    HomeHieroglyphic typesettingHieroglyphic databasesOther hieroglyphic applications
    Typesetting Arabic and CopticOther useful Egyptological applications