Skip to main content

Section 43.3 PDF () Options

These options affect the conversion to , which can in turn be converted into PDF. See Chapter 30 for a more general overview of this conversion with more details. This includes some existing options that will eventually migrate to the publication file.

Subsection 43.3.1 Print Option

The conversion to can produce a PDF optimized for print, or optimized for use electronically on a screen. The

/publication/latex/@print

attribute can have the value yes to produce a print version, or the value no to produce an electronic version. The default is an electronic version. See Section 30.1 for more detail. Note that the use of page numbers in cross-references has different default behavior based on this option (which can be overidden, see Subsection 43.3.5).

Subsection 43.3.2 Sides Option

The conversion to can produce a PDF designed for printing on only one side of the page, or on both sides of the page. The

/publication/latex/@sides

attribute can have the value one for a one-sided version, or the value two to produce a two-sided version. The default depends on if the output is electronic (one-sided) or print (two-sided). See Section 30.4 for more detail.

Subsection 43.3.3 Font Sizes

The document-wide point size can be specified with the

/publication/latex/@font-size

attribute can have the value 8, 9, 10, 11, 12, 14, 17, 20, which are interpreted in points (“pt”) as the unit of measure. The default value is 10. See Section 30.5 for details.

Subsection 43.3.4 Page Shape Options

The following options affect the “shape” of each page, so are in a way less “global” than some of the previous options. These are both attributes of the

/publication/latex/page

element.

  • Text Alignment, Right Edge.

    Set

    /publication/latex/page/@right-alignment
    

    to values flush (default) or ragged to influence the right edge of the block of text on a page. See Section 30.3 for more.

  • Text Alignment, Bottom Edge.

    Set

    /publication/latex/page/@bottom-alignment
    

    to values flush or ragged (default) to influence the bottom edge of the block of text on a page. See Section 30.3 for more.

The content of the element

/publication/latex/page/geometry

element will feed directly into a \geometry{} element, with no modifications. (In other words, all whitespace, such as newlines and indentation, will be preserved.) Be sure to carefully read the advice, an example, and further detail at Section 30.6.

Subsection 43.3.5 Page Numbers in Cross-References

Set

/publication/latex/@pageref

to values yes or no to enable or disable the use of page numbers in cross-references (typically achieved with the <xref> element). The default varies, as it is dependent on the print option (Subsection 43.3.1). See Section 30.8 for more on the defaults.

Subsection 43.3.6 Worksheet Options

By default, worksheets are formatted differently than other pages, including customizable margins, workspace between exercises, and on their own pages. This separate formatting can be ignored, causing worksheets to be treated like any other division, using the

/publication/latex/worksheet/@formatted

attribute, setting the value to no. The default value is yes.

Subsection 43.3.8 Draft Mode

Set

/publication/latex/@draft

to values yes or no to enable or disable the use of the draft mode. The default is no. See Section 5.9 for more detail.

Subsection 43.3.9 Snapshot Record

Set

/publication/latex/@snapshot

to values yes or no to enable or disable the generation of a “snapshot” record of the LaTeX packages in use. The default is no. See Section 30.18 for more detail.