Introduces to the concept of content to be considered to be empty.
Hiding Template Buttons
The Create-from-Template Macro allows authors to add a HTML Button to create a new page based on a given template. The projectdoc Toolbox uses this feature in a large number of templates to make it easy to create documents of a given type that is closely related to the doctype of a document. For instance the Day doctype to add pages to a journal allows to add documents of type Event.
Since the journal is a tool the author is mainly working with to add content, it is okay to have the buttons right at hand to create new Assets, Events, and Todos. This may be not appropriate in case the document is more often read than written to. In these cases we would like to force the readers not to see the empty sections for Assets, Course of the Day, and Todos of the Day. To do so we simply need to check the parameter Ignore Template Buttons of the Section Macro.
The following screen shot show the same example as above, but the Ignore Template Button parameter is checked for Assets and Todos of the Day.
Once we add an asset document, the Assets section is no longer empty and rendered. This also brings the Create Asset button into display.
Empty 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.
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.
Intro 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.
