User:Ian Spackman/NowrapList/doc

This template was designed to be used in creating well-formated lists of links in footer navagation boxes with adjacent items set apart by mid-dots (or other separators).

Its key feature is that individual items which contain spaces will not end up broken between two lines and hence be harder for the reader to recognize. Rather, line breaks will only occur immediately after the separator.

An example of such a box follows.

Basic Example
The basic usage, and probably most useful, is simply a list of items, which will normally be links, marked off by the pipe symbol (|), with exactly one space, and no carriage returns, on each side of it.

Example with title and custom separator character
Using the same list as before, but adding title and  separator parameters 
 * title = settlements
 * separator = •
 * Bardolino | Brenzone | […] | Tremosine



Example with ‘special’ characters
Certain characters need special handling:
 * = (the equals sign) cannot be used directly but needs to be replaced by Equals or (equivalently) the HTML entity &amp;#x3D;
 * | (the pipe symbol) works just fine within a piped link, but otherwise replace it with !''

""

Example with an image used as separator
You probably shouldn’t, but you can use an image to separate the list items ""

Applying styles to the separator
Here the separator is a the heart character (Unicode: 2665), with the colour set to red. Not a very good thing to do: but documented. ""

Here the separator is a couple of shape characters in white with a drop-shadow. But don’t do it if you want to preservea modicum of inter-platform compatibility! ""

The ‘traditional approach’
Compare the above to the following. Resize your window and watch the word-wrapping behaviour. (Incidentally you may spot another difference: this template uses a plain mid-dot as a divider while · emboldens it.)

 Settlements: Bardolino· Brenzone· Castelnuovo del Garda· Desenzano del Garda· Garda· Gardone Riviera· Gargnano· Lazise· Limone sul Garda· Lonato· Malcesine· Manerba del Garda· Moniga del Garda· Nago-Torbole· Padenghe sul Garda· Peschiera del Garda· Riva del Garda· Salò· San Felice del Benaco· Sirmione· Tignale· Torri del Benaco· Toscolano-Maderno· Tremosine 

Settlements: Bardolino· Brenzone· Castelnuovo del Garda· Desenzano del Garda· Garda· Gardone Riviera· Gargnano· Lazise· Limone sul Garda· Lonato· Malcesine· Manerba del Garda· Moniga del Garda· Nago-Torbole· Padenghe sul Garda· Peschiera del Garda· Riva del Garda· Salò· San Felice del Benaco· Sirmione· Tignale· Torri del Benaco· Toscolano-Maderno· Tremosine

Known limitations and bugs

 * A better name for the template could be found
 * Parameters beyond the two-hundredth are silently ignored

C source
The template was generated using the following code:
 * 1) include 

int main (int argc, const char * argv[]) { int max = 200; int i;	printf("", i, i); printf(" \n"); printf("\n"); printf(" "); return 0; }