Template:Letter-spacing
 | This template uses a See H:DIVSPAN for details. |
Documentation
[edit]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
[edit]- 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
[edit]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
[edit]Spacing
[edit]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 o u r t e x t g o e s h e r e }}
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
[edit]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
[edit]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
[edit]- {{Word-spacing}}
- {{Letter-spacing-normal}}
No description.
| 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 |