PPPL Unix Cluster

## 5.2: TeX

TeX is a scientific typesetting package. We run the teTeX distribution version 1.0. This is documented at http://w3.pppl.gov/misc/teTeX. LaTeX latex(1) is the recommended macro package. The run it, use the command

```latex file.tex
```

Useful (indispensible) books are:

• LaTeX, a Document Preparation System, by Leslie Lamport (2nd Ed, Addison Wesley, 1994)
• The LaTeX Companion, by M. Goosens, F. Mittelbach, and A. Samarin (Addison Wesley, 1994)
• The LaTeX Graphics Companion, by M. Goosens, S. Rahtz, and F. Mittelbach (Addison Wesley, 1997)

If you have problems running TeX, please check your environment variables, in particular `TEXINPUTS`. Make sure these do NOT contain references to ``/usr/local/share/texmf/...`', ``/usr/local/lib/texmf`', etc. If you have private macro files in ``~/tex`', then you will want to define

```TEXINPUTS=.:~/tex: export TEXINPUTS
setenv TEXINPUTS .:~/tex:
```

in sh or csh syntax. (The default `TEXINPUTS` will be implicitly inserted after the trailing colon).

This version provides better support for producing documents for online viewing:

1. pdflatex produces a pdf file instead of a dvi file.
2. the hyperref package has support for carrying the cross-reference information and references to URLs in a TeX document over to the dvi or pdf file; for example, you reference your home page like this
```\href{http://w3.pppl.gov/~jsmith}{J. Smith}
```

The following are possible ways of producing pdf files from LaTeX

1. In the ``.tex`' file, put
```\usepackage{times}
\usepackage{hyperref}
```

Process with `latex`, then with `dvips -Pwww -z`, then with `distill`.

2. In the ``.tex`' file, put
```\usepackage{times}
\usepackage[dvips]{hyperref}
```

Process with `latex`, then with `dvips -Pwww`, then with `distill`.

3. In the ``.tex`' file, put
```\usepackage{times}
\usepackage[pdftex]{hyperref}
```

Process with `pdflatex`.

When you view the ``.dvi`' file produced in method (1) with `xdvi`, the links will be underlined (and you click on them to follow them).

emacs Miscellaneous software python