Page break in Wiki PDF export

Description
pitzalis
Posts: 15
Joined: Mon Jun 04, 2007 8:58 am
Location: Italy

Page break in Wiki PDF export

Postby pitzalis » Fri Mar 20, 2009 8:56 am

If you use Polarion wiki to generate formal documentation containing requirements, maybe you will export the wiki pages in PDF format. For better document layout organization, I think, it could be useful to have the capability to add page breaks in wiki pages in order to control the pagination in the exported PDF document.
I resolved the problem using an HTML element enclosed in a Velocity Macro:

Add:
#macro(pagebreak)
<div style="break-before: page">&nbsp;</div>
#end

in file (located in Polarion installation):
/opt/polarion/polarion/plugins/com.polarion.alm.wiki_3.2.3/src/main/webapp/templates/macros.vm

Use the macro in wiki pages:
#pagebreak()

Any other suggestions or better solutions are welcome.
Thanks,
Giuseppe Pitzalis

pitzalis
Posts: 15
Joined: Mon Jun 04, 2007 8:58 am
Location: Italy

Re: Page break in Wiki PDF export

Postby pitzalis » Thu May 28, 2009 8:37 am

Polarion 3.3 defines the macro #pagebreak() in file macros.vm.
I'm happy because I don't have to customize Polarion installation.
Only a question to Polarion Team: why this feature isn't described in Wiki Syntax Help and isn't listed in Polarion 3.3 resolved workitems?

NickEntin
Posts: 472
Joined: Tue Oct 24, 2006 10:27 am
Location: Polarion Software GmbH, Stuttgart
Contact:

Re: Page break in Wiki PDF export

Postby NickEntin » Thu May 28, 2009 12:00 pm

Hi Giuseppe,

unfortunately this macro doesn't work well in all conditions, therefore we have still open defect "DPP-9687 - Fix and document #pagebreak macro", which should be addressed yet.

Best regards,
Nick

chyliko
Posts: 26
Joined: Fri Sep 16, 2005 12:58 pm
Location: Prague, Czech Republic
Contact:

Re: Page break in Wiki PDF export

Postby chyliko » Tue May 25, 2010 9:29 am

Since version 3.3.1 up to the latest available, 2010 SR1, Polarion features macro {page-break} which replaces the former #pagebreak() and is fully documented.

Excerpt from the Wiki Syntax Help:

{page-break:VALUE}

The {page-break} macro is applicable only in PDF export. It takes one required parameter and the VALUE can be:

page - text below this macro will start on new page
even-page - text below this macro will start on new even page
odd-page - text below this macro will start on new odd page


This new macro may have not been mentioned explicitly and separately in the release notes, as it was added mainly to support better output of some default and example content, like Module Home pages and similar.

Regards,
Ondrej
___________________________
Ondrej Chylik, Polarion Software


Return to “Polarion Application Lifecycle Management (ALM)”

Who is online

Users browsing this forum: No registered users and 11 guests