NRSI: Computers & Writing Systems

SIL HOME | CONTACT US

You are here: Rendering > Resources
Short URL: http://scripts.sil.org/xetex_fink

Installing XeTeX with Fink's teTeX

Clemens Heitzinger, 2005-12-03; 19892 reads

This document describes how to install XeTeX (xetex and xelatex) on Mac OS X systems that already have a working TeX installation, without using the XeTeX installer to merge the XeTeX additions directly into the main TeX system.

These notes are based on the writer's experience installing XeTeX in conjunction with Fink's teTeX, but may be a useful guide for working with other TeX setups as well. This procedure assumes familiarity with Terminal commands and Unix-level concepts such as search paths and symlinks, and with the organization of files in the TeX directory tree.

Fink's teTeX searches, by default, ~/Library/texmf, ~/.texmf-config and ~/.texmf-var. This install procedure rests on this fact.

1. Download XeTeX*.dmg and extract the pax archive in XeTeX.pkg

$ cd ~/src/XeTeX
$ zcat ~/Desktop/XeTeX/XeTeX.pkg/Contents/Archive.pax.gz | pax -r

2. Link ~/Library/texmf to the texmf.local tree

$ cd ~/Library/
$ ln -s ../src/XeTeX/share/texmf.local texmf

3. Put the binaries into your path

You set $PATH, or make a symlink. Also make a symlink from xetex to xelatex.

4. Create a fmtutil.cnf file for xetex where teTeX can find it

$ cat .texmf-config/web2c/fmtutil.cnf
xetex           xetex           -               *xetex.ini
xelatex         xetex           language.dat    *xelatex.ini

5. Create a texmf.cnf file where the xetex binary can find it, and slightly change the default teTeX one

$ cd ~/src/XeTeX/bin/powerpc-apple-darwin-current/
$ diff -u $(kpsewhich texmf.cnf) texmf.cnf
--- /sw/share/texmf/web2c/texmf.cnf     2005-10-08 12:37:52.000000000 -0500
+++ texmf.cnf   2005-12-01 16:35:45.000000000 -0500
@@ -222,7 +222,8 @@
 TEXINPUTS.pdfxtex   = .;$TEXMF/tex/{plain,generic,}//
 
 % XeTeX
-TEXINPUTS.xelatex = .;$TEXMF/tex/{latex,generic,}//
+%%TEXINPUTS.xelatex = .;$TEXMF/tex/{latex,generic,}//
+TEXINPUTS.xelatex = .;$TEXMFHOME/tex/{xelatex,generic,}//%;$TEXMF/tex/{latex,generic,}//
 TEXINPUTS.xetex   = .;$TEXMF/tex/{plain,generic,}//
 
 % Omega / Aleph

6. Get rid of hyphenation files that are not in Unicode format

(Whether this is a problem depends on the languages that are enabled in your language.dat configuration for LaTeX.)

$ cd ~/src/XeTeX/share/texmf.local/tex/generic/config
$ diff -u /sw/share/texmf-dist/tex/generic/config/language.dat language.dat
--- /sw/share/texmf-dist/tex/generic/config/language.dat        2005-01-13 09:40:02.000000000 -0500
+++ language.dat        2005-12-01 16:43:54.000000000 -0500
@@ -66,13 +66,13 @@
 irish  gahyph.tex
 italian        ithyph.tex
 latin  lahyph.tex
-magyar huhyphn.tex
+magyar huhyph.tex %% XeTeX change
 norsk  nohyphbx.tex % see http://home.c2i.net/omselberg/pub/nohyphbx_intro.htm (in Norwegian)
 polish plhyph.tex
 portuges       pt8hyph.tex
 romanian       rohyphen.tex
 russian        ruhyphen.tex    % note: edit ruhyphen.tex for your encoding!
-serbian        srhyphc.tex     % Serbian Cyrillic Hyphenation Patterns
+%%serbian      srhyphc.tex     % Serbian Cyrillic Hyphenation Patterns %% XeTeX change
 slovak skhyph.tex      % depends on csplain being installed
 slovene        sihyph23.tex
 spanish        eshyph.tex
@@ -81,7 +81,7 @@
 
 % For Ukrainian, either use ukrhyph.tex (and edit that file for the encoding
 % that you need) or use one of the ukrhyph.ENC files.
-ukrainian      ukrhyph.tex
+%% ukrainian   ukrhyph.tex %% XeTeX change
 %! ukrainian   ukrhyph.t2a
 %! ukrainian   ukrhyph.lcy
 %! ukrainian   ukrhyph.ot2

7. Build the format files

$ texhash
$ fmtutil --enablefmt xetex
$ fmtutil --enablefmt xelatex
$ fmtutil --missing

8. Tell xetex about the psfonts.map

$ cd src/XeTeX/share/texmf.local/
$ ln -s /sw/var/lib/texmf/fonts/map/dvips .

9. Finished! You should now have xetex.fmt and xelatex.fmt files in ~/.texmf-var/web2c. You test the installation by tex'ing one or two sample documents.

$ cd ~/Desktop/XeTeX/Samples
$ xetex story-zapfino.tex
$ xelatex LaTeX-font-access.ltx

---

© 2003-2012 SIL International, all rights reserved, unless otherwise noted elsewhere on this page.
Provided by SIL's Non-Roman Script Initiative. Contact us at .