ފަންވަތް:Mdash/doc: Difference between revisions
Content deleted Content added
Created page with ' — <noinclude> {{documentation}} <!-- Add categories and interwikis to the /doc subpage, not here! --> </noinclude>' |
No edit summary |
||
ފޮޅުވަތް 1:
{{Documentation subpage}}
<!-- PLEASE ADD CATEGORIES AND INTERWIKIS AT THE BOTTOM OF THIS PAGE -->
__NOTOC__
{{caution
| Due to the [[WP:DASH|discouragement]] of spaced em dashes by the [[Wikipedia:Manual of Style|Wikipedia Manual of Style]], the usage of this template in articles should generally be avoided. There can be exceptions for some horizontal lists and navigation boxes, but even there the appropriateness of spaced em dashes is under dispute. For horizontal lists consider using {{tn|·}} or {{tl|ndash}} instead. For vertical lists simply use an en dash "<code>–</code>" directly. The en dash is the first item in the "Insert" section below the Wikipedia edit window.
}}
This is the '''mdash''' template, it looks like this " — ".
It works similarly to the html markup sequence "<code>'''&nbsp;&mdash;''' </code>". That is, a [[non-breaking space]], a long dash (known as an [[Dash#Em dash|em dash]]) and a normal space.
{{tl|—}} and {{tl|emdash}} redirect here and can be used as alternative names for this template.
This template is used when you want something a lot stronger than a [[Template:·|bold middot]] "'''·'''", a [[Template:•|bullet]] "•" or a [[Template:Ndash|ndash]] "–".
=== Normal usage ===
The recommended usage is to use ''no'' space before the template and one space after the template, like this:
<nowiki>[[Salt]]{{mdash}} [[Pepper]]</nowiki>
It will render one space on each side of the dash, like this:
:[[Salt]] — [[Black pepper|Pepper]]
If it line breaks then the line break will come ''after'' the dash, not before, like this:
:[[Salt]] —
:[[Black pepper|Pepper]]
For long dashed lists each list item can be put on its own line, with no spaces between each item and the template. Like this:
<pre><nowiki>
[[Salt]]{{mdash}}
[[Pepper]]{{mdash}}
[[Curry]]{{mdash}}
[[Saffron]]</nowiki></pre>
(It doesn't matter if there are no or some spaces at the end of the lines, after the templates.)
As before it will render one space on each side of the dashes, like this:
:[[Salt]] — [[Black pepper|Pepper]] — [[Curry]] — [[Saffron]]
And if it line breaks then the line break will come ''after'' one of the dashes, not before, like this:
:[[Salt]] — [[Black pepper|Pepper]] —
:[[Curry]] — [[Saffron]]
But really, you should use [[Template:·|bold middots]] "'''·'''" or [[Template:Ndash|ndashes]] "–" for such lists.
=== Incorrect usage ===
If the template is used slightly wrong it will in some cases still behave well. For instance if there are no or several spaces after the template. Like these examples:
<nowiki>[[Salt]]{{mdash}}[[Pepper]]</nowiki>
<nowiki>[[Salt]]{{mdash}} [[Pepper]]</nowiki>
Both of them will render exactly as before, with just one space on each side of the dash, like this:
:[[Salt]] — [[Black pepper|Pepper]]
And it will still only line break ''after'' the dash, like this:
:[[Salt]] —
:[[Black pepper|Pepper]]
But putting one or more spaces before the template will cause problems, like these examples:
<nowiki>[[Salt]] {{mdash}}[[Pepper]]</nowiki>
<nowiki>[[Salt]] {{mdash}}[[Pepper]]</nowiki>
<nowiki>[[Salt]] {{mdash}} [[Pepper]]</nowiki>
<nowiki>[[Salt]] {{mdash}} [[Pepper]]</nowiki>
Then it will render with ''two'' spaces before the dash, and one after, like this:
:[[Salt]] — [[Black pepper|Pepper]]
And if it line breaks it might break ''before'' the dash, like this:
:[[Salt]]
: — [[Black pepper|Pepper]]
Because tool-tip previews in Wikipedia do not render template contents, avoid using this template in the first 500 characters, or so, of the lead section text, exclusive of wikilinks and hypertext formatting characters. Instead, use <nowiki>"&nbsp;&mdash; "</nowiki> or <nowiki>"&nbsp;— "</nowiki>.
=== Technical details ===
The space before the dash is a [[non-breaking space]]. That means it will not line break and will not collapse together with normal spaces that come before the template.
The space after the dash is a normal space. That means it wraps (allows line breaks) and it will collapse together with normal spaces that come after the template to form one single space.
=== Dot size reference list ===
{| style="text-align:center; background:transparent;"
| style="width:1.7em;" | <small>·</small>
| align="left" | <small> middot
|-
| ·
| align="left" | middot
|-
| <small>'''·'''</small>
| align="left" | <small> bold middot
|-
| '''·'''
| align="left" | bold middot
|-
| <small>•</small>
| align="left" | <small> bullet
|-
| •
| align="left" | bullet
|-
| '''•'''
| align="left" | bold bullet
|-
| –
| align="left" | ndash
|-
| —
| align="left" | mdash
|}
=== See also ===
There are several other templates with similar functionality:
* {{tn|·}} – Bold middot "'''·'''" is mostly used for dotted lists.
* {{tn|•}} – Bullet "•" is mostly used for dotted lists that use small font sizes.
* {{tl|ndash}} – Ndash "–" is a short dash, one half the width of an [[Dash#Em dash|em dash]].
<includeonly>
<!-- ADD CATEGORIES BELOW THIS LINE -->
[[Category:Wikipedia formatting and function templates|{{PAGENAME}}]]
<!-- ADD INTERWIKIS BELOW THIS LINE -->
[[ja:Template:Mdash]]
[[pt:Predefinição:Mdash]]
</includeonly>
| |||