Change the PDF2 customization for oXygen user manual

[lisazeng]

Hi Experts,

As I download PDF2 customization for oXygen user manual from https://github.com/oxygenxml/com.oxygenxml.pdf2.ug.
I used it for my own publications in Dita OT 2.5, and extends it functions, such as adding page footer and header, the disclaimer page, etc.
It helps me a lot!

Right now I want to add the following functions and would you please share me where to start, need to change which page?
Thanks!

1. in bookmaps, add the chapter number.
Righ now only : AAAAAA
BBBBBB
CCCCCC
I want to have this : 1 AAAAA
1.1 BBBBBBBB
1.2 CCCCCCC

2. Make the name "Contents" visible in the table of contents.
Right now: AAA-----------1
BBB-----------2
CCC----------3

I want to have

Contents
1 AAAAA------------------1
1.1 BBB-------------------2
1.2 CCC-------------------3

3. I want to make chapter 1, 2 start from a new page.

4. I wan to have all paragraph start from the left of of the page.

br,
Lisa

[radu_pisoi]

Hi,

1. in bookmaps, add the chapter number.
Righ now only : AAAAAA
BBBBBB
CCCCCC
I want to have this : 1 AAAAA
1.1 BBBBBBBB
1.2 CCCCCCC

If you want to add numbers before the topic's title, you can use the next PDF customization plugin https://github.com/oxygenxml/org.dita.p ... .numbering.

This plugin contributes two parameters to the PDF2 transformation:

• numbers-before-title (yes/no)
  Specifies whether or not this feature is enabled. The default value is no.
• numbers-before-title-depth
  Specifies the depth of the topics that will be numbered when the numbers-before-title option is enabled.

To use this PDF customization plugin from the Oxygen interface follow these steps:

• Download the ZIP archive associated with this project by using the Clone or download button.
• To install the plugin and transform it, follow the procedure found here: https://www.oxygenxml.com/doc/ug-editor ... lugin.html

[lisazeng]

Hi Radu,

Since I already have the pdf plugin of "PDF2 customization for oXygen user manual", can I also use the "org.dita.pdf2.topic.numbering" in it?
by just include this plugin?

Thanks!

Lisa

[radu_pisoi]

Hi,

Yes, you can install both plugins in your DITA-OT distribution. I think they are compatible.

[lisazeng]

Hi Radu,

I donwload the org.dita.pdf2.topic.numbering and installed it in dita2.5.

How can I use it in the com.oxygenxml.pdf2.ug-master?

I did this:
in com.oxygenxml.pdf2.ug-master\plugin.xml, add
<require plugin="org.dita.pdf2.topic.numbering-master"/>

How can I make the reuse the parameter of numbers-before-title defined in org.dita.pdf2.topic.numbering in com.oxygenxml.pdf2.ug-master?

Thanks!

br,
Lisa

[Radu]

Hi Lisa,

Just installing the numbering plugin (copying it to the DITA OT "plugins" folder and then running the DITA OT integrator) should be enough. The plugin contributes a customization.xsl stylesheet which matches each topic title and tries to place a number before it. You can use xsl:message's to see if the template is called on your side.

Regards,
Radu