Menet teTeX Tips and Tricks

This document is a work in progress. As I discover problems with teTeX-1.0, I will post them here along with possible solutions.

Also, I've include some pointers to some of the new features possible with teTeX 1.0.

Changes between teTeX 0.4 and teTeX 1.0

Changed Package Behavior:

nomencl.sty
has changed its internal macro structure. Most users will need to rebuild their nomenclature list as follows.
  1. Remove the .aux and .glo files.
  2. Re-run LaTeX.
  3. Regenerate the .gls file with makeindex.
Users who have customized nomencl.sty with a nomencl.cfg file may need to re-write the file, see the nomencl documentation for more info.

geometry.sty
has changed its default values and how it works. The common symptom is an additional 0.5 in top margin. To solve this problem, simply add the "nohead" option to the list of options given to the \geometry{} invokation. However, a better solution is to look at the documentation for the new version of geometry.sty.

Changed Package Names:

A number of packages have new names, but still work the same:
gradient.sty
is now pst-grad.sty
charpath.sty
is now pst-char.sty
caption.sty
is now caption2.sty, with some additional features, although the documentation is the same.

Tips, Tricks, and Cool New Features

Better Adobe Acrobat Support

Historically, postscript output produced by dvips produces very poor .pdf files. With teTeX-1.0, however, there are a number of options you can use to produce acceptable .pdf files:
  1. The best option is to have dvips produce postscript files using outline fonts instead of bitmap fonts, using the "-Pcmz" and "-Pamz" options. For example:

    dvips -Pcmz -Pamz -o file.ps file.dvi

    produces .pdf-compatible postscript. You can then convert this file to a .pdf file using "distill" on the Suns.

  2. For documents which don't use included .eps graphics, ps-tricks, or other such packages, "pdflatex" is a replacement for "latex" which creates .pdf files as output instead of .dvi files. However, it can be tricky at times. For more information, see the PDFTeX manual.

Hyperlinks Support

Along with Acrobat support, if you are creating .pdf or .html output you can include hyperlinks (i.e. click on the entry in the table of contents and have it take you to the right section, create bookmarks, etc).

To do this, simply include the hyperref package. It's best to do this as the last package you include:

\usepackage[bookmarks=true,pdfstartview=FitH,colorlinks=true]{hyperref}

Note that this won't work with all macro packages.