PDF processing modules
The PDF (formerly known as PDF2) transformation process runs the pre-processing routine and follows it by a series of additional targets. These steps work together to create a merged set of content, convert the merged content to XSL-FO, and then format the XSL-FO file to PDF.
The PDF process includes many Ant targets. During a typical conversion from map to PDF, the following targets are most significant.
map2pdf2Creates a merged file by calling a common Java merge module. It then calls the
publish.map.pdftarget to do the remainder of the work.publish.map.pdfPerforms some initialization and then calls the
transform.topic2pdftarget to do the remainder of processing.transform.topic2pdfConverts the merged file to XSL-FO, generates the PDF, and deletes the
topic.fofile, unless instructed to keep it.
The transform.topic2pdf target uses the following targets to perform those tasks:
transform.topic2foConvert the merged file to an XSL-FO file. This process is composed of several sub-targets.
transform.topic2fo.indexRuns a Java process to set up index processing, based on the document language. This step generates the file
stage1.xmlin the temporary processing directory.transform.topic2fo.flaggingSets up preprocessing for flagging based on a DITAVAL file. This step generates the file
stage1a.xmlin the temporary processing directory.transform.topic2fo.mainDoes the bulk of the conversion from DITA to XSL-FO. It runs the XSLT-based process that creates
stage2.foin the temporary processing directorytransform.topic2fo.i18nDoes additional localization processing on the FO file; it runs a Java process that converts
stage2.fointostage3.fo, followed by an XSLT process that convertsstage3.fointotopic.fo.transform.fo2pdfConverts the
topic.fofile into PDF using the specified FO processor (Antenna House, XEP, or Apache FOP).delete.fo2pdf.topic.foDeletes the
topic.fofile, unless otherwise specified by setting an Ant property or command-line option.