Template:Nowrap/doc: Difference between revisions

From Official Kodi Wiki
Jump to navigation Jump to search
(A bunch of changes, including better first example.)
mNo edit summary
 
(29 intermediate revisions by 22 users not shown)
Line 1: Line 1:
{{documentation subpage}}
{{tl|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 [[w:Wikipedia:Line break handling]].
__NOTOC__
This is the {{tl|nowrap}} template.


This template prevents word wraps (line breaks) in text and links that contain spaces.  
===Usage===
:: {{nowrap|these words stay together}}
:: {{nowrap|a, b, c, or d.}}
:: {{nowrap| merry-go-round }}
:: <nowiki>{{nowrap| [[4-part harmony]] }}</nowiki>


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


=== Usage ===
=== 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.


<pre>
| "He encountered <nowiki>{{nowrap|a tiger}}</nowiki> in the woods."
Lots of text {{nowrap|10 kg (22 lb)}} more text.
<br>May render like this:
</pre>
: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.
|}


It may render like this:
=== Handling equal-sign or bar ===
[[w:Help:Template|Templates]] have problems with parameter data that contains [[w:equal-sign|equal-sign]]s "<code>=</code>" or vertical bars "<code>|</code>" (pipes). In such cases use these workarounds:


:Lots of text 10 kg (22 lb)
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:
:more text.
:<code><nowiki>{{nowrap|</nowiki>1=2 + 2 = 4}}</code>, or <br /><code><nowiki>{{nowrap|2 + 2 {{{|=}}} 4}}</nowiki></code>


Or like this:
which both render as this:
:Lots of text
:{{nowrap|1=2 + 2 = 4}}.
:10 kg (22 lb) more text.


But it will ''not'' render like this:
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:
:Lots of text 10 kg (22
:<code><nowiki>{{nowrap|</nowiki>&amp;#124;6&amp;#124; < 7}}</code> &nbsp;or&nbsp; <code><nowiki>{{nowrap|{{!}}6{{!}} < 7}}</nowiki></code>
:lb) more text.
 
=== Handling interpreted characters ===
 
[[Help:Template|Templates]] have problems to handle parameter data that contains equal signs "<code>=</code>" or vertical bars "<code>|</code>". 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>. For example:
:<code><nowiki>{{nowrap|</nowiki>1=2 + 2 = 4}}</code>
 
Which renders 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 like this:
:<code><nowiki>{{nowrap|</nowiki>&amp;#124;2&amp;#124; < 3}}</code>
 
Or like this:
:<code><nowiki>{{nowrap|{{!}}2{{!}} < 3}}</nowiki></code>


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


=== Technical details ===
=== Technical details ===
The actual code that does the job is this HTML+CSS code:
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>
:<code><nowiki><span style="white-space:nowrap">This text will not wrap</span></nowiki></code>


Spaces at the beginning or end of your text will fall outside the no-wrap tag in the rendered text due to Wikimedia rendering mechanisms.
Spaces at the beginning or end of the text will fall outside the no-wrap tag in the rendered text due to Wikimedia rendering mechanisms.
 
{{tl|nobr}} and {{tl|nobreak}} redirect here.
 
=== 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.  


<includeonly>
<includeonly>
{{pp-template|small=yes}}
[[Category:Formatting templates]]
 
<!-- ADD CATEGORIES BELOW THIS LINE -->
[[Category:Wikipedia formatting templates|{{PAGENAME}}]]
 
<!-- ADD INTERWIKIS BELOW THIS LINE -->
[[ar:قالب:لا لف]]
[[da:Skabelon:Nowrap]]
[[de:Vorlage:Zeile]]
[[es:Plantilla:Nowrap]]
[[fr:Modèle:Nobr]]
[[he:תבנית:ללא גלישה]]
[[hr:Predložak:Nowrap]]
[[hsb:Předłoha:Nowrap]]
[[ja:Template:Nowrap]]
[[no:mal:Nowrap]]
[[pl:Szablon:Nowrap]]
[[ro:Format:Nowrap]]
[[ru:Шаблон:nobr]]
 
</includeonly>
</includeonly>

Latest revision as of 21:58, 29 August 2020

{{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 w:Wikipedia:Line break handling.

Usage

{{nowrap|these words stay together}}
{{nowrap|a, b, c, or d.}}
{{nowrap| merry-go-round }}
{{nowrap| [[4-part harmony]] }}


Examples

"They held {{nowrap|10 kg (22 lb)}} in total."


May render like this:

They held 10 kg (22 lb)
in total.


Or like this:

They held
10 kg (22 lb) in total.


But not render like this:

They held 10 kg (22
lb) in total.
"He encountered {{nowrap|a tiger}} in the woods."


May render like this:

He encountered a tiger
in the woods.


Or like this:

He encountered
a tiger in the woods.


But not like this:

He encountered a
tiger in the woods.

Handling equal-sign or bar

Templates have problems with parameter data that contains equal-signs "=" or vertical bars "|" (pipes). In such cases use these workarounds:

For text that includes an equal-sign "=", precede the text with 1= or use a triple-brace unnamed parameter: {{{|=}}}. For example:

{{nowrap|1=2 + 2 = 4}}, or
{{nowrap|2 + 2 {{{|=}}} 4}}

which both render as this:

2 + 2 = 4.

For text that includes a vertical bar "|", escape the bar(s) with "&#124;" or "{{!}}". For instance, put two bars "|6|" like this:

{{nowrap|&#124;6&#124; < 7}}  or  {{nowrap|{{!}}6{{!}} < 7}}

Which renders this:

|6| < 7

Technical details

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

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

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