Re: LuaTeX on Mac OS X

["Thomas A. Schmitz" <thomas.schmitz@uni-bonn.de>]

On Oct 1, 2007, at 11:31 PM, Otared Kavian wrote:

> Dear Dalyoung,
>
> Like many other ConTeXt users I followed up the many threads about
> how to install, successfully, LuaTeX.
> In particular I was interested in your experience since I had more or
> less the same problems as the ones you described in your latest
> messages on the list.
> Now my question is: did you succeed to install and use LuaTeX on Mac
> OS X?
> 	--- If yes, could you please describe how you did proceed?
> 	--- If no, this means we have to wait more for our salvation...
>
> Thanks for your attention and best regards: OK
>
>
OK, I have just summarized my own experience with luatex. Please  
comment; if this is helpful at all, we should put it on the wiki.

Thomas

Setting up luatex on OS X

The following remarks are not more than an amplification of what Hans  
writes in
magazin #12. However, since some users have had difficulties, here's  
a short
summary of the steps that I have followed on my system (OS X 10.4;  
system
language set to English; vanilla TeXLive installation) to work with  
luatex.

1. Get the latest ConTeXt version.

Download the latest cont-tmf.zip at
www.pragma-ade.com (either stable or beta). Unzip this file in a  
texmf-tree. It
is recommended that you do this in a local tree. This way, if you  
ever have
problems, you can just delete this local tree and continue working  
with the
stable tree that came with your distribution. If you don't know where  
your
local texmf tree is located, follow these directions (a line with #  
in front
means you should type the line following this # into your Terminal  
window;
press "Return" at the end of the line. Comments or explanations which  
should
not be retyped are included in <> brackets. Please be careful to retype
exactly, leaving all the quotes etc. in place!).

# kpsewhich --expand-var '$TEXMFLOCAL'

On my system, this expands to
/usr/local/texlive/texmf-local

Now go to this directory

# cd /usr/local/texlive/texmf-local

download the file cont-tmf.zip to this directory and unzip it. On  
most systems,
you will need superuser rights to do this; after entering the sudo  
command, you
will be asked for your password.

# sudo unzip cont-tmf.zip
Password:
# <type your password, then RETURN>
Archive:  cont-tmf.zip
replace bibtex/bst/context/cont-ab.bst? [y]es, [n]o, [A]ll, [N]one,  
[r]ename:
# <type A> <then type RETURN>

After this, a long list of files will scroll by.

2. Regenerate the formats

While we're at it, we might as well regenerate the formats for pdftex- 
based
ConTeXT:

# sudo texmfstart texexec --make --all --pdftex

You'll see the output on the Terminal; at the end, texexec should  
tell you that
it has regenerated all the formats.
TeXExec |
TeXExec | tex engine path: /usr/local/texlive/2007/texmf-config/web2c/ 
pdftex
TeXExec | mps engine path: /usr/local/texlive/2007/texmf-config/web2c
TeXExec |
TeXExec | tex: 02/10/2007 17:50:43 > /usr/local/texlive/2007/texmf- 
config/web2c/pdftex/cont-en.fmt (7392414)
TeXExec | tex: 02/10/2007 17:50:57 > /usr/local/texlive/2007/texmf- 
config/web2c/pdftex/cont-nl.fmt (7473512)
TeXExec | tex: 02/10/2007 17:50:57 > /usr/local/texlive/2007/texmf- 
config/web2c/pdftex/mptopdf.fmt (277947)
TeXExec | mps: 02/10/2007 17:50:58 > /usr/local/texlive/2007/texmf- 
config/web2c/metafun.mem (482192)
TeXExec |
TeXExec | runtime: 7.575246

3. Set environment variables

In its current beta stadium, luatex needs some environment variables  
to be set;
this will probably change soon. In my experiments, on OS X, it needs  
these
four variables:

TEXMFCACHE: this decides where the luatex-cache directory will be  
created. If
you set this variable to a temporary directory such as /tmp, it will  
be deleted
at every reboot. This is a good idea since luatex caches lots of  
files and
paths in this directory, so it makes sense to refresh this directory  
often.

