Re: Code for publishing PDF from Confluence

[Robert Lauriston <robert -at- lauriston -dot- com>]

I've been using Confluence as my authoring environment for a year. It
works well, but I don't believe it's possible to get the native PDF
output to look professional.

https://answers.atlassian.com/questions/185951/documentation-pdf-export-a-la-atlassian-s

After spending a lot of time trying and not getting the information I
needed from Atlassian support, I gave up and have been using Scroll
PDF Exporter. Here's the custom content formatting CSS I use:

/* Enable heading numbering */
/* commented out by Robert */
/* @import url('css/common-heading-numbering.css') print; */

/* Enable toc numbering */
/* commented out by Robert */
/* @import url('css/common-toc-numbering.css') print; */

/* Generate border between header/footer and page content */
@page {
  border-top: 1px solid black;
  border-bottom: 1px solid black;
}

/* Export on title page */
div.titlepage {
  position: relative;
  min-height: 220mm;
}
div.titlepage .static {
  position: absolute;
  bottom: 0;
}

.titlepage .exportinfo {
  padding: 2mm 5mm;
/*  background-color: #eeeeee; */
}

.titlepage .exportinfo strong {
  width: 20mm;
  display: block;
  float: left;
}

/* **** Robert's additions start here *** */

/* heading, paragraph, and character style overrides */

h1, h2, h3, h4, h5, h6 {
  page-break-after: avoid;
  font-weight: bolder;
  font-family: SourceSansPro;
  -fs-keep-with-inline: keep;
}

h1 { font-size: 2em; margin: .67em 0 }
h2 { font-size: 1.5em; margin: .75em 0 }
h3 { font-size: 1.17em; margin: .83em 0 }
h4 { font-size: 1em; margin: 1.165 em 0 }
h5 { font-size: .83em; margin: 1.5em 0 }
h6 { font-size: .75em; margin: 1.67em 0 }

body { font-family: SourceSansPro; }

p { font-size: 10pt; line-height: 12pt; margin: 0 0 6pt ; }

/* .wikicontent excludes TOC from change*/
.wikicontent ol,
.wikicontent ul {
margin-bottom: 6pt;
margin-top: 6pt;
}

/* add headers when table crosses page break */

div.tablewrap table.confluenceTable {
  -fs-table-paginate: paginate;
  border-collapse: separate;
  border: 1px solid #DDDDDD;
  border-spacing: 0px;
 }

/* set monofont */

tt, code {
  font-family: DejaVuSansMono;
  font-size: 8pt; }
pre {
  font-family: DejaVuSansMono;
  font-size: 8pt;
  line-height: 10pt; }

/* override TOC formatting */

ul.toc a:link { color: black; }

ul.toc a::after {
    content: leader(dotted) target-counter(attr(href), page);
}

/* wrap pre text - disabled due to bug
   see https://k15t.jira.com/browse/EXP-501

pre {
white-space: pre-wrap;
word-wrap: break-word;
} */

pre {
word-wrap: break-word;
} *


/* avoid bad page breaks */

div.section-1 {
page-break-before: always;
}

/* for keep-with-next-p macro */

li.keep-with-next, p.keep-with-next {
page-break-after:avoid;
}



On Tue, Jul 8, 2014 at 4:09 AM, Melanie Albrecht
<melanie -dot- albrecht -at- gmail -dot- com> wrote:
> Hello
>
> Next week, I start a new job, writing doc for users and administrators of a
> big complex security software product.
>
> The Development team already use Confluence for their internal wiki,  and I
> am considering using it to also write the doc. However, the boss really
> wants me to be able to publish as PDF.
>
> The internet tells me that you can configure Confluence to produce a
> pleasant-looking PDF,  using CSS and HTML.
>
> However, I have not been able to find any examples. I can write clean HTML
> and really basic CSS, but I have no idea where to start with this.
>
> Do you know of any examples?
>
> Also, do you have any opinions about the sensibleness of authoring in
> Confluence and publishing to PDF?
>
> Thanks,
> Melanie
>
>
> ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
> Doc-To-Help 2014 v1 now available. SharePoint 2013 support, NetHelp enhancements, and more. Read all about it.
>
> Learn more: http://bit.ly/NNcWqS
>
> ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
>
> You are currently subscribed to TECHWR-L as robert -at- lauriston -dot- com -dot- 
>
> To unsubscribe send a blank email to
> techwr-l-leave -at- lists -dot- techwr-l -dot- com
>
>
> Send administrative questions to admin -at- techwr-l -dot- com -dot-  Visit
> http://www.techwhirl.com/email-discussion-groups/ for more resources and info.
>
> Looking for articles on Technical Communications?  Head over to our online magazine at http://techwhirl.com
>
> Looking for the archived Techwr-l email discussions?  Search our public email archives @ http://techwr-l.com/archives


^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Doc-To-Help 2014 v1 now available. SharePoint 2013 support, NetHelp enhancements, and more. Read all about it.

Learn more: http://bit.ly/NNcWqS

^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

You are currently subscribed to TECHWR-L as archive -at- web -dot- techwr-l -dot- com -dot- 

To unsubscribe send a blank email to
techwr-l-leave -at- lists -dot- techwr-l -dot- com


Send administrative questions to admin -at- techwr-l -dot- com -dot-  Visit
http://www.techwhirl.com/email-discussion-groups/ for more resources and info.

Looking for articles on Technical Communications?  Head over to our online magazine at http://techwhirl.com

Looking for the archived Techwr-l email discussions?  Search our public email archives @ http://techwr-l.com/archives