Template:Smallcaps/doc

This is a documentation subpage for Template:Smallcaps (see that page for the template itself).
It contains usage information, categories and other content that is not part of the original template page.

Shortcuts {{sm}} {{aut}}

Template:COinS safe {{Smallcaps}} will display the lowercase part of your text as a soft format of typographical small caps.
For example: {{Smallcaps|Beware of Dog}} → {{Smallcaps|Beware of Dog}}.

This template should be avoided or used sparingly in articles, as the that small caps should be avoided and reduced to one of the other title cases or normal case, and that markup should be kept simple.

Template:Em in small caps, use {{Smallcaps2}} (a.k.a. {{sc2}}) instead.

Usage

Your source text is not altered in the output, only the way it is displayed on the screen: a copy-paste of the text will give the small caps sections in their original form; similarly, an older or non-CSS browser will only display the original text on screen.

Code: {{Smallcaps|Your Text in 4004 BC}}
Displayed: Your Text in 4004 BC
Pasted: Your Text in 4004 BC

This template is therefore intended for the use of caps as a typographic style, such as rendering family names in bibliographies in small caps to distinguish them from given names. It should not be used for acronyms or abbreviations which are supposed to be capitalized regardless of style. For such cases, use {{Smallcaps2}}.

Notes

Diacritics (å, ç, é, ğ, ı, ñ, ø, ş, ü, etc.) are handled. However, because the job is performed by each reader's browser, inconsistencies in CSS implementations can lead to some browsers not converting certain rare diacritics.
Use of this template does not generate any automatic categorization. As with most templates, if the argument contains an = sign, the sign should be replaced with {{=}}, or the whole argument be prefixed with 1=. And for wikilinks, you need to use piping. There is a parsing problem with MediaWiki which causes unexpected behavior when a template with one style is used within a template with another style.
There is a problem with dotted and dotless I. {{Lang|tr|{{Smallcaps|ı i}}}} gives you ı i, although the language is set to Turkish.
Do not use this inside Citation Style 1 or Citation Style 2 templates, or this template's markup will be included in the COinS metadata. This means that reference management software such as Zotero will store the markup. For example, if {{smallcaps}} is used to format the surname of Bloggs, Joe in {{cite journal}}, then Zotero will store the name as <span style="font-variant:small-caps;">Bloggs</span>, Joe. This is incorrect metadata. If the article that you are editing uses a citation style that includes small caps, either format the citation manually (see examples below) or use a citation template that specifically includes small caps in its formatting, like {{Cite LSA}}.

Code examples

	Code	Display (screen)
