Skip to main content

The PreTeXt Guide

Section 47.8 Publication Files, String Parameters

A publication file (Section 26.1) can be used to control various options that are independent of the authoring process, or for some conversions may be necessary. And the managed directories scheme requires use of a publication file (see Section 5.6). Use the -p switch to specify this file, using a path that is relative to your PreTeXt source (or an absolute path if it seems to be ignored).
Sometimes you might have need to pass string parameters to the PreTeXt script, though this will eventually be something an author will rarely do, and is more likely necessary for developers. This is accomplished with the -x flag, followed by a space separated list of (stringparam, value) pairs. Do not use parentheses, just separate with spaces. But note that -x cannot be the last option passed to the script since it makes it hard for the script to “see” the filename for your source.
For example:
pretext -vv -x debug.datedfiles no debug.chunk 0
   -f html -c all -p ~/books/aota/pub.xml
   -d /tmp/aota-html ~/books/aota/animals.xml