Template:Admon/tip/doc: Difference between revisions

Revision as of 13:01, 4 November 2014

This is a documentation subpage for Template:Admon/tip.
It contains usage information, categories and other content that is not part of the original template page.

Usage

{{Admon/tip}} creates an information box with a custom text denoting that something is to be considered as a tip/help text. The box will show at the position on the page where you put the template, and stretch horizontally to fill the width of the available space and vertically depending on how many rows of text are needed.

To use the template, type {{Admon/tip|header|message body}}.

Parameters

There are two unnamed parameters for the header and the message body, respectively (below called 1 and 2). The text inside the box can be formatted using wiki-code.

Header

1: Custom text

The first parameter is the header, and is automatically formatted as bold text. Thus, any text you enclose in three apostrophes (for bold text) in this field will be inverted (i.e. show as plain text). If you don't want to use a header, skip the header parameter by entering two pipes before the body text, leaving the header parameter empty, like so: {{Admon/tip||message body}}.

Usage:

{{Admon/tip|'''header'''|message body}}

Body text

2: Custom text

The second parameter is the message's body text, and is not pre-formatted. If you don't want to use any body text, you can skip the second parameter altogether, and only enter the header parameter, like so: {{Admon/tip|header}}.

Usage:

{{Admon/tip|header|'''message body'''}}

Examples

Example case	What you write	What you see
Only header	`{{Admon/tip\|The first parameter is automatically formatted as bold text.}}`	The first parameter is automatically formatted as bold text.
Only body text	`{{Admon/tip\|\|This is shown as plain text.}}`	This is shown as plain text.
Header and body text	`{{Admon/tip\|This is the header\|This is the body text.}}`	This is the header This is the body text.
Wiki-coding	{{Admon/tip \|Wiki-formatting for '''bold text''' is inverted in the header \|The ''other rows'' '''behave as''' '''''normal'''''. <br /> You can use wiki-code to, e.g. [[link to stuff]], * list things, make text <small>small</small> or <big>big</big>, and include pre-format boxes. You can even insert empty rows.}}	Wiki-formatting for bold text is inverted in the header The other rows behave as normal. You can use wiki-code to, e.g. link to stuff, list things, make text small or big, and include pre-format boxes. You can even insert empty rows.

@@ Line 2: / Line 2: @@
 __NOTOC__
 ==Usage==
-{{tl|Admon/tip}} creates an information box with a custom text denoting that something is to be considered as a tip/help text. The box will show at the position on the page where you put the template.
+{{tl|Admon/tip}} creates an information box with a custom text denoting that something is to be considered as a tip/help text. The box will show at the position on the page where you put the template, and stretch horizontally to fill the width of the available space and vertically depending on how many rows of text are needed.
-To use the template, type <code><nowiki>{{Admon/tip|text}}</nowiki></code>.
+To use the template, type <code><nowiki>{{Admon/tip|header|message body}}</nowiki></code>.
 ==Parameters==
-There is only one parameter, the custom text.
+There are two unnamed parameters for the header and the message body, respectively (below called <code>1</code> and <code>2</code>). The text inside the box can be formatted using wiki-code.
-===Custom text===
+===Header===
-The text inside the box can be formatted using wiki-code.
+'''<code>1</code>''': Custom text
-;Header
+The first parameter is the header, and is automatically formatted as '''bold text'''. Thus, any text you enclose in three apostrophes (for bold text) in this field will be inverted (i.e. show as plain text). If you don't want to use a header, skip the header parameter by entering two pipes before the body text, leaving the header parameter empty, like so: <code><nowiki>{{Admon/tip||message body}}</nowiki></code>.
-The first line of the box's textual part functions as the header, and is automatically formatted as '''bold text'''. Any text wiki-formatted to show in bold will be inverted (i.e. show as plain text). If you don't want to use a header, start the custom text part with an empty line.
-;Body text
+'''Usage:'''
-The lines beneath the first line are not pre-formatted.
+* <code><nowiki>{{Admon/tip|'''header'''|message body}}</nowiki></code>
-==Examples==
+===Body text===
-===Only header===
+'''<code>2</code>''': Custom text
-The string
- <nowiki>{{Admon/tip|The first line is automatically formatted as bold text.}}</nowiki>
+The second parameter is the message's body text, and is not pre-formatted. If you don't want to use any body text, you can skip the second parameter altogether, and only enter the header parameter, like so: <code><nowiki>{{Admon/tip|header}}</nowiki></code>.
-will show as
+'''Usage:'''
+* <code><nowiki>{{Admon/tip|header|'''message body'''}}</nowiki></code>
-{{Admon/tip|The first line is automatically formatted as bold text.}}
+==Examples==
+{| class="wikitable"
-===No header===
+|-
-The string
+! Example case !! What you write !! What you see
+|-
- <nowiki>{{Admon/tip|
+| Only header || <code><nowiki>{{Admon/tip|The first parameter is automatically formatted as bold text.}}</nowiki></code> || {{Admon/tip|The first parameter is automatically formatted as bold text.}}
-This is shown as plain text.}}</nowiki>
+|-
+| Only body text || <code><nowiki>{{Admon/tip||This is shown as plain text.}}</nowiki></code> || {{Admon/tip||This is shown as plain text.}}
-will show as
+|-
+| Header and body text || <code><nowiki>{{Admon/tip|This is the header|This is the body text.}}</nowiki></code> || {{Admon/tip|This is the header|This is the body text.}}
-{{Admon/tip|
+|-
-This is shown as plain text.}}
+| Wiki-coding || <pre><nowiki>{{Admon/tip
+|Wiki-formatting for '''bold text''' is inverted in the header
-===Text with header===
+|The ''other rows'' '''behave as''' '''''normal'''''. <br />
-The string
- <nowiki>{{Admon/tip|This is the header
-This is the body text.}}</nowiki>
-will show as
-{{Admon/tip|This is the header
-This is the body text.}}
-===Wiki-coding===
-The string
- <nowiki>{{Admon/tip|''Wiki-formatting'' for '''bold text''' is inverted in the '''''header'''''
-The ''other rows'', however, '''behave as''' you are '''''used to'''''. <br />
 You can use wiki-code to, e.g.
 [[link to stuff]],
@@ Line 64: / Line 44: @@
 make text <small>small</small> or <big>big</big>,
   and include pre-format boxes.
-You can also
+You can even
-insert empty rows.}}</nowiki>
-will show as
-{{Admon/tip|''Wiki-formatting'' for '''bold text''' is inverted in the '''''header'''''
+insert empty rows.}}</nowiki></pre> || {{Admon/tip
-The ''other rows'', however, '''behave as''' you are '''''used to'''''. <br />
+|Wiki-formatting for '''bold text''' is inverted in the header|The ''other rows'' '''behave as''' '''''normal'''''. <br />
 You can use wiki-code to, e.g.
 [[link to stuff]],
@@ Line 78: / Line 55: @@
 make text <small>small</small> or <big>big</big>,
   and include pre-format boxes.
-You can also
+You can
+even
 insert empty rows.}}
+|}
 ==See also==