Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Section


Column


Document Properties Marker
overridefalse


Short DescriptionReusing sections typically includes the transcluded content to match the document structure of the transcluding document. The projectdoc Toolbox does this automatically.
Doctypetopichide
NameHeading Level Transposition
Short Name
Parent
Parent Property
propertyParent
property-nameName
hide
Audience

Name List
doctyperole
render-no-hits-as-blanktrue
render-list-as-comma-separated-valuestrue
namesDocumentation Architect, Author
propertyAudience


Level of Experience

Name List
doctypeexperience-level
render-no-hits-as-blanktrue
namesAdvanced Beginner
propertyLevel of Experience


Expected Duration15 min
Subject
Name List
doctypesubject
propertySubject

Categories
Name List
doctypecategory
propertyCategories

Tags

Tag List
namestransclusion, Confluence, macro, excerpt, multi-excerpt, section, projectdoc Toolbox
propertyTags

hide
Iteration

Iteration
valuefinished

hide
Type

Name List
doctypetopic-type
render-no-hits-as-blanktrue
namesTip
propertyType


Sponsors
Name List
doctypestakeholder
render-no-hits-as-blanktrue
propertySponsors

Sort Keyhide



Section
show-titlefalse
titleDescription

To make the management of information in Confluence easier, information should be stored in one location and one location only. When there is the need for changing this information it requires the change to be applied only to one location. That is easy from the author's point of view.

On the other side is the reader who needs to see this piece of information in different contexts, that is on different pages. To make this information, that is stored in one location, visible on in multiple pages, the page author uses a tool called transclusion (or excerpt/excerpt include in Confluence lingo). This transclusion provides an invisible link to the content on another page. Whenever the content is updated on its page, this change is immediately (at request time) visible on the pages that transclude this content.

If you happen to transclude a section hierarchy and not just plain text or a graphic with an explaining paragraph, the level of the section titles need to be adjusted to the level in the transcluding page. We call this process of adjusting the heading level 'heading level transposition ' or 'transposition' for short. This feat is done by the PDAC1 automatically. This short tip shows you how.



Column
width425px

The right page transcludes content from the left page using heading level transposition.

Panel
titleContents
Table of Contents
outlinetrue
indent10px
stylenone



...

Section
titleResources

Related information to sections and their use in transclusions.

Tour
render-as-definition-listtrue
replace-title-with-nametrue



List of tips related to transclusion.

Display Table
doctypetopic
render-modedefinition
where$<Type>=[Tip] AND $<Tags>=[Transclusion]

...