UK TeX FAQ -- question label acrobat

### Making Acrobat documents from LaTeX

There are three general routes to Acrobat output: Adobe's original 'distillation' route (via PostScript output), conversion of a DVI file, and the use of a direct PDF generator such as PDFTeX (see the PDFTeX project) or MicroPress's VTeX (see commercial TeX implementations and 'free' TeX implementations)).

For simple documents (with no hyper-references), you can either

- process the document in the normal way, produce PostScript output and distill it;
- (on a Windows or Macintosh machine with the appropriate Adobe tools installed) pass the output through the PDFwriter in place of a printer driver (this route is a dead end: the PDFwriter cannot create hyperlinks);
- process the document in the normal way and generate PDF direct from the DVI with dvipdfm; or
- process the document direct to PDF with PDFTeX or VTeX. PDFTeX has the advantage of availability for a wide range of platforms, VTeX (available commercially for Windows, or free of charge for Linux or OS/2) has wider graphics capability, dealing with encapsulated PostScript and some in-line PostScript.

To translate all the LaTeX cross-referencing into Acrobat links, you need a LaTeX package to suitably redefine the internal commands. There are two of these for LaTeX, both capable of conforming to the HyperTeX specification (see Making hypertext documents from TeX): Sebastian Rahtz's hyperref, and Michael Mehlich's hyper. Hyperref uses a configuration file to determine how it will generate hypertext; it can operate using PDFTeX primitives, the hyperTeX `\``special`s, or DVI driver-specific `\``special` commands. Dvips translates the DVI with these `\``special` commands into PostScript acceptable to Distiller, and dvipdfm has `\``special` commands of its own.

There is no free implementation of all of Adobe Distiller's functionality, but recent versions of ghostscript provide pretty reliable distillation (but beware of the problems discussed in dvips output for distillation). In fact, Distiller itself is now remarkably cheap (for academics at least).

For viewing (and printing) the resulting files, Adobe's Acrobat Reader is available for a fair range of platforms; for those for which Adobe's reader is unavailable, remotely current versions of ghostscript combined with ghostview or GSview can display and print PDF files.

In many circumstances, ghostscript combined with a viewer application is actually preferable to Acrobat Reader. For example, on Windows Acrobat Reader locks the `.pdf` file it's displaying: this makes the traditional (and highly effective) (La)TeX development cycle of "Edit-> Process-> Preview" become incredibly clumsy - GSview doesn't make the same mistake.

`Acrobat Reader`
  browse ftp://ftp.adobe.com/pub/adobe/acrobatreader
`dvipdfm`
  dviware/dvipdfm (zip, browse)
`ghostscript`
  Browse nonfree/support/ghostscript/
`ghostview`
  Browse support/ghostscript/gnu/ghostview/
`GSview`
  Browse nonfree/support/ghostscript/ghostgum/
`hyper.sty`
  macros/latex/contrib/hyper (zip, browse)
`hyperref.sty`
  macros/latex/contrib/hyperref (zip, browse)

This question on the Web: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=acrobat