TOC is not being created when I export a space to PDF, what am I doing wrong?

[Trina Peck]

I've read the information here: https://confluence.atlassian.com/display/AOD/Customising+Exports+to+PDF#CustomisingExportstoPDF-TableofContents

but still do not have a toc in my PDF.

When I read the above link it says that "By default, a table of contents will be generated after the title page, or at the beginning of the PDF document if no title page is defined in the PDF Layout. To see the default CSS rules applied to the table of contents, download the default CSS rules (confluencedefaultpdf.css) and examine the specific rules with toc in their name."

I have a title page but no toc, anybody have any ideas? Do I need to add html based on the css to "PDF Space Export Title Page"?

Here is the code I'm using for my title page in the layout if that helps:

<div class="fsTitlePage">  
   <div style=" text-align:right">  
   <img src="/download/attachments/3309581/ctCRE.png"/>  
</div>  
<div class="fsTitle">Enter Release name</div>  
<div class="fsTitlesub">Release Review</div>  
<div class="fsTitlesubsub">Status: Final <br> Version: 1.0 <br> Date Revised: July 23, 2013 </div>  
</div>

[Steffen Heller · Accepted solution]

I never heard of Space > Space Tools > Content Tools > Export. Is that the OnDemand version?

Anyways, seems like you use that form of export where you can include multiple pages. If you do exactly that (=> select multiple pages) and do not only choose "the one page that I need to export" then you should get a proper toc.

The reason is that this(!) toc is created not from the headings within a single page but from the page titles of the chosen pages. If you choose only one page then there is nothing that a toc could be created from. The toc contains only one entry and this one is presented without page numbers. If you add more pages the toc gets its entries and these are presented with page numbers.

[Trina Peck]

Yes, I'm using On Demand.

And ugh, not the answer I wanted. :)

Thanks for your help.

[Steffen Heller]

If you choose "Output Type=list" from the "Edit" menu the {toc} macro should create a toc in the form of a normal list (with <ul> and <li>)

The appearance of that list can be adapted and refined with CSS that you enter at Browse > Space Admin > Look and Feel > PDF Stylesheet > PDF Export Stylesheet

If you want page numbers and a dotted line you can use

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

To avoid that all other hyperlinks on your page also get page numbers you better put your toc into another css class. For this you enter some_class_name (choose whatever you like) at "CSS Class Name" from the Edit menu of the {toc} macro and put exactly that some_class_name before the "a:after" so that you get ".some_class_name a:after" (don't forget the dot at the beginning).

[Christian Sprenger]

Exactly what I was looking for.

Thank you very much :)

[Steffen Heller]

@Trina

If you have a single page and you want to create a toc from the headings within this page then you can use the {toc} macro. That(!) toc appears at exactly the place where you put it, both on the confluence page and in the exported PDF.

If it is important to you that this toc appears on a separate page then just put it at the top of your page and include a pagebreak right after it. You can include a pagebreak using the {div} macro and

page-break-after: always;

at the input field "Styles" from the "Edit" menu of the {div} macro (there are numerous other ways to do it).

[Trina Peck]

Thank you Steffen.

But how do I get page numbers in that TOC? Is it possible if I set up my {div} correctly?

Thoughts?

[Deleted user]

Forgive me if this is too basic. Have you applied 'heading' styles (h1, h2, h3 etc) to your pages? ... any generated toc looks for heading styles to build from. If you've only formatted headings by applying bold, larger font sizes etc., then the toc generator will have nothing to work with.

[Steffen Heller]

How do you export your pages? Do you export with Browse > Advanced > PDF Export and not with Tools > Export to PDF?

[Trina Peck]

I am using the heading styles in Confluence. I can create a table of contents using both of the TOC macros but that doesn't give me a separate page for the TOC when I PDF, just adds it on top of my first page after my Title page.

I'm using the advanced pdf export. Space > Space Tools > Content Tools > Export. I choose Custom Export and select just the one page that I need to export.