View source for Template:Smallcaps/doc

{{Documentation subpage}}
<!-- PLEASE ADD CATEGORIES AT THE BOTTOM OF THIS PAGE, and INTERWIKIS IN WIKIDATA -->
{{hatnote|{{tl|sc}} redirects here. For a shortcut to [[Template:Shortcut]], see {{tl|sh}}, {{tl|shc}}, or {{tl|short}}.}}
{{High-use}}
{{template shortcut|sc|sm|aut}}
{{Uses TemplateStyles|Template:Smallcaps/styles.css}}
{{tlx|Smallcaps}} will display the lowercase part of most text as a soft format of typographical {{Smallcaps|[[small caps]]}}.<br />For example: {{tlx|Smallcaps|Beware of Dog}} → {{Smallcaps|Beware of Dog}}.

The template works for most scripts that have casing, with the exception of half of the Greek alphabet (namely the unaccented letters α β γ δ θ λ μ ρ σ (but not ς) φ χ ω). In addition, the accents in Greek ΐ ΰ are badly placed: {{sc1|ΐ ΰ}}. 

This template should be avoided or used sparingly in articles, as the [[MOS:SMALLCAPS|Manual of Style advises]] that small caps should be avoided and reduced to one of the other title cases or normal case, and that [[Wikipedia:Manual of Style#Keep markup simple|markup should be kept simple]].

{{em|For display of acronyms/initialisms}} in small caps, use {{tlx|Smallcaps2}} (a.k.a. {{tlx|sc2}}) instead.

== Usage ==
{{COinS safe|n|}}
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     : <code><nowiki>{{Smallcaps|Utada}} Hikaru</nowiki></code>
; Displayed: {{Smallcaps|Utada}} Hikaru
; Pasted   : Utada Hikaru

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 {{tl|Smallcaps2}}.

Small caps should not be used for the abbreviations BC, AD, BCE, CE, etc., per [[MOS:ERA]].

{{As of|2016|02|post=,}} this template cannot be used in citation templates like {{tlx|Cite journal}} to small-cap author names or titles of works in citation styles that call for such typography. See "Notes", below for details.

== Technical notes ==
{{Anchors|Technical|Notes}}
* [[Diacritic]]s (å, ç, é, ğ, ı, ñ, ø, ş, ü, etc.) are handled. However, because text formatting is performed by each reader's browser and fonts, 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 <code>=</code> sign, the sign should be replaced with {{[[Template:=|=]]}}, or the whole argument should be prefixed with {{para|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]]. <code><nowiki>{{Lang|tr|{{</nowiki>Smallcaps|ı i}}}}</code> may gives you {{Smallcaps|ı ı}}, although the language is set to Turkish, unless the font including localized glyphs for small caps variant.
* Do not use this inside {{cs1}} or {{cs2}} templates, or this template's markup will be included in the [[COinS]] metadata. This means that [[reference management software]] such as [[Zotero]] will have entries corrupted by the markup. For example, if {{tl|smallcaps}} is used to format the surname of ''Bloggs, Joe'' in {{tl|cite journal}}, then Zotero will store the name as <code><nowiki><span style="font-variant:small-caps;">Bloggs</span>, Joe</nowiki></code>. 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.
* This template will not affect the use of HTML character entities like <code>&amp;nbsp;</code>.
* Technically, the template is a wrapper for: <code>font-variant: small-caps</code>.
* A potential alternative CSS approach, <code>font-variant: small-caps; text-transform: lowercase;</code>, has not been used because it is implemented inconsistently in browsers: it copy-pastes as the original text in Firefox, but as the altered text in Chrome, Safari, Opera, and text-only browsers.

===Suppressing small caps===

If you wish to suppress the display of small caps in your browser, as a logged-in user, you can make an edit to [[Special:MyPage/common.css|your common.css]] reading:

 span.smallcaps { font-variant-caps: normal !important; }

== Examples ==
{| class="wikitable"
|-
! !! Code !! Display (screen)
|-
|{{Y}}|| <nowiki>{{Smallcaps|The ''Name'' of the 2nd Game}}</nowiki> || {{Smallcaps|The ''Name'' of the 2nd Game}}
|-
|{{Y}}|| <nowiki>Leonardo {{Smallcaps|DiCaprio}} (born 1974)</nowiki> || Leonardo {{Smallcaps|DiCaprio}} (born 1974)
|-
|{{Y}}|| <nowiki>José {{Smallcaps|Álvarez de Toledo y Gonzaga}}</nowiki> || José {{Smallcaps|Álvarez de Toledo y Gonzaga}}
|-
|{{Y}}|| <nowiki>{{Smallcaps|Nesbø, Vågen, Louÿs, Zúñiga, Kabaağaçlı}}</nowiki> || {{Smallcaps|Nesbø, Vågen, Louÿs, Zúñiga, Kabaağaçlı}}
|-
|colspan=3 align=center| ''When your text uses an = sign:''
|-
|{{N}}|| <nowiki>{{Smallcaps|You and Me = Us}}</nowiki> || {{Smallcaps|You and Me = Us}}
|-
|{{Y}}|| <nowiki>{{Smallcaps|You and Me &amp;#61; Us}}</nowiki> || {{Smallcaps|You and Me &#61; Us}}
|-
|{{Y}}|| <nowiki>{{Smallcaps|You and Me {{=}} Us}}</nowiki> || {{Smallcaps|You and Me {{=}} Us}}
|-
|{{Y}}|| <nowiki>{{Smallcaps|1=You and Me = Us}}</nowiki> || {{Smallcaps|1=You and Me = Us}}
|-
|colspan=3 align=center| ''When your text uses a template:''
|-
|{{N}}|| <nowiki>in {{Smallcaps|Fiddler's {{Green{{!}}Green}}}} forever</nowiki> || in {{Smallcaps|Fiddler's {{Green{{!}}Green}}}} forever
|-
|{{Y}}|| <nowiki>in {{Smallcaps|1=Fiddler's {{Green|Green}}}} forever</nowiki> || in {{Smallcaps|1=Fiddler's {{Green|Green}}}} forever
|-
|{{Y}}|| <nowiki>in {{Smallcaps|Fiddler's {{Green|Green}}}} forever</nowiki> || in {{Smallcaps|Fiddler's {{Green|Green}}}} forever
|-
|{{Y}}|| <nowiki>{{Green|1=in {{Smallcaps|Fiddler's Green}} forever}}</nowiki> || {{Green|1=in {{Smallcaps|Fiddler's Green}} forever}}
|-
|{{Y}}|| <nowiki>{{Colors|green|yellow|3=in {{Smallcaps|Fiddler's Green}} forever}}</nowiki> || {{Colors|green|yellow|3=in {{Smallcaps|Fiddler's Green}} forever}}
|-
|colspan=3 align=center| ''When your text uses a {{!}} pipe, use ''&amp;#124;'' as you would need to do [[Help:Template#Pipe|in any template parameter value]]:''
|-
|{{Y}}|| <nowiki>{{Smallcaps|Before&amp;#124;afteR}}</nowiki> || {{Smallcaps|Before&#124;afteR}}
|-
|colspan=3 align=center| ''When your text uses a link:''<ref group=Table>As of May 2023, the preferred example fails due to flaws in Mediawiki ([[:phab:T200704|phabricator issue T200704]]) if there are no prior uses of <code><nowiki>{{smallcaps}}</nowiki></code> on the page outside links.  </ref>
|-
|{{N}}|| <nowiki>[[{{Smallcaps|Mao}} Zedong]]</nowiki> || [[{{Smallcaps|Mao}} Zedong]]
|-
|{{Y}}|| <nowiki>[[Mao Zedong|{{Smallcaps|Mao}} Zedong]]</nowiki> || [[Mao Zedong|{{Smallcaps|Mao}} Zedong]]
|}
<references group=Table />

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 encyclopedic and typographical uses including:

; To lighten ALL-CAPS surnames mandated by [[citation style]]s such as [[Harvard referencing|Harvard]]
Note that this template should not be used inside CS1 or CS2 citation templates, such as {{tl|cite book}} or {{tl|citation}}; see [[#Notes]] above for details and alternatives.
* Piccadilly has been compared to "a Parisian boulevard" ({{smallcaps|Dickens}} 1879).
* [[Charles Dickens, Jr|{{smallcaps|Dickens}}, C. Jr]] (1879). "Piccadilly" in ''Dickens's Dictionary of London''. London: C. Dickens. {{OCLC|54321168}}
; To disambiguate Western names and surnames at a glance
* Many [[Hispanic name]]s are tricky to decompose:
** [[Jorge Luis Borges|Jorge Luis {{smallcaps|Borges}}]], but [[Adolfo Bioy Casares|Adolfo {{smallcaps|Bioy| C|asares}}]] (both filed under "B")
** [[José Álvarez de Bohórquez|José {{smallcaps|Álvarez| de las A|sturias| de B|ohórquez| y G|oyeneche}}, Marqués de los Trujillos]]
* And many [[Hispanic name]]s are better known by their second surname:
** [[Pablo Ruiz Picasso|Pablo {{smallcaps|Ruiz '''Picasso'''}}]], [[Federico García Lorca|Federico {{smallcaps|García '''Lorca'''}}]], [[Emir Rodríguez Monegal|Emir {{smallcaps|Rodríguez '''Monegal'''}}]], [[José Luis Rodríguez Zapatero|José Luis {{smallcaps|Rodríguez '''Zapatero'''}}]]
* Many names (Martín, Miguel, Ramón, Tomás, etc.) can be either forename or surname:
** [[Juan Martín Hernández|Juan Martín {{smallcaps|Hernández}}]] vs. [[Rafael Martín Vázquez|Rafael {{smallcaps|Martín Vázquez}}]] (two ball players)
* [[Hungarian name]]s natively use the surname-first order:
** [[Petőfi Sándor|{{smallcaps|Petőfi}} Sándor]] is usually westernized [[Sándor Petőfi|Sándor {{smallcaps|Petőfi}}]]
; To disambiguate Eastern surnames and given names at a glance
* Most [[Chinese name]]s and [[Korean name]]s retain their surname-first order:
** [[Mao Zedong|{{smallcaps|Mao}} Zedong]] fought [[Chiang Kai-shek|{{smallcaps|Chiang}} Kai-shek]]
** The movie ''Oldboy'' by [[Park Chan-wook|{{smallcaps|Park}} Chan-wook]] starring [[Choi Min-sik|{{smallcaps|Choi}} Min-sik]] was not seen by [[Kim Il Sung|{{smallcaps|Kim}} Il Sung]]
:Especially in Hong Kong and Macao, a Western given name may be added as well:
:*[[Leslie Cheung|Leslie {{smallcaps|Cheung}} Kwok-Wing]]
* Most [[Japanese name]]s are reversed in the West, but not all:
** ([[Akira Kurosawa|Akira {{smallcaps|Kurosawa}}]] or [[Motojirō Kajii|Motojirō {{smallcaps|Kajii}}]] are usually westernized)
** But [[Matsuo Bashō|{{smallcaps|Matsuo}} Bashō]], [[Ono no Komachi|{{smallcaps|Ono}} no Komachi]], [[Kaga no Chiyo|{{smallcaps|Kaga}} no Chiyo]] (haiku poets known under their given name)
** But [[Edogawa Ranpo|{{smallcaps|Edogawa}} Ranpo]] (kept due to wordplay with "Edgar Allan Poe") vs. [[Ranpo Edogawa|Ranpo {{smallcaps|Edogawa}}]] (some modern uses)
* [[Myanmar|Burmese]] names ignore the concept of forename/surname, but are adapted in the West:
** Daw [[Aung San Suu Kyi|{{smallcaps|Aung San}} Suu Kyi]], daughter of General [[Aung San|{{smallcaps|Aung San}}]] ("Daw" is honorific, her name takes part of his name)
* And some [[Myanmar|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|U {{smallcaps|Nu}}]] ("Mister {{smallcaps|Nu}}"), a.k.a. [[Thakin Nu|Thakin {{smallcaps|Nu}}]] ("Master {{smallcaps|Nu}}")
; To cite [[Unicode]] character names correctly without unwanted emphasizing.
* Such names are required to be written in capitals by the Unicode standard. Use {{tl|Smallcaps2}}, not {{tl|Smallcaps}}, for this: In running text, "U+022A {{smallcaps2|LATIN CAPITAL LETTER O WITH DIAERESIS AND MACRON}}" is a less visually distracting alternative to "U+022A LATIN CAPITAL LETTER O WITH DIAERESIS AND MACRON". Unicode names should not be represented in mixed case, e.g. as {{tl|Smallcaps|Latin Capital ...}}.

== Comparison of the case transformation templates ==
{{anchor|Comparison of the small caps templates}}
{{Case templates table}}

== Templatedata ==
{{TemplateData header}}
<templatedata>
{
	"params": {
		"1": {
			"label": "Text",
			"required": true,
			"description": "Text to be rendered in small caps",
			"type": "string"
		}
	},
	"format": "inline",
	"description": "Displays the lowercase part of inputted text as small caps"
}
</templatedata>

==See also==
* {{tl|Smallcaps2}}

<includeonly>{{sandbox other||
[[Category:Text-specific formatting and function templates]]

}}
</includeonly>