https://github.com/infotexture/org.dita-community.pdf-page-break

PDF Page Break Plugin for DITA Open Toolkit based on a blog post by Radu Coravu
https://github.com/infotexture/org.dita-community.pdf-page-break

Last synced: 2 days ago
JSON representation

PDF Page Break Plugin for DITA Open Toolkit based on a blog post by Radu Coravu

• Host: GitHub
• URL: https://github.com/infotexture/org.dita-community.pdf-page-break
• Owner: infotexture
• Created: 2015-06-03T11:54:02.000Z (over 9 years ago)
• Default Branch: master
• Last Pushed: 2015-06-03T12:34:24.000Z (over 9 years ago)
• Last Synced: 2024-10-12T19:48:28.759Z (about 1 month ago)
• Language: XSLT
• Homepage: https://github.com/dita-community/org.dita-community.pdf-page-break
• Size: 113 KB
• Stars: 0
• Watchers: 2
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: ReadMe.md

Awesome Lists containing this project

README

        
# PDF Page Break Plugin for DITA-OT

This plugin for [DITA Open Toolkit][1] is based on a [blog post][2] by Radu Coravu of Syncro Soft, the makers of [oXygen XML Editor][3].

The instructions from the original post are included here for convenience:

---  

## DITA PDF publishing - Force page breaks between two block elements

[blog.oxygenxml.com](http://blog.oxygenxml.com/2015/04/dita-pdf-publishing-force-page-breaks.html) * by Radu Coravu * April 29, 2015 

Let's say that at some point in your DITA content you have two block level elements, like for example two paragraphs:

```xml

First para

Second para

```


and you want to force in the PDF output a page break between them.

Here's how a DITA Open Toolkit plugin which would achieve this could be implemented:

 1. You define your custom processing instruction which marks the place where a page break should be inserted in the PDF, for example:

    

    ```xml

    
First para

    

    
Second para

    ```


 2. In the **DITA Open Toolkit** distribution in the plugins directory you create a new plugin folder named for example `pdf-page-break`.

 3. In this new folder create a new `plugin.xml` file with the content:

    

    ```xml

    

      

      

      

      

    

    ```

    The most important feature in the plugin is that it will add a new XSLT stylesheet to the XSL processing which produces the PDF content.

 4. Create in the same folder an **XSLT** stylesheet named `pageBreak.xsl` with the content:

    

    ```xml

    

      

        

      

    

    ```

 5. Install your plugin in the **DITA Open Toolkit** by running the DITA-OT Ant integrator task. 

    If you are running the publishing from **Oxygen XML Editor** you can use the predefined transformation scenario: [http://www.oxygenxml.com/doc/ug-oxygen/#topics/dita-ot-install-plugin.html](http://www.oxygenxml.com/doc/ug-oxygen/#topics/dita-ot-install-plugin.html). 

    If you run DITA-OT from the command line please follow these guidelines:  

    [http://www.dita-ot.org/2.0/dev_ref/plugins-installing.html](http://www.dita-ot.org/2.0/dev_ref/plugins-installing.html).

---

[1]:    http://www.dita-ot.org/

[2]:	http://blog.oxygenxml.com/2015/04/dita-pdf-publishing-force-page-breaks.html

[3]:    http://www.oxygenxml.com/