Versions Compared

Key

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

...

Section
titleDetails

Some details on how to use this tool.

Section
titleExperimental Status

This feature has been release with version 5.0 of the projectdoc Toolbox as experimental.

The basic functionality is there, but some fine tuning is still required. For instance accessibility is missing. You need to use the mouse to get the macros collapsed and expanded. The controls are not yet very intuitive, meaning: if you do not know the feature, you will probably not learn it without reading this documentation.

Feedback is welcome!


Section
titleWhat does it do?

Consider this page at an early stage.

And this is the same page where every section without content is collapsed (using Ctrl+Shift-Click on a macro chrome - for instance the title of a

Static Document Link
documentSection Macro
).

You can easily toggle each macro, toggle all macros or toggle all macros with an empty body.


Section
titleHow does it work?

You need to click on the chrome, for instance on the macro head.

ActionResult
Shift-ClickToggle the state (collapsed / expanded) of the selected macro.
Ctrl-ClickToggle the state (collapsed / expanded) of all macros dependent on the state of the macro you actually clicked. If the macro is collapsed, all macros will be expanded. If it is expanded, then all macors will be collapsed.
Shift+Ctrl-ClickToggle the state of all macros whose body is considered to be empty. The body is considered empty, if it contains no text. For instance a macro with placeholder text (the text that tells you what a section is intended for) or with another macro in its body is considered empty.
Click on collapsed macroExpands the macro (as would Shift-Click, but easier).



Section
titleHow is it integrated?

Users in the group of confluence-administrators are able to activate (default) and deactivate the feature on the Features control panel.

In case you find this feature confusing or it interferes with other tools you use on your Confluence platform, simply deactivate it.

Warning Box
titleSection titles not rendered?

This feature adds the chevron image to the macro chrome. This may interfere with other third-party apps. One consequence could be that no chrome is rendered.

In this case you may either need to deactivate the Section Expander of the projectdoc Toolbox or the third-party app.

The feature may also only be activated for the listed Confluence groups. If no group is specified there is no restriction.

Administrators may also specify the names of macros that use the feature to collapse and expand.

You may use a wildcard at the end of the macro name which will match all macro names with the given prefix.

Example Box
titlePrefix Match

The macro name projectdoc-box-* matches projectdoc-box-caution, projectdoc-box-warning, and any other macros whose name starts with projectdoc-box-.

So all box macros provides by the projectdoc Toolbox will use this feature.

Note that you are not restricted to macros provided by the projectdoc Toolbox. section, expand, and panel are macros provided by Confluence.


...