projectdoc Toolbox
Note Box Macro
Renders something to note by the reader.
According to Single Sourcing - Building Modular Documentation (Kurt Ament) authors should stick to the industry standard of using note, tip, warning, and caution boxes.
The note box is used as follows:
Neutral or positive clarification that applies only in special cases, or that qualifies important points. Kurt Ament. Single Sourcing - Building Modular Documentation. 2003
Neutral or positive clarification that applies only in special cases, or that qualifies important points.
The macro provides the following properties for configuration.
The title is an optional parameter.
Here is an example with title:
The title of the Note Box
This a note for the reader.
The checkbox allows to remove the icon from the box.
Tag the box to use for transclusion.
By default the tag note-box is added.
note-box
Since 2.3
Transclusion for boxes is supported since version 2.3.
To export a page using this macro with K15t Scroll Office the Print Quirk Modes should be enabled.
Here is a list of alternative boxes to use for your texts: