Change the PDF2 customization for oXygen user manual

lisazeng
Posts: 29
Joined: Tue Jun 27, 2017 2:10 pm

Change the PDF2 customization for oXygen user manual

Post by lisazeng » Tue Jul 18, 2017 11:56 am

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
Posts: 336
Joined: Thu Aug 21, 2003 11:36 am
Location: Craiova
Contact:

Re: Change the PDF2 customization for oXygen user manual

Post by radu_pisoi » Wed Jul 19, 2017 4:16 pm

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:
Radu Pisoi
<oXygen/> XML Editor, Schema Editor and XSLT Editor/Debugger
http://www.oxygenxml.com

lisazeng
Posts: 29
Joined: Tue Jun 27, 2017 2:10 pm

Re: Change the PDF2 customization for oXygen user manual

Post by lisazeng » Thu Jul 20, 2017 1:04 pm

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
Posts: 336
Joined: Thu Aug 21, 2003 11:36 am
Location: Craiova
Contact:

Re: Change the PDF2 customization for oXygen user manual

Post by radu_pisoi » Thu Jul 20, 2017 1:27 pm

Hi,

Yes, you can install both plugins in your DITA-OT distribution. I think they are compatible.
Radu Pisoi
<oXygen/> XML Editor, Schema Editor and XSLT Editor/Debugger
http://www.oxygenxml.com

lisazeng
Posts: 29
Joined: Tue Jun 27, 2017 2:10 pm

Re: Change the PDF2 customization for oXygen user manual

Post by lisazeng » Tue Jul 25, 2017 2:40 pm

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
Posts: 6141
Joined: Fri Jul 09, 2004 5:18 pm

Re: Change the PDF2 customization for oXygen user manual

Post by Radu » Thu Jul 27, 2017 9:48 am

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
Radu Coravu
<oXygen/> XML Editor
http://www.oxygenxml.com

Post Reply