projectdoc Toolbox

Tables often require a lot of space to be rendered. This tip shows how to reduce the demand of space.

Parent
Audience
Level of Experience
Expected Duration
15 min
Type

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 projectdoc Toolbox for Confluence.

Three Column Table

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|

Two Column Table

Since version 2.3 of the projectdoc Toolbox, 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})}

Conclusion

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.


Resources

Information on related topics.

Document Properties
Properties are metadata that can be added to every projectdoc document. If you require a set of metadata for each instance of a document type, you should write your own doctype.
Display Table Macro
Lists references to projectdoc documents in a table. Allows to select document properties for columns. Also non-list representations are provided.
Display Document Properties Macro
Renders a template with property references.