Page 1 of 1

How to add a customized PDF cover

Posted: Tue Dec 12, 2017 5:19 am
by catherine
Hi, I am quite new to DITA and Oxygen,
is there any way to add my customized image as a PDF cover?

If not, how can I customize the PDF cover page to acheive the followings:
    add a logo, and change the logo position
I tested it by your guides, it works, but the logo is placed in the center of the cover page, I edited the custom.xls file, but not work.
I want the logo placed at the top-left or top-right.

    add additional information
Information like address, contact, release version, etc.

Thanks for your help.

Re: How to add a customized PDF cover

Posted: Tue Dec 12, 2017 5:53 pm
by bogdan
Hi Catherine,

One of my colleagues wrote a small example that customizes a PDF cover page (background image, logo, and title), so you can use this as a starting point for your project:
  • Go to and download the sample project as a zip file.
  • Extract the archive anywhere on your computer.
  • Load your DITA project in the DITA Maps Manager View.
  • Press the Configure Transformation Scenario button, choose the DITA Map PDF - WISIWYG scenario, then press the Edit button.
  • Switch to the Parameters tab and set the args.css parameter to point to the p-dita-customization.css file extracted in the second step. Make sure that the value of this parameter is a URL (such as file:///C:/myfile.css), not a file path.
  • Apply the transformation scenario.

If the scenario is executed correctly, you will get a PDF output file with a customized cover page. Please note that the CSS rules from this customization project apply on top of the CSS styles used for rendering the topics in Oxygen Author mode. If you want to change this default set of CSS styles, look for the Styles drop-down box and choose a style that suits your needs.

If you want to further customize the cover page, edit the p-front-page.css file that contains several rules to style specific elements of the front page.

Best Regards,

Re: How to add a customized PDF cover

Posted: Wed Dec 13, 2017 5:09 am
by catherine
Thanks, bogdan
I am using Oxygen 18, seems this version doesn't support Oxygen PDF chemistry.
The css processor type has two choices: prince and antenna-house, but no PDF chemistry.

Re: How to add a customized PDF cover

Posted: Wed Dec 13, 2017 5:44 am
by catherine
Hi, I am not familar with PrinceXML.
I just choose prince css processor type and followed by your suggested steps.
The Oxygen XML said "transformation successfully", but I didnt get the PDF output.

So, what should I do with the PrinceXML?

Re: How to add a customized PDF cover

Posted: Wed Dec 13, 2017 3:27 pm
by bogdan
Hi Catherine,

Prince XML (as well as Antenna House) is a third-party PDF processor that you can use with our built-in WYSIWYG transformation scenario, but if you want to use either of them, I suggest that you contact them directly and ask for details regarding pricing, licensing, and usage.

Since you posted in the Oxygen PDF Chemistry section of this forum, I assumed that you want to use the Oxygen PDF Chemistry processor, a tool developed by Oxygen, and was made available in Oxygen XML Editor/Author starting with version 19.0.

To sum up, if you want to use Chemistry you need to upgrade your version of Oxygen to the latest version. If you want to try it out before making a purchasing decision, you could request a trial license key.

Best regards,
Bogdan Goreci