Versions Compared

Key

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

...

Section
titleEmpty Content

The concept of Empty Content takes the Ignore Template Buttons a step further. Now authors may wrap any content inside a Content Marker Macro or Section Macro and tag it to be considered empty. If a section of text only contains content that actually has content, but is to be considered empty, that section will not be shown.

Consider Empty Parameter of the Section MacroImage ModifiedConsider Empty Parameter of the Content Marker MacroImage Added

What is this good for? Consider to have document that renders a list of other documents. The document could be a release document with a list of breaking changes that are part of that release. You may want to display introductive text to make the section be more pleasant to read, especially to for the casual reader. If this text could not be tagged as empty content, the section showing the list of breaking changes will always be rendered, independent of the fact if there are actually breaking changes.

Note Box
titleIntro and Extro Texts

The Section Macro already provided parameters to add text as intro or extro. These texts are required to be plain. No markup, such as a adding a link, is allowed. The new feature now allows to tag arbitrary text content as empty.

The following shows the use of the Content Marker Macro with the Consider Empty parameter set to true.

As long as the Display Table Macro has not result (and has the Render no Hits as blank parameter set to true) the section above is not rendered.

...