7.2.12. Configuring pdfjadetex

The file jadetex.cfg is used whenever you want to override jadetex's or pdfjadtex's default behavior. This file just goes in the current working directory (i.e. where jadetex is being run from). It seems that pretty much any TeX code can go in there, but here are some common things.

• The hyperref package expands the cross-referencing capabilities of LaTeX introducing \special commands that can be interpreted by a driver (like pdfjadetex) to produce hypertext links to places in the same document (cross-references), other PDF documents, or even WWW pages. You declare its use in jadetex.cfg with

  \hypersetup{

  inserting various options after the curly bracket. See Section 7.2.6.

• Two-Sided Pages: sometimes, you will want jadetex to start chapters on the recto side, and try to keep the total count of pages even. This is no longer the default behaviour, so if you want to revert to it, put the following in jadetex.cfg:

  \def\PageTwoSide{1} \def\TwoSideStartOnRight{1}

• PDF Outlines (bookmarks): PDF outlines are a nested, tree-like list of the hierarchy of chapters, sections, etc, each trre node being a link to the relevant chapter or section. These are displayed on the left side of Acrobat® Reader. To enable the listing of bookmarks, put this in jadetex.cfg:

  pdfpagemode=UseOutlines

• If you happen to have a "Citation Reference" or a "Cross Reference" inside of a "Section" (for example "5 The Proof [somebook]"), then you will need to give the linktocpage option to pdftex, otherwise you will get an error when generating the Table of Contents saying

  "pdfTeX error (ext4): link annotations can't be nested"

  Put the following in jadetex.cfg:

  \usepackage[pdftex,linktocpage]{hyperref}

• Computer Modern (CM) fonts: The ae package provides virtual EC fonts based on the CM ones, so that the Type1 CM fonts can be used in the output file. However, not all EC characters are available in this way. The aecompl package defines the missing characters as bitmapped fonts. To use them you should have the following in jadetex.cfg:

  \usepackage[T1]{fontenc} \usepackage{ae} \usepackage{aecompl}

  In this way the output will use CM fonts for all except some rarely used characters