Template:•/doc
This is a documentation subpage for Template:•. It may contain usage information, categories and other content that is not part of the original template page. |
This is the bullet template, it looks like this " • ".
It works similarly to the html markup sequence " •
". That is, a non-breaking space, a bullet and a normal space.
{{bull}} and {{bullet}} redirect here and can be used as alternative names for this template.
This template is used when you want a bigger bullet than a bold middot "·", but something smaller than a ndash "–" or mdash "—". For instance for dotted lists that have a font-size 80% or less of normal font-size, since then bold middot "·" becomes too small.
Normal usage
[change source]The recommended usage is to use no space before the template and one space after the template, like this:
[[Salt]]{{•}} [[Black pepper|Pepper]]
It will render one space on each side of the bullet, like this:
If it line breaks then the line break will come after the bullet, not before, 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:
[[Salt]]{{•}} [[Black pepper|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 bullets, like this:
And if it line breaks then the line break will come after one of the bullets, not before, like this:
Incorrect usage
[change source]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]]{{•}}[[Black pepper|Pepper]] [[Salt]]{{•}} [[Black pepper|Pepper]]
Both of them will render exactly as before, with just one space on each side of the bullet, like this:
And it will still only line break after the bullet, like this:
But putting one or more spaces before the template will cause problems, like these examples:
[[Salt]] {{•}}[[Black pepper|Pepper]] [[Salt]] {{•}}[[Black pepper|Pepper]] [[Salt]] {{•}} [[Black pepper|Pepper]] [[Salt]] {{•}} [[Black pepper|Pepper]]
Then it will render with two spaces before the bullet, and one after, like this:
And if it line breaks it might break before the bullet, like this:
Technical details
[change source]The space before the bullet 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 bullet 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
[change source]· | <small> middot |
· | middot |
· | <small> bold middot |
· | bold middot |
• | <small> bullet |
• | bullet |
• | bold bullet |
– | ndash |
— | mdash |
Related pages
[change source]There are several other templates with similar functionality:
- {{·}} - Bold middot "·" is mostly used for dotted lists.
- {{ndash}} - Ndash "–" is a short dash.
- {{mdash}} - Mdash "—" is a long dash.
When making dotted lists you might need to handle proper word wrapping (line breaking):
- {{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 really tricky wrapping cases when you need full control, for instance in very complex long link lists.