Page 1 of 1

Positioning a Graphic on the Cover in .pdf

Posted: Wed Jun 21, 2017 10:41 pm
by Garrett
Hello!

I'm new to Oxygen and relatively new to xsl:fo, and have been trying to figure out how to customize the generated .pdf's cover page to match (as closely as possible) our corporate cover template. I hope this is the correct forum.

I can add the bits of information I want (title, logo, etc.) to the page but what's got me stuck is positioning a background image, ignoring margins, flush with the bottom and right side of the page. Currently, I can place the image in the lower right, but it obeys the page margins and scrolls off the page if I add more text or padding to the existing text on the cover.

So,

1] I need the image to be "in the background" so that if I add more text to the cover, the graphic will remain in place, and the text I add will be displayed "over" the image.

2] Also, I need the image to be flush with the bottom of the page and the right side of the page, ignoring the margins.

Any/all hints and help appreciated!

Thanks!

Re: Positioning a Graphic on the Cover in .pdf

Posted: Thu Jun 22, 2017 12:38 pm
by cosmin_andrei
Hi Garret,

Thank you for contacting us!

If you are at the beginning of the PDF customization process, maybe you can consider our PDF customization plugin for oXygen user manual. It covers some use cases and it can be used as a starting point:
https://github.com/oxygenxml/com.oxygen ... tomization

Please note that PDF2 customization requires good knowledge of XSLT and XSL-FO technologies.

Let us know if you need further assistance.

Re: Positioning a Graphic on the Cover in .pdf

Posted: Thu Jun 22, 2017 6:34 pm
by Garrett
Thank you, Cosmin.

This looks like it covers exactly what I need to be able to move to Oxygen.

I'm curious, for this step in the ReadMe file (step #4), is it possible to create a transformation scenario within the Oxygen editor itself to run the transformation:

4. Invoke the PDF transformation using the oxy-ug-pdf transtype in a command, as in the following example:

Code: Select all

dita.bat -i file:/D:/workspace/userguide-private/DITA/UserManual.ditamap -f oxy-ug-pdf -output=D:/workspace/userguide-private/DITA/out-pdf --filter=D:/workspace/userguide-private/DITA/author.ditaval -Doxy-ug-distribution=author

Re: Positioning a Graphic on the Cover in .pdf

Posted: Fri Jun 23, 2017 5:34 pm
by cosmin_andrei
Hi Garrett,

It is possible to use DITA-OT plugins to generate fine tuned PDF outputs adapted to your needs.
This can be achieved through installing custom plugins of your own in the configured DITA OT folder. The DITA OT could be the DITA OT 2.x bundled in oXygen, or an external DITA OT of your choice.

To make it work, you should:
- download the .zip archive[1], then extract the "com.oxygenxml.pdf2.ug" folder from it into Your_Oxygen_Install_Dir\frameworks\dita\DITA-OT2.x\plugins;
- run oXygen as Administrator, then go into the "Configure Transformation Scenario(s)" and apply the "Run DITA-OT Integrator" scenario;
- if you successfully integrated your plugin with the DITA-OT, you should be able to find the custom transformation types (transtypes) defined through the plugin in the DITA Transformation Type dialog/chooser. To reach the DITA Transformation Type dialog, you should go into the "Configure Transformation Scenario(s)" dialog and click New, then choose "DITA-OT Transformation". If there are custom transtypes defined in your plugin, you should be able to find them listed in the scenarios list from that dialog;
- run the customized DITA Map PDF scenario you have just created.

[1]https://github.com/oxygenxml/com.oxygenxml.pdf2.ug

The Parameters tab allows you to configure the parameters sent to the DITA-OT build file.To do this, you should go into the "Configure Transformation Scenario(s)", select the particular transformation scenario and click the Edit button at the bottom of the dialog box or from the contextual menu. This will open an Edit scenario configuration dialog box that allows you to configure various options in several tabs, depending on the type of transformation scenario that was selected. Since transformation scenarios that are associated with predefined frameworks are read-only, to edit one of these scenarios you will need to duplicate it and edit the duplicated scenario.

The table in this tab displays all the parameters that the DITA-OT documentation specifies as available for each chosen type of transformation, along with their description and current values. You can also add, edit, and remove parameters, and you can use the text box to filter or search for a specific term in the entire parameters collection. Note that edited parameters are displayed with their name in bold.

Let us know if you need further assistance.

Re: Positioning a Graphic on the Cover in .pdf

Posted: Sat Jul 01, 2017 12:56 am
by Garrett
Thank you very much, this is helpful. I see what I was doing wrong (looking at the same level as "DITA-OT Transformation" instead of drilling down into it), and am now making progress. :)