Revision of parameters-to-the-DITA-OT-transform from Mon, 2009-10-12 15:10

Ant and XSLT Parameters to the DITA Open Toolkit

This page is a collection point for parameters in the core DITA-OT that can be set by tools or individual users running a build. Note: the main landing page for information about the toolkit is here: http://dita.xml.org/wiki/the-dita-open-toolkit

As you can see at this point, this item is just a starter page, with more information coming soon.

Most of this information would be more usable in a tabular format, but this wiki does not appear to support tables. For each parameter below, the Ant parameter is listed first, followed by valid values (if any), followed by a description. If applicable, a corresponding XSLT parameter is listed at the end. If you have an idea for a better way to store this, please comment!

General processing parameters

  •  ${args.draft} - "no" or "yes", default is "no". Indicates whether draft-comment and required-cleanup elements are included in the generated file. Corresponds to XSLT parameter DRAFT.
  • ${dita.ext} - any value, defaults to ".xml". Specifies an extension to use for DITA topics; all DITA topics will use this single extension in the temp directory. Corresponds to XSLT parameter DITAEXT.
  • ${dita.input.valfile} - any value. Specifies the DITAVAL file used for processing. Corresponds to XSLT parameter FILTERFILE.
  • ${args.tablelink.style} - "NUMBER" or "TITLE" (default is "NUMBER"). Determines how cross references to tables are styled (currently for XHTML only, but may be picked up for other formats in the future). NUMBER results in "Table 5", TITLE results in the title of the table. Corresponds to the XSLT parameter TABLELINK.
  • ${args.figurelink.style} - "NUMBER" or "TITLE" (default is "NUMBER"). Determines how cross references to figures are styled (currently for XHTML only, but may be picked up for other formats in the future). NUMBER results in "Figure 5", TITLE results in the title of the figure. Corresponds to the XSLT parameter FIGURELINK.

XHTML specific parameters

  • ${args.artlbl} -"no" or "yes", defaults to "no". Indicates whether the filename of each image will appear alongside the image, typically for review purposes. Corresponds to the XSLT parameter ARTLBL.
  • ${args.css} - any value. Specifies a CSS file, expected without path
  • ${args.hdf} - any value. Specfies a file that contains an XHTML fragment to be inserted into the <head> of every generated XHTML file. NOTE: the fragment must be valid XML, with a single root element; if you need to add two peer elements, place them in a <div>, and the build will discard that wrapper. Corresponds to the XSLT parameter HDF.
  • ${args.hdr} - any value. Specfies a file that contains an XHTML fragment to be inserted at the top of the body in each generated XHTML file. NOTE: the fragment must be valid XML, with a single root element; common practice is to place all contents into <div>. Corresponds to the XSLT parameter HDR.
  • ${args.indexshow} - "no" or "yes", defaults to "no". When set to yes, index terms will appear inline in brackets, typically for review purposes. Corresponds to the XSLT parameter INDEXSHOW.
  • ${args.ftr} - any value. Specfies a file that contains an XHTML fragment to be inserted at the bottom of the body in each generated XHTML file. NOTE: the fragment must be valid XML, with a single root element; common practice is to place all contents into <div>. Corresponds to the XSLT parameter FTR.
  • ${out.ext} - any value, defaults to ".html". Specifies an output extension for XHTML topics. Corresponds to XSLT parameter OUTEXT.
  • ${args.csspath} - any value, default is the root map's directory. Specifies a path for CSS links added to XHTML output (default and user files). Corresponds to XSLT parameter CSSPATH.
  • ${args.xhtml.classattr} - "no" or "yes". Determines whether to include DITA class ancestry inside generated XHTML elements, to allow for extensive CSS styling. For example, the prereq element in a task would generate <task class="section prereq">. Corresponds to the XSLT parameter PRESERVE-DITA-CLASS.
  • ${args.gen.task.lbl} - "NO" or "YES" (default is "NO"). Determines whether to generate locale based default headings for sections within task topics. Corresponds to the XSLT parameter GENERATE-TASK-LABELS.
  • ${args.hide.parent.link} - "no" or "yes" (default is "no"). Determines whether to hide links to parent topics in the rendered XHTML. Corresponds to the XSLT parameter NOPARENTLINK.
  • ${args.breadcrumbs} - "no" or "yes" (default is "no"). Determines whether to generate breadcrumb links. Corresponds to the XSLT parameter  BREADCRUMBS.
  • ${args.debug} - "no" or "yes" (default is "no"). Determines whether to generate extra debug information in the log. Corresponds to the XSLT parameter DBG.
  • ${args.gen.default.meta} - "no" or "yes" (default is "no"). Determines whether to generate extra metadata that targets parental control scanners (meta elements with name="security" and name="Robots"). Corresponds to the XSLT parameter genDefMeta.

PDF specific parameters

  • item

 

XML.org Focus Areas: BPEL | DITA | ebXML | IDtrust | OpenDocument | SAML | UBL | UDDI
OASIS sites: OASIS | Cover Pages | XML.org | AMQP | CGM Open | eGov | Emergency | IDtrust | LegalXML | Open CSA | OSLC | WS-I