Editing Template:Nowrap/doc

__NOTOC__
The '''[[Template:nowrap]]''' stops wrapping of specific text. It prevents word wraps (line breaks) within text or inside a link which contains spaces or hyphens ("-"). The size of the nowrapped text becomes the minimum width of that paragraph.

Before you use this template you might want to read up on [[Wikipedia:Line break handling]].

:: '''Usage''':&nbsp; {&#123;nowrap|these words stay together}}
:::: {&#123;nowrap|a, b, c, or d.}}
:::: {&#123;nowrap| merry-go-round }}
:::: <nowiki>{{nowrap| [[4-part harmony]]}}</nowiki>

For simplicity, the template names {&#123;[[Template:j|'''j''']]}} (join) or {&#123;[[Template:nobr|nobr]]}} or {&#123;[[Template:Nobreak|nobreak]]}} can be used, instead of "nowrap", as quick redirects to {&#123;nowrap}}.

=== Examples ===
{| class=wikitable
|"They held <nowiki>{{nowrap|10 kg (22 lb)}}</nowiki> in total."
<br>May render like this:
:They held {{nowrap|10 kg (22 lb)}}<br>in total.
<br>Or like this:
:They held<br>10 kg (22 lb) in total.
<br>But ''not'' render like this:
:They held 10 kg (22 <br>lb) in total.

| "He encountered <nowiki>{{nowrap|a tiger}}</nowiki> in the woods."
<br>May render like this:
:He encountered a tiger<br>in the woods.
<br>Or like this:
:He encountered<br>a tiger in the woods.
<br>But ''not'' like this:
:He encountered a<br>tiger in the woods.

| We saw <nowiki>{{j |1 [[Warp Prism]]}} but {{j|800 [[Probe]]s}}.</nowiki>
<br>May render like this:
:We saw {{j |1 [[Warp Prism]]}} but<br>800 [[Probe]]s.
<br>Or like this:
:We saw {{j |1 [[Warp Prism]]}}<br>but 800 [[Probe]]s.
<br>But ''not'' render like this:
:We saw 1 [[Warp Prism|Warp<br>Prism]] but 800 [[Probe]]s.
|}
=== Handling equal-sign or bar ===

[[Help:Template|Templates]] have problems to handle parameter data that contains [[equal-sign]]s "<code>=</code>" or vertical bars "<code>|</code>" (pipes). In such cases, consider using {{tl|nowrap begin}} + {{tl|nowrap end}} instead. But there are also workarounds:

For text that includes an equal-sign "=", precede the text with <code>1=</code> or use a triple-brace unnamed parameter: <nowiki>{{{|=}}}</nowiki>. For example:
:<code><nowiki>{{nowrap|</nowiki>1=2 + 2 = 4}}</code>, or <br /><code><nowiki>{{nowrap|2 + 2 {{{|=}}} 4}}</nowiki></code>

which both render as this:
:{{nowrap|1=2 + 2 = 4}}.

For text that includes a vertical bar "|", escape the bar(s) with "<code><nowiki>&amp;#124;</nowiki></code>" or "<code><nowiki>{{!}}</nowiki></code>". For instance, put two bars "|6|" like this:
:<code><nowiki>{{nowrap|</nowiki>&amp;#124;6&amp;#124; < 7}}</code> &nbsp;or&nbsp; <code><nowiki>{{nowrap|{{!}}6{{!}} < 7}}</nowiki></code>

Which renders this: 
:{{nowrap|&#124;6&#124; < 7}}

=== Technical details ===

The actual code that does the job is this HTML+CSS code:

:<code><nowiki><span style="white-space:nowrap">This text will not wrap</span></nowiki></code>

Spaces at the beginning or end of the text will fall outside the no-wrap tag in the rendered text due to wiki rendering mechanisms.


=== See also ===

* {{tl|nowraplinks}} – Prevents wraps inside links and only allows wraps between the links and in normal text. Very useful for link lists and easy to use.
* {{tl|nowrap begin}} – Prevents wraps in both text and links. For the trickier wrapping cases when you need full control, for instance in very complex link lists.
* [[Wikipedia:Line break handling]] – The how-to guide detailing how to handle word wraps (line breaks) on Wikipedia.

[[Category:Source Wikipedia]]