Realising Good Control Over Output with Confluence

Formatting General Output

Title Page

In the Space Admin area of Confluence:

• Go to the Scroll Wiki PDF Exporter: Template
  • Name Must be unique
  • Page Layout
    • Different first page
    • Different even and odd pages
    • Straightforward editing of page size, margins, padding, header and footer
      • Margins are defined by
        • (4) Top, Right, Bottom then Left
        • (2) Top and bottom or
        • (1) All
      • Padding is defined by
        • (4) Top, Right, Bottom then Left
        • (2) Top and bottom, then Sides (right and left) or
        • (1) All
  • Static Pages
    • Title Page Allows you to edit content using HTML tags. (e.g. inserting <img src="openpetra_logo_final_white_text.png"/>)
  • Content Formatting Allows editing of the overall CSS applied to the PDF export, e.g.

.titlepage {
  text-align: center;
}

h1.heading {
    page-break-before: right;
}

• • FontsPresumably upload custom fonts if referenced in CSS file
  • Resources Needs upload of image files included in Static Pages

Formatting Specific Content

Highlighting of Sections

Confluence macros that have predefined tags associated with them that show up nicely in PDF export (able to be manipulated with Style Sheets following DocBook export)

• Info
• Note
• Tip
• Warning
• Panel (possible to use, for just a box around text)

Hyperlinks

Use Scroll Wiki PDF export Linking options so that you can:

• Add page numbers to internal links
• Add URL to external links, and
• Disable links to this Confluence system (which keeps non-exported page links from being converted to absolute links)

Do NOT use monospacing on the text you are using as a link

Images

Importing

Attachments option from edit screen allows particular pages to have specific images and keeps track of all images ever included on that page. (You can use it to upload an image then insert it in the page with wiki-markup.)

To insert an image choose one of the following:

• Use Insert > Image (will make the title and name of the image its uploaded file-name)
• Use wiki-markup (e.g. !example.gif! so that the name of the image is not used as a caption when exporting

Exporting

The default Insert > Image option of adding an image to a page makes file-name of the image show up as a caption below the image when it is exported (including the file-extension of .gif, .png, .jpg, etc.)

To remedy this, use wiki-markup when inserting an image and include |title="" so it looks like !example.gif|title=""!