Using heading numbers with the projectdoc Toolbox for Confluence is based on the Section Macro and a couple of space properties.

This short tip shows how to use this feature.

Some features are only available since version 3.0.

Using heading numbers for sections in your projectdoc Document is very easy.

There is less easy to deal with page titles, if no tool is used to support this use case. We show and briefly discuss two approaches to get the desired result.

This tip assumes that you know

1. what a space is
2. the basic use cases for the Section Macro
3. how to use document properties and space properties

For some use cases we discuss in this tip you need to have the HTML Macro installed and/or have space admin rights.

For more information on space hierarchies please refer to the Space Hierarchies section in projectdoc Introduction.

The projectdoc Toolbox takes the values you enter as property names, values and controls as is. If you add HTML markup for any reason, the projectdoc Toolbox assumes that you know what you are doing. In case you copy-paste text from a page shown in your browser, there may be markup you do not want to paste. Be careful here!

For more information please have a look at Cannot access Property from a Document.

This looks identical as when setting a space property on the space homepage. This implies, that heading numbers on the page homepage will activate heading numbers for all pages.

Note that in case you need to print the document, the summary has a numbered heading.

To prevent this issue, you may choose to not show the title and have the Description and the Summary section collapsed. Printing is then no issue since there is no heading.

Suppose you need to extract the sections Space Relation, Providing Spaces, and Collaboration Spaces to their own documents. This way you may have easier content reuse, you may collaborate easier if each content is created by another author, any you may reference the individual sections easier if they have their own unique URL.

Let's use the Section Doctype to create a document for each of the three sections we extract and the Transclude Documents Macro to integrate them with the original document.

e

A section document looks like this:

To create the same heading number as in the transcluding document, you need to set the number start (heading-number-start) to 1.0 and the heading starting level (heading-starting-level) to 2.

Now the section headings align with the numbers shown in the transcluding document.

The configuration for the second transcluded section requires the number start (heading-number-start) to be set to 2.0.

The rendered document would render like this:

As you may already have notices, the numbering of the section does still not align. Headings have no numbers per default.

To change this you need to apply a CSS style to your Confluence site configuration or to your space configuration. This CSS may be different according to your layout tool you employ.

Here is one way to achieve the heading numbering for the transcluding document and all its sections for a standard Confluence environment. Using a layout tool may make the issue much simpler.

h1#title-text:before {  
   counter-increment: h1;  
   content: counter(h1) " ";  
}

h1#title-text:before {  
counter-reset: h1 !important;
counter-increment: none !important;
content: "" !important;
}