Template:BullR/doc



This is the bullet+R template&mdash;meaning menomically 'bullet+'; which is something of a misnomer as the 'forced newline' or the '' occurs first then the bullet is prefixed (space char omitted) to the following word or term.
 * It is extremely useful inside tables and images to set off bullet-points, but generally should not' be used on unenclosed text,
 * use instead the  '*' or ':::*'   for such bulleting needs.
 * unless that is, you want to maintain an indent level relative to the line left margin... then it is your solution!

This template is used when you want a larger bullet than a bold middot [&middot;], but something smaller than a [–] or [&mdash;], and FURTHER, want to start a new row of data or bullet a point. For instance, in dotted lists that have a font-size 80% or less of normal font-size, since then a bold middot becomes too small... so we use bull, for those of us who don't know how to code such, and know further that searching for graphics dots is slow and painful. (Letters, on the other hand, are easy to find on ALL KEYBOARDS).

Tail of two bulls

 * Both the 'bulls' work similarly to the HTML markup sequence: [ ], that is, bull expresses a ...
 * while BullR expresses a (newline) so changes line then shows the bullet indented to the prior indented column. This is akin to setting a return stop on typewriters when Returning would be stopped short of the left margin. (This kept thousands of secretaries employed laboriously setting up the bosses tabular documents! And that's 'No Bull!')


 * to illustrate, indenting the below
 * then using it and bull together on the same line:
 * When displayed bull looks like [] on the same line, while THIS looks and acts on a term or link like this when also on the same line: &bull; term or link... unlike bull, BullR begins a newline but indented. Used together with a bit of planning the two make for some nice navigation template options. Used alone, BullR nicely sets off data best viewed in an uncluttered presentation.
 * And unlike, the bullet stays attached to the following text separated and linked by the opposite nesting order of HTML markup sequence: [ ].
 * Since it expresses a normal space then the bullet and non-breaking space it makes a handy delimiter when table data gets confusing and you need to set off things in an orderly manner:
 * use after some text like this and just continue your composition. Wikimarkup parsing will search until finding the end of template so the newline equates to a tab or space (all class 'whitespace') and all are ignored.

{{void| So if you want it. you figure out how to rewrite the below... I was out of time three hours ago!

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 bullet, like this:
 * Salt &bull; Pepper

If it line breaks then the line break will come after the bullet, not before, like this:
 * Salt &bull;
 * 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 does not 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:
 * Salt &bull; Pepper &bull; Curry &bull; Saffron

And if it line breaks then the line break will come after one of the bullets, not before, like this:
 * Salt &bull; Pepper &bull;
 * Curry &bull; 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:

SaltPepper Salt  Pepper

Both of them will render exactly as before, with just one space on each side of the bullet, like this:
 * Salt &bull; Pepper

And it will still only line break after the bullet, like this:
 * Salt &bull;
 * 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 bullet and one after, like this:
 * Salt &bull; Pepper

And if it line breaks it might break before the bullet, like this:
 * Salt
 * &bull; Pepper

Technical details
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.

Under some circumstances, dotted link lists misbehave. They might get unexpected line wraps or they might expand outside the box they are enclosed in. }}