Template:Letter-spacing/doc

Documentation

This template simplifies formatting text that has letter-spacing.

The shorthand of this template is {{lsp}} or {{lp}}.

There is also a shorthand named {{sp}} that only takes one parameter and always uses the spacing .15em.

Parameters

• 1 (optional): The letter spacing. Defaults to 0.15em. Always use text-relative units such as em; absolute units like px will not adjust themselves if the text size changes. See H:PXWIDTH for more details.
• 2: The text to be spaced.
• 3 (optional): Following unspaced text. Useful for following punctuation that butts up against the last character of the spaced text.

Extra pairs

This template optionally supports up to 5 spaced–unspaced pairs:

• 4–5
• 6–7
• 8–9
• 10–11

These can be useful for certain lines of text that contain several unspaced punctuation marks. Remember that letter spacing always applies to the right side of every letter.

If any of these contain leading or trailing spaces, use  , or they will be removed by the parser.

Examples

Spacing

Example: Default/explicit spacing (0.15em)

* {{letter-spacing||your text goes here|<br>your text goes here}}
* {{letter-spacing|0.15em|your text goes here|<br>your text goes here}}

• your text goes here
  your text goes here
• your text goes here
  your text goes here

Example: Custom spacing (0.28em)

This attempts to emulate putting non-breaking spaces after each character without adding any actual characters:

{{letter-spacing|0.28em|your text goes here|<br>
y&nbsp;o&nbsp;u&nbsp;r&nbsp; &nbsp;t&nbsp;e&nbsp;x&nbsp;t&nbsp; &nbsp;g&nbsp;o&nbsp;e&nbsp;s&nbsp; &nbsp;h&nbsp;e&nbsp;r&nbsp;e&nbsp;}}

your text goes here
y o u r   t e x t   g o e s   h e r e 

Example: Negative spacing (-0.05em)

{{letter-spacing|-0.05em|your text goes here|<br>your text goes here}}

your text goes here
your text goes here

Example: Many pairs of spaced–unspaced text

{{lsp||Cha|p|. VI|I|: A New Beginnin|g.}}

Chap. VII: A New Beginning.

Last characters

If you need to exclude the last character(s) of spaced text (usually due to excess padding) but still want these characters to be wrapped (usually for clearer syntax), you can use the third parameter, which passes its input as-is. Furthermore, you can use the rest of the parameter pairs for subsequent spaced sections.

In the following examples, the coloured boxes show the extent of the "spaced" text.

C.

{{letter-spacing|1.5em|192|2.}}}}

C.

1922.

Compare to...

C.

{{letter-spacing|1.5em|1922}}.

{{letter-spacing|1.5em|C.}}

{{letter-spacing|1.5em|1922.}}}}

C.

1922.

C.

1922.

Several pairs

Comparison of syntax appearance:

These examples produce the same output, but the template syntax is clearer in the second:

{{letter-spacing|1.5em|192}}2.

{{letter-spacing|1.5em|192|2.}}

{{letter-spacing|1.5em|Cha}}p.{{letter-spacing|1.5em| I}}I.

{{letter-spacing|1.5em|Cha|p.| I|I.}}

1922.

1922.

Chap. II.

Chap. II.

See also

• {{Word-spacing}}
• {{Letter-spacing-normal}}

No description.

Template parameters

Parameter		Description	Type	Status
1	1	letter spacing (Use CSS units , but not px (pixels)	String	required
2	2	Text on which letter spacing is to be applied.	Unknown	optional
3	3	no description	Unknown	optional
4	4	no description	Unknown	optional
5	5	no description	Unknown	optional
6	6	no description	Unknown	optional
7	7	no description	Unknown	optional
8	8	no description	Unknown	optional
9	9	no description	Unknown	optional
10	10	no description	Unknown	optional
11	11	no description	Unknown	optional