TEXMFCNF: This should point to the directory where the file texmf.cnf  
which
your TeX installation uses is located. In order to find out where  
this is, run
this command:

#kpsewhich texmf.cnf

On my system, this points to
/usr/local/texlive/2007/texmf/web2c/texmf.cnf
so we need to set TEXMFCNF to /usr/local/texlive/2007/texmf/web2c.

TEXMF
This should list ALL texmf trees which your TeX installation uses. In  
order to
know what these trees are, run this command:

# kpsewhich --expand-var '$TEXMF'

The output of this command on my system is:

{/Users/tas/.texlive2007/texmf-config,/Users/tas/.texlive2007/texmf- 
var,/Users/tas/texmf,!!/usr/local/texlive/2007/texmf-config,!!/usr/ 
local/texlive/2007/texmf-var,!!/usr/local/texlive/2007/texmf,!!/usr/ 
local/texlive/2007/../texmf-local,!!/usr/local/texlive/2007/texmf- 
dist,!!/usr/local/texlive/2007/texmf.gwtex}

In this form, the list contains a few shortcuts and symbols which are  
special
to kpsewhich. Remove all the exclamation marks; if there are other  
shortcuts in
your output, bring it into a flat list of Unix directories.

LUAINPUTS

These are the directories where the lua scripts are located, they are  
on my
system:

{/usr/local/texlive/texmf-local/tex/context/base,/usr/local/texlive/ 
texmf-local/scripts/context/lua,/Users/tas/texmf/scripts/context/lua}

Since these variables will have to be set every time you run luaTeX,  
it makes
sense to automate the process. So we collect all the definitions like  
so (these
are the values on my system; adapt to your setup!):

export TEXMFCACHE="/tmp"
export TEXMFCNF="/usr/local/texlive/2007/texmf/web2c"
export TEXMF="{/Users/tas/.texlive2007/texmf-config,/Users/ 
tas/.texlive2007/texmf-var,/Users/tas/texmf,/usr/local/texlive/2007/ 
texmf-config,/usr/local/texlive/2007/texmf-var,/usr/local/texlive/ 
2007/texmf,/usr/local/texlive/texmf-local,/usr/local/texlive/2007/ 
texmf-dist,/usr/local/texlive/2007/texmf.gwtex}"
export LUAINPUTS="{/usr/local/texlive/texmf-local/tex/context/base,/ 
usr/local/texlive/texmf-local/scripts/context/lua,/Users/tas/texmf/ 
scripts/context/lua}"

There are two ways you can set these variables easily:

a. put them in a file; let's call this file .luatex. Every time you  
want to run
luatex, just say

# source .luatex

in your terminal.

b. If you want these variables to be set every time you log into your  
computer,
put them in a file .bashrc in your home directory (this only works if  
your
shell is bash, the default shell in OS X 10.4 and 10.3. If you have  
never
tinkered with the shell, it probably is).

Let's test if setting the variables has worked:

# echo $TEXMF

the output on my system is:

{/Users/tas/.texlive2007/texmf-config,/Users/tas/.texlive2007/texmf- 
var,/Users/tas/texmf,/usr/local/texlive/2007/texmf-config,/usr/local/ 
texlive/2007/texmf-var,/usr/local/texlive/2007/texmf,/usr/local/ 
texlive/texmf-local,/usr/local/texlive/2007/texmf-dist,/usr/local/ 
texlive/2007/texmf.gwtex}

4. Installing the binaries.

We now have to install and tweak the necessary binaries. First, of  
course,
luatex itself. We put it in the same directory with all the other TeX  
binaries.
To determine where that is, we issue

# which pdftex

/usr/local/texlive/2007/bin/i386-darwin/pdftex

So we get the latest luatex from www.luatex.org and copy it to this  
directory.
We also create two links to luatex:

# cd /usr/local/texlive/2007/bin/i386-darwin/pdftex
# sudo ln -s luatex texlua
# sudo ln -s luatex texluac

There are two more lua scripts which need to be installed.  
Unfortunately, Hans
uses a different operating system, so we need to make them executable  
first. Go
to the directory where you installed your ConTeXt update, so in my case:

