Confluence - Chapter 4

Structure Above Else


Datasource Pages

Just like it sounds, a Datasource Page is where you consolidate information. With Macros like Multiexcerpt and Table Include, you can save yourself a ton of headaches by keeping your source of truth and attached pages in sync.

If you ever change the name or something on the datasource page, it won’t break the pages that depend on it—it updates automatically. So go ahead, get creative!

Structure

Example

The reusable content can be anything that you can place in that box, so be either text or image it can be there. Of course, with the exception of tables which have their own macro to do that.

multiexcerpt-example

To include something you have to use the multiexcerpt include macro which will display you the available options in the page and a small preview of the content retrieved:

multiexcerpt-include-macro-menu

From the edition menu will look like this:

multiexcerpt-include-macro-example

Tagging

Live Search gets even better when you’re using proper tagging, so take the time to tag your content wisely.

Go to Types of Pages for more inspiration.

Security & Limitations

Not much to say, just to complain.

References

There isn’t much from Confluence but there are a few sources that are worth looking: