Versions Compared

Key

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

...

Document Properties Marker
doctypemacro
overridefalse


Doctypemacrohide
NameWarning Box Macro 
Short DescriptionRenders a hint to warn the reader about something.
Name Warning Box Macro
Parent
Parent Property
property-nameName
 
Audience
Name List
doctyperole
render-no-hits-as-blanktrue
render-list-as-comma-separated-valuestrue
namesAuthor
 
Categories
Name List
doctypecategory
render-no-hits-as-blanktrue
namesBox / Reader
 

Tags

Tag List
namesBox

, Standard

 
Iteration
Iteration
valueproduction
hide
Sort Keyhide


...

Section
indextrue
show-titlefalse
titleDescription

According to The version box macro allows to provide version-specific information in a visual box.


authors should stick to the industry standard of using note, tip, warning, and caution boxes.

The warning box is used as follows:

projectdoc-section
titleProperties

The macro provides the following properties for configuration.

Section
titleTitle

The title is an optional parameter. If no title is provided, a standard title is constructed based on the values of Since and Until.

Here is an example with title:

Version Box
titleTitle of the version box

This is the text in a version box

cite
template$[Name] (${Authors})
documentPDAC:Ament2003
Quote
source-wiki-pagePDAC:Ament2003
Negative alert that a particular action can result in physical harm to users, or can result in damage to hardware

.



Section
title
Properties
Since

Provide a version number since when the information of the box applies.

Here is an example with since and no title:

Version Box
since1.23

This is the text in a version box

The macro provides the following properties for configuration

.



Section
titleTitleUntil

Provide a version number until when the information of the box appliesThe title is an optional parameter.

Here is an example with since and until (but no title):

projectdoc-box-warning
titleThe title of the Warning Box
version
until2.42
since1.23

This is the text in a version box This is a warning message.



Section
titleShow Icon

The checkbox allows to remove the icon from the box.

projectdoc-box-warningversion
titleThe title Title of the Warning Boxversion box
show-iconfalse

 This This is a warning messagethe text in a version box.



Section
titleTags

Tag the box to use for transclusion.

By default the tag warningversion-box is  is added.



box-versionDetails
projectdoc-
since2.3

Transclusion for boxes is supported since version 2.3.

Section
titleDetails


Section
titleExample for a Version Box

The version box in the page editor.

Image Added

The rendered version box in the page view mode.

Image Added

Section
title


Transclusion
documentprint-quirk-modes Hint for Box Macros
idsContent


...