Difference between revisions of "Template:Spaced en dash/doc"

From Timelines
Jump to: navigation, search
(Category sort order.)
(Added the "dot size reference list" and some other fixes.)
Line 6: Line 6:
 
It works similarly to the html markup sequence "''' –''' ". That is, a [[non-breaking space]], a short dash and a normal space. However this template includes some extra code that makes it behave slightly better than the html markup sequence.
 
It works similarly to the html markup sequence "''' –''' ". That is, a [[non-breaking space]], a short dash and a normal space. However this template includes some extra code that makes it behave slightly better than the html markup sequence.
  
This template is used when you want something stronger than a [[Template:·|middot]] "·", but shorter than a [[Template:Mdash|mdash]] "—".
+
This template is used when you want something stronger than a [[Template:·|bold middot]] "'''·'''" or a [[Template:•|bullet]] "•", but shorter than a [[Template:Mdash|mdash]] "—".
  
 
=== Normal usage ===
 
=== Normal usage ===
Line 53: Line 53:
  
 
The space after the dash is a normal space. That is it wraps and it collapses.
 
The space after the dash is a normal space. That is it wraps and it collapses.
 +
 +
=== Dot size reference list ===
 +
 +
{| style="text-align:center; background:transparent;"
 +
| style="width:1.7em;" | <small>&middot;</small>
 +
| align="left" | &lt;small> middot
 +
|-
 +
| &middot;
 +
| align="left" | middot
 +
|-
 +
| <small>'''&middot;'''</small>
 +
| align="left" | &lt;small> bold middot
 +
|-
 +
| '''&middot;'''
 +
| align="left" | bold middot
 +
|-
 +
| <small>&bull;</small>     
 +
| align="left" | &lt;small> bullet
 +
|-
 +
| &bull;
 +
| align="left" | bullet
 +
|-
 +
| '''&bull;'''
 +
| align="left" | bold bullet
 +
|-
 +
| &ndash;
 +
| align="left" | ndash
 +
|-
 +
| &mdash;
 +
| align="left" | mdash
 +
|}
  
 
=== See also ===
 
=== See also ===
  
* [[Template:·|<nowiki>{{·}}</nowiki>]] - The similar middot template. Mostly used for dotted lists.
+
There are several other templates with similar functionality:
* [[Template:Mdash|<nowiki>{{mdash}}</nowiki>]] - The similar mdash template. Mdash "&mdash;" is a longer dash than the ndash "&ndash;".
+
 
 +
* [[Template:·|<nowiki>{{&middot;}}</nowiki>]] - Bold middot "'''&middot;'''" is mostly used for dotted lists.
 +
* [[Template:•|<nowiki>{{&bull;}}</nowiki>]] - Bullet "&bull;" is mostly used for dotted lists that use small font sizes.
 +
* [[Template:Mdash|<nowiki>{{mdash}}</nowiki>]] - Mdash "&mdash;" is a long dash.
  
  

Revision as of 17:57, 11 August 2007

Template:Template doc page viewed directly

This template looks like this " – ".

It works similarly to the html markup sequence "&nbsp;&ndash; ". That is, a non-breaking space, a short dash and a normal space. However this template includes some extra code that makes it behave slightly better than the html markup sequence.

This template is used when you want something stronger than a bold middot "·" or a bullet "•", but shorter than a mdash "—".

Normal usage

The recommended usage is to use no space before the template and one space after the template, like this:

[[Salt]]{{ndash}} [[Pepper]]

It will render one space on each side of the dash, like this:

SaltPepper

If it line breaks then the line break will come after the dash, not before, like this:

Salt
Pepper

Incorrect usage

If the template is used slightly wrong it will in most cases still behave well. Like these examples:

[[Salt]]{{ndash}}[[Pepper]]
[[Salt]]{{ndash}}   [[Pepper]]

Both of them will render exactly as before, with just one space on each side of the dash, like this:

SaltPepper

And it will still only line break after the dash, like this:

Salt
Pepper

But if the template is used very wrong, like these examples:

[[Salt]] {{ndash}}[[Pepper]]
[[Salt]]   {{ndash}}[[Pepper]]
[[Salt]] {{ndash}} [[Pepper]]
[[Salt]]   {{ndash}}   [[Pepper]]

Then it will still only render just one space on each side of the dash, like this:

SaltPepper

But if it line breaks it might break before the dash, like this:

Salt
Pepper

Technical details

The space before the dash is a "non-wrapping" but "collapsing" space. That means it will not line break, but it will collapse together with normal spaces that come before the template to form one single space. It is not simply a &nbsp; since that one will not collapse.

The space after the dash is a normal space. That is it wraps and it collapses.

Dot size reference list

· <small> middot
· middot
· <small> bold middot
· bold middot
<small> bullet
bullet
bold bullet
ndash
mdash

See also

There are several other templates with similar functionality:

  • {{·}} - Bold middot "·" is mostly used for dotted lists.
  • {{•}} - Bullet "•" is mostly used for dotted lists that use small font sizes.
  • {{mdash}} - Mdash "—" is a long dash.