Template:NB: Difference between revisions

Revision as of 13:15, 18 February 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 #2FB5AB; padding: 5px; background: #F3FCFB"
-    {{!}} '''<span style="color: #2FB5AB;">{{{4|Mind:}}}</span>''' {{{2}}}
+    {{!}} '''<span style="color: #35CABF;">{{{4|Mind:}}}</span>''' {{{2}}}
     {{!}}}
   | deprecated = {{{3|}}}{{{!}} style="border: 0px solid #808080; padding: 5px; background: #F7F7F7"
-    {{!}} '''<span style="color: #808080;">{{{4|Deprecated:}}}</span>''' {{{2}}}
+    {{!}} '''<span style="color: #424242;">{{{4|Deprecated:}}}</span>''' {{{2}}}
     {{!}}}
   | tip        = {{{3|}}}{{{!}} style="border: 0px solid #2C68FC; padding: 5px; background: #F0F4FF"
-    {{!}} '''<span style="color: #2C68FC;">{{{4|Tip:}}}</span>''' {{{2}}}
+    {{!}} '''<span style="color: #3E70EA;">{{{4|Tip:}}}</span>''' {{{2}}}
     {{!}}}
   | warning    = {{{3|}}}{{{!}} style="border: 0px solid #A82C35; padding: 5px; background: #FCF3F4"
@@ Line 13: / Line 13: @@
     {{!}}}
   | important  = {{{3|}}}{{{!}} style="border: 0px solid #4C265F; padding: 5px; background: #F8F4FB"
-    {{!}} '''<span style="color: #4C265F;">{{{4|Important:}}}</span>''' {{{2}}}
+    {{!}} '''<span style="color: #8342A4;">{{{4|Important:}}}</span>''' {{{2}}}
     {{!}}}
   | #default   = {{{3|}}}{{{!}} style="border: 1px solid #000000; padding: 5px; background: #FFFFFF"