Y	{{Smallcaps\|The ''Name'' of the 2nd Game}}	The Name of the 2nd Game
Y	Leonardo {{Smallcaps\|DiCaprio}} (born 1974)	Leonardo DiCaprio (born 1974)
Y	José {{Smallcaps\|Álvarez de Toledo y Gonzaga}}	José Álvarez de Toledo y Gonzaga
Y	{{Smallcaps\|Nesbø, Vågen, Louÿs, Zúñiga, Kabaağaçlı}}	Nesbø, Vågen, Louÿs, Zúñiga, Kabaağaçlı
When your text uses an = sign:
Template:N	{{Smallcaps\|You and Me = Us}}	{{{1}}}
Y	{{Smallcaps\|You and Me = Us}}	You and Me = Us
Y	{{Smallcaps\|You and Me {{=}} Us}}	You and Me = Us
Y	{{Smallcaps\|1=You and Me = Us}}	You and Me = Us
When your text uses a template:
Template:N	in {{Smallcaps\|Fiddler's {{Green{{!}}Green}}}} forever	Green}} forever
Y	in {{Smallcaps\|1=Fiddler's {{Green\|Green}}}} forever	in Fiddler's Template:Green forever
Y	in {{Smallcaps\|Fiddler's {{Green\|Green}}}} forever	in Fiddler's Template:Green forever
Y	{{Green\|1=in {{Smallcaps\|Fiddler's Green}} forever}}	Template:Green
Y	{{Colors\|green\|yellow\|3=in {{Smallcaps\|Fiddler's Green}} forever}}	Template:Colors
When your text uses a \| pipe:
Template:N	{{Smallcaps\|Before\|afteR}}	Before
Template:N	{{Smallcaps\|1=Before{{!}}afteR}}	afteR
Y	{{Smallcaps\|Before\|afteR}}	Before\|afteR
When your text uses a link:
Template:N	[[{{Smallcaps\|Mao}} Zedong]]	[[Mao Zedong]]
Y	[[Mao Zedong\|{{Smallcaps\|Mao}} Zedong]]	Mao Zedong

Note that most of these uses are not sanctioned by the WP:Manual of Style and should be avoided in article prose.

Reasons to use small caps

Small caps are useful for encyclopedical and typographical uses including:

To lighten ALL-CAPS surnames mandated by citation styles such as Harvard

Note that this template should not be used inside CS1 or CS2 citation templates, such as {{cite book}} or {{citation}}.

Piccadilly has been compared to "a Parisian boulevard" (Dickens 1879).
Dickens, C., Jr (1879). "Piccadilly" in Dickens's Dictionary of London. London: C. Dickens.[1]

To disambiguate Western names and surnames at a glance

Many Hispanic names are tricky to decompose:
- Jorge Luis Borges, but Adolfo Bioy (both filed under "B")
- José Álvarez, Marqués de los Trujillos
And many Hispanic names are better known by their second surname:
- Pablo Ruiz Picasso, Federico García Lorca, Emir Rodríguez Monegal, José Luis Rodríguez Zapatero
Many names (Martín, Miguel, Ramón, Tomás, etc.) can be either forename or surname:
- Juan Martín Hernández vs. Rafael Martín Vázquez (two ball players)
Hungarian names natively use the surname-first order:
- Petőfi Sándor is usually westernized Sándor Petőfi

To disambiguate Eastern surnames and given names at a glance

Most Chinese names and Korean names retain their surname-first order:
- Mao Zedong fought Chiang Kai-shek
- The movie Oldboy by Park Chan-wook starring Choi Min-sik was not seen by Kim Il-sung

Especially in Hong Kong and Macao, a Western given name may be added as well:

Leslie Cheung Kwok-Wing

Most Japanese names are reversed in the West, but not all:
- (Akira Kurosawa or Motojirō Kajii are usually westernized)
- But Matsuo Bashō, Ono no Komachi, Kaga no Chiyo (haiku poets known under their given name)
- But Edogawa Ranpo (kept due to wordplay "EdgarA–llanPoe) vs. Ranpo Edogawa (some modern uses)
Burmese names ignore the concept of forename/surname, but are adapted in the West:
- Daw Aung San Suu Kyi, daughter of General Aung San ("Daw" is honorific, her name takes part of his name)
And some Burmese names are so short they need to retain an honorific prefix (U for Mister, Daw for Madam, Thakin for Master) which is confusable with a forename or a surname:
- U Nu ("Mister Nu"), a.k.a. Thakin Nu ("Master Nu")

To cite Unicode character names correctly without unwanted emphasizing

Such names are required to be written in capitals by the Unicode standard. In running text, "U+022A latin capital letter o with diaeresis and macron" is a less predominant alternative to "U+022A LATIN CAPITAL LETTER O WITH DIAERESIS AND MACRON".

Technical

Technically, the template merely wraps the standard:

<span style="font-variant:small-caps;"> ... </span>

(The "font-variant:small-caps;text-transform:lowercase" has not been used because it does not work at least in Internet Explorer 5 and 6, which are still fairly common browsers.)

Comparison of the small caps templates

{{smallcaps}}: The King James Version of 1611 AD renders the Tetragrammaton as "Lord".
{{smallcaps2}}: The King James Version of 1611 Template:Smallcaps2 renders the Tetragrammaton as "Template:Smallcaps2".
{{smallcaps all}}: The King James Version of 1611 Template:Smallcaps all renders the Tetragrammaton as "Template:Smallcaps all".

The desired result:

{{smallcaps2}} for "AD" and {{smallcaps}} for "Lord": The King James Version of 1611 Template:Smallcaps2 renders the Tetragrammaton as "Lord".

A suboptimal result:

{{smallcaps2}} used for both makes "Template:Smallcaps2" a bit hard to read.

The highly undesirable result:

The {{Smallcaps all}} template actually converts everything to lower case, then presents it in small-caps, with the result that the sentence above will mis-paste as 'The King James Version of 1611 ad renders the Tetragrammaton as "lord".' This is not the intended output for either of the two cases of the template's use in that sentence.