PDF Export Macros



About

(info) The scope of this plugin is to add support for better presentation PDF documents in a minimalist way. The primary users of this should be the ones focused on using confluence mostly for writing technical documentation and other software development associated documentation, however, this is not limited to that and can be used by others who would require such a feature. 


(info) See it in action, export this page. (We tried to spice the export process so this sample page is created by aggregating several pages).

.

Working with macros

One should work with the provided macros, just like it would work with any macro type, click the top bar button  and select the macro.

(info) For advanced users: type one of the characters { or / and then provide the name of the macro you want to use.


(lightbulb) You can easily filter out other macros by writing PDF in the focused filter box.

Export tool macros       

PDF Hidden Content macro

(lightbulb) Screen visible

Using the PDF Hidden Content macro one is able to add any presentation scoped content to a page, without being worried about how this content will look when exported in PDF documents.


Drop inside the added block any content you would like to hide from being printed in PDF documents.

PDF Only Content macro 

(grey lightbulb) Screen is hidden

For the PDF Only Content macro, you will be able to write anything and the content you wrote will be seen just in the edit page and after you export it to PDF.




Page Title macro

For the PDF Page Title macro, you will be able to put the page title in a set of element style wherever you want.






Tips and Hints

Confluence supports two primary export types :

  • Export page to PDF
  • Export space to PDF (You can select a set of )

Sample CSS code for customizing your Export Page result. 

(warning) Please be careful and perform the following tuning at your own risk, it might interfere with some other CSS customization (if applied by any other company members) .

Sample css export code.
.first-page-title { 
 content: "PDF Export Tools";
 font-size: 50pt!important;
 color: #3b7fc4;
}

.pagetitle h1 {
   position: running(runningheader); 
   font-size: 10pt!important;
   color: #3b7fc4;
}

div.toc{
  width: 160mm;

}

div.toc a{
  font-size: 10pt!important;
}
div.toc a::after {
  content: leader('.') target-counter(attr(href), page);
  color: #3b7fc4;
}

div.toc ul{
list-style-type: none;
}

@page
{
    /*The A4 paper size is 210 mm wide by 297 mm long*/
    size: 210mm 297mm;
    border-top: 1px solid #3b7fc4;
    border-bottom: 1px solid #3b7fc4;
   @top-left
    {
        content: element(runningheader);
       font-family: ConfluenceInstalledFont, Helvetica, Arial, sans-serif;
       font-size: 10pt!important;
        margin-bottom: -10px;
       color: #00677f;
    }

    @top-right
    {
       content: "           PGAConsult";
       color: #3b7fc4;
       font-family: ConfluenceInstalledFont, Helvetica, Arial, sans-serif;
       font-size: 10pt!important;
       text-align: right;
      margin-bottom: -10pt;
    }
    @bottom-center
    {
        content: "Page " counter(page) " of " counter(pages); /* This is the content that will appear in the footer */
        font-family: ConfluenceInstalledFont, Helvetica, Arial, sans-serif;
        font-size: 8pt;
        color: #00677f;
        margin-top: -10px;

    }
    /* Any other page-specific rules */
}

/*All other settings*/
a
{
    text-decoration:none;
}

div.titlepage,div.toc
{
    page:title;    
}

img
{
   page-break-inside: avoid;
   -fs-fit-images-to-width:6in;
}