Template:Nowrap/doc: Difference between revisions

From Guild of Archivists
No edit summary
No edit summary
 
Line 13: Line 13:
:: <code><nowiki>{{nowrap| [[Cascading Style Sheets|CSS]] }}</nowiki></code>
:: <code><nowiki>{{nowrap| [[Cascading Style Sheets|CSS]] }}</nowiki></code>
:: <code><nowiki>{{nowrap| [[#Examples|Examples section]] }}</nowiki></code>
:: <code><nowiki>{{nowrap| [[#Examples|Examples section]] }}</nowiki></code>
The template names {{[[Template:j|'''j''']]}} (join) or {{[[Template:nobr|nobr]]}} or {{[[Template:Nobreak|nobreak]]}} may be used instead of "nowrap", as they are redirects to {{tld|nowrap}}.


== Examples ==
== Examples ==
Line 38: Line 36:
== Handling equal-sign or bar ==
== Handling equal-sign or bar ==


[[Help:Template|Templates]] have problems with parameter data that contains [[equal-sign]]s "<code>=</code>" or vertical bars "<code>|</code>" (pipes). Note that this does not apply if the equal-sign "<code>=</code>" or vertical bar "<code>|</code>" is inside a wikilink or another template.  In the case that there is a bare equal-sign "<code>=</code>" or vertical bar "<code>|</code>", consider using {{tl|nowrap begin}} + {{tl|nowrap end}} instead. However, there are also other workarounds:
[[w:Help:Template|Templates]] have problems with parameter data that contains equal-signs "<code>=</code>" or vertical bars "<code>|</code>" (pipes). Note that this does not apply if the equal-sign "<code>=</code>" or vertical bar "<code>|</code>" is inside a wikilink or another template.  In the case that there is a bare equal-sign "<code>=</code>" or vertical bar "<code>|</code>", consider using {{tl|nowrap begin}} + {{tl|nowrap end}} instead. However, there are also other workarounds:


For text that includes an equal-sign "=", precede the text with <code>1=</code>, use a triple-brace unnamed parameter <code><nowiki>{{{|=}}}</nowiki></code>, or the <code><nowiki>{{=}}</nowiki></code> template. For example:
For text that includes an equal-sign "=", precede the text with <code>1=</code>, use a triple-brace unnamed parameter <code><nowiki>{{{|=}}}</nowiki></code>, or the <code><nowiki>{{=}}</nowiki></code> template. For example:
Line 54: Line 52:
== 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 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.


== TemplateData ==
== TemplateData ==
Line 80: Line 76:
* {{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|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.
* {{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.
* {{tl|Spaces}} – To produce single or multiple non-breaking spaces.
* [[Wikipedia:Line-break handling]] – The how-to guide detailing how to handle word wraps (line breaks) on Wikipedia.  
* [[Wikipedia:Line-break handling]] – The how-to guide detailing how to handle word wraps (line breaks) on Wikipedia.  



Latest revision as of 06:51, 11 July 2016


{{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[edit]

{{nowrap|these words stay together}}
{{nowrap|a, b, c, or d.}}
{{nowrap| merry-go-round }}
{{nowrap| [[4-part harmony]] }}
{{nowrap| [[Cascading Style Sheets|CSS]] }}
{{nowrap| [[#Examples|Examples section]] }}

Examples[edit]

"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[edit]

Templates have problems with parameter data that contains equal-signs "=" or vertical bars "|" (pipes). Note that this does not apply if the equal-sign "=" or vertical bar "|" is inside a wikilink or another template. In the case that there is a bare equal-sign "=" or vertical bar "|", consider using {{nowrap begin}} + {{nowrap end}} instead. However, there are also other workarounds:

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

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

which all render as this:

2 + 2 = 4.

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

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

Which renders this:

|6| < 7

Technical details[edit]

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.

TemplateData[edit]

This is the TemplateData documentation for this template used by VisualEditor and other tools.

TemplateData for Nowrap

Prevents word wraps (line breaks) within text or inside a link which contains spaces or hyphens (-).

Template parameters

ParameterDescriptionTypeStatus
Text1

Text or link to be protected.

Stringrequired

See also[edit]

  • {{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.
  • {{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.