Template:Letter-spacing/doc

From Wikisource
Jump to navigation Jump to search

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: The letter spacing. Can be left blank for the default of 0.15em. Always use text-relative sizes like em, not px, because px will not adjust itself if the text size changes. (See H:PXWIDTH for more details).
  • 2: The text to be spaced.
  • 3: Following un-spaced text. Useful for following punctuation that butts up against the last character of the spaced text. Optional.
  • 4 and 5: Another spaced/unspaced pair. Can be useful for certain headings where there are two un-spaced punctuation marks (e.g. "Chap. VII."). If 4 is a space, use  , or it will be removed by the template argument parser.

Examples[edit]

Spacing[edit]

Example: Default/explicit spacing (0.15em)

* {{letter-spacing||your text goes here}}
* {{letter-spacing|0.15em|your text goes here}}
  • your text goes here
  • your text goes here

Example: Custom spacing 1.5em)

{{letter-spacing|1.5em|your text goes here}}

your text goes here

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 a third unnamed parameter, which simply passes its input as-is.

Furthermore, you can use the fourth and fifth parameters for a subsequent spaced section (this is sometimes useful for cases like "Chap. II.").

In the following examples, the coloured boxes show the extend 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.

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]