# PDF parameters

Certain parameters are specific to the PDF transformation.

args.artlbl
  Specifies whether to generate a label for each image; the label will contain the image file name. The allowed values are yes and no; the default value is no.
args.bookmap-order
  Specifies if the frontmatter and backmatter content order is retained in bookmap. The allowed values are retain and discard; the default value is discard.
args.bookmark.style
  Specifies whether PDF bookmarks are by default expanded or collapsed. The allowed values are EXPANDED and COLLAPSE.
args.chapter.layout
  Specifies whether chapter level TOCs are generated. The allowed values are MINITOC and BASIC; the default value is MINITOC.
args.fo.userconfig
  Specifies the user configuration file for FOP.
args.xsl.pdf
  Specifies an XSL file that is used to override the default XSL transformation.
  You must specify the fully qualified file name.
axf.cmd
  Specifies the path to the Antenna House Formatter executable.
axf.opt
  Specifies the user configuration file for Antenna House Formatter.
custom.xep.config
  Specifies the user configuration file for RenderX.
customization.dir
  Specifies the customization directory.
maxJavaMemory
  Specifies the amount of memory allocated to the RenderX process.
org.dita.index.skip
  Disable index processing. The allowed values are yes and no; the default value is no.

  Up until DITA-OT 3.4, indexing code was provided in the PDF plug-in and only available for PDF output. In version 3.4 and above, indexing is provided by a separate plug-in to allow other transformations to access the results.

  If you have overridden PDF index processing via the `transform.topic2fo` target in the past, you can set the org.dita.index.skip property to yes and re-enable the `transform.topic2fo.index` target with `<feature extension="depend.org.dita.pdf2.index" value="transform.topic2fo.index"/>` in your plug-in configuration.

org.dita.pdf2.chunk.enabled
  Enables chunk attribute processing. The following values are supported:
  - true – Enables chunk processing
  - false (default) – Disables chunk processing
org.dita.pdf2.i18n.enabled

  Enables internationalization (I18N) font processing to provide per-character font selection for FO renderers that do not support the `font-selection-strategy` property (such as Apache FOP prior to version 2.9).

  When this feature is enabled, DITA-OT uses a font mapping process that takes the content language into consideration. The mapping process uses configuration files for each language to define characters that should be rendered with certain logical fonts, and font mappings that associate each logical font to physical font files.

  The following values are allowed:

  - true (default) — Enables font mapping
  - false — Disables font mapping
  Tip:
  DITA-OT 4.2 includes FOP 2.9, which supports `font-selection-strategy`. As of this version (or if you don’t use custom character mappings), you can turn off font mapping and specify fonts directly in the XSL attributes files of your custom PDF plug-in. For background information, see Font configuration in PDF2.
outputFile.base
  Specifies the base file name of the generated PDF file.
  By default, the PDF file uses the base filename of the input .ditamap file.
  Notice:
  This parameter is deprecated since DITA-OT 3.0; use args.output.base instead.
pdf.formatter
  Specifies the XSL processor. The following values are supported:
  - fop (default) – Apache FOP
  - ah – Antenna House Formatter
  - xep – RenderX XEP Engine
publish.required.cleanup
  Specifies whether draft-comment and required-cleanup elements are included in the output. The allowed values are yes, and no.
  The default value is the value of the args.draft parameter. Corresponds to the XSLT parameter publishRequiredCleanup.
  Notice:
  This parameter is deprecated; use args.draft instead.
theme
  Theme configuration file.
xep.dir
  RenderX installation directory.