# cd /usr/local/texlive/texmf-local/scripts/context/lua/
# sudo chmod 755 mtxrun.lua
# sudo chmod 755 luatools.lua

After that, we create symbolic links to these programs in the  
directory where
we installed luatex:
# cd /usr/local/texlive/2007/bin/i386-darwin/pdftex
# sudo ln -s /usr/local/texlive/texmf-local/scripts/context/lua/ 
luatools.lua luatools
# sudo ln -s /usr/local/texlive/texmf-local/scripts/context/lua/ 
mtxrun.lua mtxrun

Again, let's test if this has worked:
# rehash
# which luatools
/usr/local/texlive/2007/bin/i386-darwin/luatools

5. Generating the Database and the formats

You're almost there! Now let luatools generate its internal database:
# luatools --generate

Again, a long list of stuff will scroll by (if luatools gives just a  
fewlines
of output, you know that you've made a mistake somewhere along the  
way). Here's
the beginning and end on my system:

LuaTools | loading /usr/local/texlive/2007/texmf/web2c/texmf.cnf
LuaTools | preparing configuration in /tmp/luatex-cache/context/ 
6da32d2ec193ac6d2428d020ce069374/trees/ 
6da32d2ec193ac6d2428d020ce069374.tma
LuaTools | saving configuration in /tmp/luatex-cache/context/ 
6da32d2ec193ac6d2428d020ce069374/trees/ 
6da32d2ec193ac6d2428d020ce069374.tma

[snip]

LuaTools | saving files in /tmp/luatex-cache/context/ 
6da32d2ec193ac6d2428d020ce069374/trees/ 
729867c88f88a392262749cb9c3d602b.tma
LuaTools | compiling files to /tmp/luatex-cache/context/ 
6da32d2ec193ac6d2428d020ce069374/trees/ 
729867c88f88a392262749cb9c3d602b.tmc
LuaTools |
LuaTools | runtime: 9.74 seconds

We test if luatex is able to find files:

# luatools cont-new.tex
/usr/local/texlive/texmf-local/tex/context/base/cont-new.tex

Then, we generate the formats for luatex:

luatools --ini --verbose --compile cont-en

Again, many lines of output, among those the confirmation that the  
formats have
been built and installed:

LuaTools | creating initialization file cont-en
LuaTools | using library path : /usr/local/texlive/texmf-local/tex/ 
context/base
LuaTools | using lua libraries: l-string.lua l-table.lua l- 
boolean.lua l-number.lua l-unicode.lua l-md5.lua l-os.lua l-io.lua l- 
file.lua l-dir.lua l-utils.lua l-tex.lua luat-lib.lua luat-inp.lua  
luat-tmp.lua luat-zip.lua luat-tex.lua
LuaTools | using compiled initialization file cont-en.luc
LuaTools | using lua initialization file cont-en.luc
LuaTools | running command: luatex --ini --lua="cont-en.luc" "/usr/ 
local/texlive/texmf-local/tex/context/base/cont-en.tex" \dump
This is luaTeX, Version 3.141592-beta-0.11.2-2007091918 (Web2C 7.5.6)  
(INITEX)

[snip]

ConTeXt  ver: 2007.09.28 16:52 MKIV  fmt: 2007.10.2  int: english/ 
english

lua : used config path - /usr/local/texlive/2007/texmf/web2c
lua : used cache path - /tmp/luatex-cache/context/ 
6da32d2ec193ac6d2428d020ce069374
  )
Beginning to dump on file cont-en.fmt
  (format=cont-en 2007.10.2)

And that's it! Now you can create your first test file and typeset it  
with
luatex:

texmfstart texexec --luatex test.tex
___________________________________________________________________________________
If your question is of interest to others as well, please add an entry to the Wiki!

maillist : ntg-context@ntg.nl / http://www.ntg.nl/mailman/listinfo/ntg-context
webpage  : http://www.pragma-ade.nl / http://tex.aanhet.net
archive  : https://foundry.supelec.fr/projects/contextrev/
wiki     : http://contextgarden.net
___________________________________________________________________________________