Via XSLT and XSL-FO, very different templates can be created individually. If you know the technology, you have various options to design them. In this documents, you get the basic information to manage this.

JIRA Issues as XML Data

The following example XML document shows you how to edit in your XSLT stylesheet.

<?xml version="1.0" encoding="UTF-8" ?>
<issues>
	<issue>
		<___ip.key___>KBEP-1</___ip.key___>
		<___ip.summary___>Swimlanes on Kanban boards</___ip.summary___>
		<___ip.description___><p><b>HTML-Formatted description</b></p></___ip.description___>		
		<___ip.qrcodeimage___><!-- Base 64 encoded image content --></___ip.qrcodeimage___>
	</issue>
	<issue>
		<___ip.key___>KBEP-2</___ip.key___>
		<___ip.summary___>The second description</___ip.summary___>
		<___ip.description___>The second issue</___ip.description___>		
		<___ip.qrcodeimage___></___ip.qrcodeimage___>
	</issue>
</issues>

JIRA fields that can be used within templates

The elements in the issue view, marked with colored circles, are partially part of the existing templates or can be used to create new templates. Apache FOP is used to transform templates in XSL-FO format (in a special XSL style sheet, W3C-Standard) for direct printing or .pdf creation.

Placeholder for JIRA entries for use in templates

You can use the following place holders in the templates for the items marked in the issue view above. To test all fields, the template seibertmedia can be used.

Custom template examples

4 issues on one A4 page

The first thing to ajust is the default paper format: Change it to A4 landscape within <fo:simple-page-master>. Then define two columns in the Tag <fo:region-body>:

<fo:layout-master-set>
  <fo:simple-page-master master-name="A4-landscape" page-height="21cm" page-width="29.7cm" margin="0.5cm" margin-top="0.3cm">
    <fo:region-body margin="5mm 0mm 5mm 0mm" column-count="2" column-gap="4mm" />
  </fo:simple-page-master>
</fo:layout-master-set>

The next think to ajust is <page-sequence>:

<fo:page-sequence master-reference="A4-landscape" font-family="'DejaVu Sans'" font-size="10pt">
  <fo:flow flow-name="xsl-region-body">
    <xs:apply-templates select="//issue" />
  </fo:flow>
</fo:page-sequence>

Then use the xsl template definition <template match="issue"> to rint your specific issue layout.

Please see the complete XSL file for a working example: FourOnA4.xsl

Changing the paper format

Download a template from the "InstaPrinta Global Configuration" page and open it with a text-editor of your choice. Now jump to the 10th line and customize the paper format:

page-height="10.5cm" page-width="14.8cm" margin="0.5cm" margin-top="0.5cm">

Instead of cm (centimeters) you can also use in (inches).

Upload the template under a new name and that's it.

Inserting blank lines

Insert the following code block to create blank lines:

<fo:block>
<fo:leader />
</fo:block>

Further information concerning XSL-FO

Apache FOP 1.1:

http://xmlgraphics.apache.org/fop/

XSL-FO:

http://www.w3.org/TR/xsl/

http://www.w3schools.com/xslfo/xslfo_intro.asp