Versions Compared

Key

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

...

Document Properties Marker
overridefalse


Short DescriptionTables often require a lot of space to be rendered. This tip shows how to reduce the demand of space. 
Doctypetopichide
NameCompact Columns 
Short Name 
Parent
Parent Property
propertyParent
property-nameName
 
Audience

Name List
doctyperole
render-no-hits-as-blanktrue
namesAuthor
propertyAudience

 
Level of Experience

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

 
Expected Duration15 min 
Subject
Name List
doctypesubject
propertySubject
 
Categories
Name List
doctypecategory
propertyCategories
 
Tags

Tag List
render-list-as-comma-separated-valuestrue
namesConfluence, projectdoc Toolbox, table, column, document properties, property, value
propertyTags

hide
Iteration

Iteration
valueproduction

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
enable-heading-numbersfalsehide


...

Section
show-titlefalse
titleDescription

Tables often require a lot of space to be rendered. Definition list allow a more compact presentation of information. But for tabular data with more than two columns, the table is typically the right choice. Tto reduce the amount of required space, the values of more than one property can be rendered in one column.

This tip shows how to do this with the PDAC1 for Confluence.


Section
titleSummary



Section
titleDisplay Three Column Table Macro

The Display Table Macro allows to render matching documents in rows of a table. It also allows to select the properties to render in table columns.

Select: Name, Level of Experience|, Expected Duration|


Section
titleTwo Column Table

Since version 2.3 of the PDAC1, the rendering of columns can be configured by a template. For this example we decide to render the Level of Experience and the Expected Duration properties together in one column.

The template for the column is marked by a hashmark (#) followed by the name of the column. The template for rendering values is enclosed in curly braces.

Name, #Requirements{${Level of Experience} (${Expected Duration})}


Section
titleConclusion

The second table contains the same information as the first one. Since it is rendering the information in two instead of three columns, the table is smaller.

This does not imply that rendering multiple columns in one column is generally a good idea. But for some use cases having related information compact in one column may make is easier for readers to scan the content.

...