Template:Nowrap/doc: Difference between revisions

From Official Kodi Wiki
Jump to navigation Jump to search
(clarified, noting hyphens, plus "inside a link" to avoid confusion with verb "links"; noted redirects named "j" (join) & "nobr" & "nobreak"; new section "Examples" showing 3 cases in a table, etc.)
mNo edit summary
 
(14 intermediate revisions by 8 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__
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===
:: {{nowrap|these words stay together}}
:: {{nowrap|a, b, c, or d.}}
:: {{nowrap| merry-go-round }}
:: <nowiki>{{nowrap| [[4-part harmony]] }}</nowiki>


:: '''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 ===
=== Examples ===
Line 29: Line 25:
<br>But ''not'' like this:
<br>But ''not'' like this:
:He encountered a<br>tiger in the woods.
:He encountered a<br>tiger in the woods.
|}


| We saw <nowiki>{{j |1 [[black rhino]]}} but {{j|800 [[zebra]]s}}.</nowiki>
<br>May render like this:
:We saw {{j |1 [[black rhino]]}} but<br>800 [[zebra]]s.
<br>Or like this:
:We saw {{j |1 [[black rhino]]}}<br>but 800 [[zebra]]s.
<br>But ''not'' render like this:
:We saw 1 [[black rhino|black<br>rhino]] but 800 [[zebra]]s.
|}
=== Handling equal-sign or bar ===
=== 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:


[[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>
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:
which both render as this:
:{{nowrap|1=2 + 2 = 4}}
:{{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 "|2|" 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:
:<code><nowiki>{{nowrap|</nowiki>&amp;#124;2&amp;#124; < 3}}</code> &nbsp;or&nbsp; <code><nowiki>{{nowrap|{{!}}2{{!}} < 3}}</nowiki></code>
:<code><nowiki>{{nowrap|</nowiki>&amp;#124;6&amp;#124; < 7}}</code> &nbsp;or&nbsp; <code><nowiki>{{nowrap|{{!}}6{{!}} < 7}}</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:


Line 61: Line 48:


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.
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.
The templates {{[[Template:j|j]]}}, {{[[Template:nobr|nobr]]}} and {{[[Template:Nobreak|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>
 
[[Category:Formatting templates]]
<!-- ADD CATEGORIES BELOW THIS LINE -->
[[Category:Wikipedia formatting and function templates|{{PAGENAME}}]]
 
<!-- ADD INTERWIKIS BELOW THIS LINE -->
[[ar:قالب:لا لف]]
[[bg:Шаблон:Nowrap]]
[[da:Skabelon:Nowrap]]
[[de:Vorlage:Nowrap]]
[[et:Mall:Murdmata]]
[[es:Plantilla:Nowrap]]
[[fr:Modèle:Nobr]]
[[he:תבנית:ללא גלישה]]
[[hr:Predložak:Nowrap]]
[[hsb:Předłoha:Nowrap]]
[[hy:Կաղապար:Nowrap]]
[[it:Template:Tutto attaccato]]
[[ja:Template:Nowrap]]
[[ko:틀:Nobr]]
[[no:mal:Nowrap]]
[[pl:Szablon:Nowrap]]
[[pt:Predefinição:Nowrap]]
[[ro:Format:Nowrap]]
[[ru:Шаблон:Nobr]]
[[sv:Mall:Nowrap]]
[[tr:Şablon:Nowrap]]
 
</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.