How to Use a Publishing Template in a PDF Transformation

From Oxygen XML Editor/Author

A publishing template can be used for PDF output from the transformation scenario (or from the transformation scenario).

The Templates tab in the transformation scenario dialog box displays all the templates that are available in your template gallery. To use a particular template in the transformation scenario, simply select it from this tab and then continue configuring the transformation using the other tabs to suit your needs.

To add the publishing template to your templates gallery, follow these steps:

Open the transformation scenario dialog box by editing a transformation (or a transformation scenario).
In the Templates tab, click the Configure Publishing Templates Gallery link to.

Step Result: This will open the preferences page.
Click the Add button and specify the location of your template directory.

Step Result: Your template directory is now added to the Additional Publishing Templates Galleries list.
Click OK to return to the transformation scenario dialog box.

Result: All the templates contained in your template directory will be displayed in the preview pane along with all the built-in templates.

From a Command Line

You can use the pdf.publishing.template parameter to point to the *.opt (publishing template) file:

dita.bat 
	--input=map\test.ditamap" 
	"-Dpdf.publishing.template=full_path_to_template_dir/my_template.opt" 
	--format=pdf-css-html5 
	...

Or use the two parameters to indicate the folder containing the publishing templates and the name of the publishing template file relative to that folder:

dita.bat 
	--input=map\test.ditamap" 
	"-Dpdf.publishing.template=full_path_to_template_dir" 
	"-Dpdf.publishing.template.descriptor=my_template.opt"
	--format=pdf-css-html5 
	...

Note: