Page 1 of 1

Change the PDF2 customization for oXygen user manual

Posted: Tue Jul 18, 2017 11:56 am
by 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

Re: Change the PDF2 customization for oXygen user manual

Posted: Wed Jul 19, 2017 4:16 pm
by radu_pisoi
Hi,
lisazeng wrote: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:

Re: Change the PDF2 customization for oXygen user manual

Posted: Thu Jul 20, 2017 1:04 pm
by 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

Re: Change the PDF2 customization for oXygen user manual

Posted: Thu Jul 20, 2017 1:27 pm
by radu_pisoi
Hi,

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

Re: Change the PDF2 customization for oXygen user manual

Posted: Tue Jul 25, 2017 2:40 pm
by 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

Re: Change the PDF2 customization for oXygen user manual

Posted: Thu Jul 27, 2017 9:48 am
by 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