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

Using XeTeX with iTeXMac

Jonathan Kew, 2004-05-22; 16151 reads

In order to use iTeXMac with XeTeX, there are two main tasks to undertake: configuring the editor to work with Unicode (UTF-8) files, and setting up a project that uses XeTeX as the typesetting engine.

My thanks to Adam Maxwell for these notes on configuring iTeXMac to work with XeTeX. As I have taken the liberty of making minor edits to his notes, he should not be held responsible for any errors!

Customizing the File Encoding Menus

See File Encoding in the iTeXMac online help for details of general considerations about the file encoding.

You can customize the file encoding menu displayed by iTeXMac by providing a resource file located in your home directory at ~/Library/Application Support/iTeXMac/General/Encodings.plist.

This file is created or edited using the iTeXMac(Encoding) editor, which can be launched by choosing the menu item Format/String Encodings/Customize….

If the file does not exist, create a new file by choosing File/New in the Encoding editor, and then add encodings by dragging them from the column on the left to the column on the right. When you have finished customizing the menu, choose File/Save As… and save the file to the location specified above.

If the Encodings.plist file already exists, you will have a menu option Encoding Menu/User Domain: Edit which will open your personal encoding menu for customization:

Customizing the encoding list with the iTeXMac(Encoding) editor

When you are finished editing, quit the iTeXMac(Encoding) editor and your new encoding list will appear in iTeXMac under Format/String Encodings/Current.

If you do not see the expected item in the encoding menus (Mac OS Roman instead), either you have misspelled the declaration, or the encoding is not available in your system implementation.

Defining a Project

To use XeTeX, you can define a new Generic Project in iTeXMac which can be used to call XeTeX (or XeLaTeX) on any file that you choose.

A Generic Project in iTeXMac parlance is a rootless project, i.e. it has no particular .tex file associated with it. A project defines commands that can be bound to the compile (C), typeset (T), bibliography (B), and makeindex (I) buttons on the iTeXMac text editor, as well as the macro sets which will be accessible from the editor menus. To access the settings for each of these, use the buttons along the bottom of the iTeXMac project window.

To create such a project, go to File/New, and make a "Project" document called XeTeX.pTeXMac. It should then be saved in ~/Library/Application Support/iTeXMac/Generic projects, and it will show up in iTeXMac's TeX/Activate Project and TeX/Show Project menus.

Click the "File" button at the bottom of your new project window, and check the "Generic Project" checkbox (this is where you could associate the project with a particular file).

Creating a Generic Project in iTeXMac

Click the "Compile" button at the bottom of your new project window, and enter

xetex ${iTMInput}

and press Return to validate the command. Save the project.

Specifying xetex in the iTeXMac Compile script

Further, you can bind a typeset command to the "T" button, which might run your compile command twice, and perhaps runs bibtex, makeindex, etc. I generally make a rooted project that I associate with a particular article that I'm working on, and put specific commands for that paper in my typeset script (I use the nomencl package, which requires a makeindex command that I can never remember), using Bourne shell syntax. An example is shown in this figure:

Setting up a custom Typeset script in an iTeXMac project

One further note: you also must set the Macros up properly, or else you won't see them in the editor. Presently, the only macro sets supplied are for LaTeX, so make sure that your Macros view looks like this:

Specifying the Macros for an iTeXMac project

To use your new project, choose TeX/Activate Project/XeTeX in the iTeXMac application, assuming you saved the project file in ~/Library/Application Support/iTeXMac/Generic Projects (or /Library/… or /Network/Library/… for machine-wide or network-wide domain configurations).

For further information on projects, see the iTeXMac online help, and look at the generic projects supplied with the program.