Jump to content

Template:Middot/doc: Difference between revisions

From LabVIEW Wiki
m Use {{Documentation}} instead of {{template doc}}
m Fix broken links (link to wikipedia as we probably don't want to write article about Salt, Pepper, Curry, and Saffron...
Line 3: Line 3:
This is the '''bold middot''' template, it looks like this: " '''·''' ".  
This is the '''bold middot''' template, it looks like this: " '''·''' ".  


It works similarly to the html+wiki markup sequence "<code>'''&amp;nbsp;<nowiki>'''</nowiki>&amp;middot;<nowiki>'''</nowiki>'''&nbsp;</code>". That is, a [[non-breaking space]], a bolded middot and a normal space.  
It works similarly to the html+wiki markup sequence "<code>'''&amp;nbsp;<nowiki>'''</nowiki>&amp;middot;<nowiki>'''</nowiki>'''&nbsp;</code>". That is, a [[wikipedia:non-breaking space|non-breaking space]], a bolded middot and a normal space.  


{{tl|dot}} and {{tl|middot}} redirect here and can be used as alternative names for this template.
{{tl|dot}} and {{tl|middot}} redirect here and can be used as alternative names for this template.
Line 17: Line 17:


It will render one space on each side of the dot, like this:
It will render one space on each side of the dot, like this:
:[[Salt]] '''&middot;''' [[Pepper]]
:[[wikipedia:Salt|Salt]] '''&middot;''' [[wikipedia:Pepper|Pepper]]


If it line breaks then the line break will come ''after'' the dot, not before, like this:
If it line breaks then the line break will come ''after'' the dot, not before, like this:
:[[Salt]] '''&middot;'''  
:[[wikipedia:Salt|Salt]] '''&middot;'''  
:[[Pepper]]
:[[wikipedia:Pepper|Pepper]]


For long dotted lists each list item can be put on its own line, with no spaces between each item and the template. Like this:
For long dotted lists each list item can be put on its own line, with no spaces between each item and the template. Like this:
Line 33: Line 33:


As before it will render one space on each side of the dots, like this:
As before it will render one space on each side of the dots, like this:
:[[Salt]] '''&middot;''' [[Pepper]] '''&middot;''' [[Curry]] '''&middot;''' [[Saffron]]
:[[wikipedia:Salt|Salt]] '''&middot;''' [[wikipedia:Pepper|Pepper]] '''&middot;''' [[wikipedia:Curry|Curry]] '''&middot;''' [[wikipedia:Saffron|Saffron]]


And if it line breaks then the line break will come ''after'' one of the dots, not before, like this:
And if it line breaks then the line break will come ''after'' one of the dots, not before, like this:
:[[Salt]] '''&middot;''' [[Pepper]] '''&middot;'''  
:[[wikipedia:Salt|Salt]] '''&middot;''' [[wikipedia:Pepper|Pepper]] '''&middot;'''  
:[[Curry]] '''&middot;''' [[Saffron]]
:[[wikipedia:Curry|Curry]] '''&middot;''' [[wikipedia:Saffron|Saffron]]


=== Incorrect usage ===
=== Incorrect usage ===
Line 47: Line 47:


Both of them will render exactly as before, with just one space on each side of the dot, like this:
Both of them will render exactly as before, with just one space on each side of the dot, like this:
:[[Salt]] '''&middot;''' [[Pepper]]
:[[wikipedia:Salt|Salt]] '''&middot;''' [[wikipedia:Pepper|Pepper]]


And it will still only line break ''after'' the dot, like this:
And it will still only line break ''after'' the dot, like this:
:[[Salt]] '''&middot;'''  
:[[wikipedia:Salt|Salt]] '''&middot;'''  
:[[Pepper]]
:[[wikipedia:Pepper|Pepper]]


But putting one or more spaces before the template will cause problems, like these examples:
But putting one or more spaces before the template will cause problems, like these examples:
Line 60: Line 60:


Then it will render with ''two'' spaces before the dot, and one after, like this:
Then it will render with ''two'' spaces before the dot, and one after, like this:
:[[Salt]] &nbsp;'''&middot;''' [[Pepper]]
:[[wikipedia:Salt|Salt]] &nbsp;'''&middot;''' [[wikipedia:Pepper|Pepper]]


And if it line breaks it might break ''before'' the dot, like this:
And if it line breaks it might break ''before'' the dot, like this:
:[[Salt]]  
:[[wikipedia:Salt|Salt]]  
:'''&middot;''' [[Pepper]]
:'''&middot;''' [[wikipedia:Pepper|Pepper]]


=== Technical details ===
=== Technical details ===


The space before the dot 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 before the dot is a [[wikipedia:non-breaking space|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 dot 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.
The space after the dot 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.
Line 110: Line 110:
* [[Template:Ndash|<nowiki>{{ndash}}</nowiki>]] - Ndash "&ndash;" is a short dash.
* [[Template:Ndash|<nowiki>{{ndash}}</nowiki>]] - Ndash "&ndash;" is a short dash.
* [[Template:Mdash|<nowiki>{{mdash}}</nowiki>]] - Mdash "&mdash;" is a long dash.
* [[Template:Mdash|<nowiki>{{mdash}}</nowiki>]] - Mdash "&mdash;" is a long dash.
When making dotted lists you might need to handle proper word wrapping (line breaking):
* {{tn|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.
* {{tn|nowrap begin}} - Prevents wraps in both text and links. For the really tricky wrapping cases when you need full control, for instance in very complex long link lists.


<includeonly>
<includeonly>

Revision as of 16:00, 4 August 2024

This is the documentation page for Template:Middot.
When it is viewed directly, links using variables may appear broken; do not replace these with hardcoded page names or URLs.

This is the bold middot template, it looks like this: " · ".

It works similarly to the html+wiki markup sequence "&nbsp;'''&middot;''' ". That is, a non-breaking space, a bolded middot and a normal space.

{{dot}} and {{middot}} redirect here and can be used as alternative names for this template.

This template is usually used for dotted lists, such as for link lists in navigation boxes. (For lists that have a font-size 80% or less of normal font-size, the bold middot "·" becomes too small. Then use the bullet "•" instead.)

This template is used when you want something smaller than a bullet "•", ndash "–" or mdash "—".

Normal usage

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

[[Salt]]{{·}} [[Pepper]]

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

Salt · Pepper

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

Salt ·
Pepper

For long dotted lists each list item can be put on its own line, with no spaces between each item and the template. Like this:

 [[Salt]]{{·}}
 [[Pepper]]{{·}}
 [[Curry]]{{·}}
 [[Saffron]]

(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 dots, like this:

Salt · Pepper · Curry · Saffron

And if it line breaks then the line break will come after one of the dots, not before, like this:

Salt · Pepper ·
Curry · Saffron

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:

[[Salt]]{{·}}[[Pepper]]
[[Salt]]{{·}}   [[Pepper]]

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

Salt · Pepper

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

Salt ·
Pepper

But putting one or more spaces before the template will cause problems, like these examples:

[[Salt]] {{·}}[[Pepper]]
[[Salt]]   {{·}}[[Pepper]]
[[Salt]] {{·}} [[Pepper]]
[[Salt]]   {{·}}   [[Pepper]]

Then it will render with two spaces before the dot, and one after, like this:

Salt  · Pepper

And if it line breaks it might break before the dot, like this:

Salt
· Pepper

Technical details

The space before the dot 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 dot 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

· <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:

  • {{•}} - Bullet "•" is mostly used for dotted lists that use small font sizes.
  • {{ndash}} - Ndash "–" is a short dash.
  • {{mdash}} - Mdash "—" is a long dash.