Change the PDF2 customization for oXygen user manual

Post here questions and problems related to editing and publishing DITA content.
lisazeng
Posts: 29
Joined: Tue Jun 27, 2017 2:10 pm

Change the PDF2 customization for oXygen user manual

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

Re: Change the PDF2 customization for oXygen user manual

Post 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:
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 »

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

Re: Change the PDF2 customization for oXygen user manual

Post by radu_pisoi »

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 »

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

Re: Change the PDF2 customization for oXygen user manual

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