Template:NB: Difference between revisions

Latest revision as of 09:57, 4 March 2025

{{{2}}}

Purpose

This template draws various colored boxes which can be filled with user content. Should be used to replace instances of N.B.: or similar.

Parameters

 {{NB|<style>|<message>|<<indent>>|<<firstword>>}}

style: One of tip,deprecated,mind,warning,important, selects the box style, i.e. the color and the first word (see examples below). If style is not any of the words in the list, a black box without first word is drawn.
message: The content of the box (after the first word).
indent: (optional) Allows to indent the whole box with regular colon sign. Use multiple ":" signs to get any level of indentation. Can be left empty if no indentation is needed but firstword is required. Any other character than ":" may produce unexpected results!
firstword: (optional) Overrides the default first word for any of the predefined styles.

Examples

Regular usage

Without optional arguments these boxes are available:

 {{NB|tip|This is the clever way of doing it!}}

 {{NB|deprecated|This feature is deprecated and will be removed in the next release}}

 {{NB|mind|You can manually set this via '''SOME_TAG'''}}

 {{NB|warning|Never do this at home!}}

 {{NB|important|You should really consider this!}}

 {{NB|none|Just a box.}}

will produce

Tip: This is the clever way of doing it!

Deprecated: This feature is deprecated and will be removed in the next release

Mind: You can manually set this via SOME_TAG

Warning: Never do this at home!

Important: You should really consider this!

Just a box.

Special features

Replacing the first word while sticking to the warning color scheme (note the empty third argument):

 {{NB|warning|Really, really don't do this!||CAUTION!!!}}

CAUTION!!! Really, really don't do this!

Indenting with default first word:

 {{NB|tip|This is indented one level.|:}}
 {{NB|tip|This is indented two levels.|::}}

Tip: This is indented one level.

Tip: This is indented two levels.

Problems and workarounds

The message cannot contain the "=" character because this has a special meaning for named template parameters. Therefore, we have to use the {{=}} template instead:

{{NB|tip|We highly recommend '''MY_TAG''' {{=}} 42}}

Tip: We highly recommend MY_TAG = 42

Note that using an indented box within a list requires the text after the box to be indented manually:

 * First item
 {{NB|tip|Second item is also great!|:}}
 :Some more text belonging to first item
 * Second item

First item

Tip: Second item is also great!

Some more text belonging to first item

Second item

Unfortunately, when using numbered lists the item counter is reset when a box is inserted and requires manual setting of the start value with the li value tag:

 # Option A
 {{NB|warning|Option B should be avoided!|:}}
 :Some more text belonging to first option
 # <li value="2"> Option B

Option A

Warning: Option B should be avoided!

Some more text belonging to first option

Option B

@@ Line 1: / Line 1: @@
 {{#switch: {{{1}}}
-  | mind       = {{{3|}}}{{{!}} style="border: 0px solid #35CABF; padding: 5px; background: #c4f5f1"
+  | mind       = {{{3|}}}{{{!}} style="border: 0px solid #35CABF; padding: 5px; background: #D9F8F5"
     {{!}} '''<span style="color: #35CABF;">{{{4|Mind:}}}</span>''' {{{2}}}
     {{!}}}
@@ Line 9: / Line 9: @@
     {{!}} '''<span style="color: #3E70EA;">{{{4|Tip:}}}</span>''' {{{2}}}
     {{!}}}
-  | warning    = {{{3|}}}{{{!}} style="border: 0px solid #A82C35; padding: 5px; background: #eb9198"
+  | warning    = {{{3|}}}{{{!}} style="border: 0px solid #A82C35; padding: 5px; background: #F1B3BA"
     {{!}} '''<span style="color: #A82C35;">{{{4|Warning:}}}</span>''' {{{2}}}
     {{!}}}
-  | important  = {{{3|}}}{{{!}} style="border: 0px solid #8342A4; padding: 5px; background: #d1aae6"
+  | important  = {{{3|}}}{{{!}} style="border: 0px solid #8342A4; padding: 5px; background: #DEC4EB"
     {{!}} '''<span style="color: #8342A4;">{{{4|Important:}}}</span>''' {{{2}}}
     {{!}}}