Template:Smallcaps/doc: Difference between revisions

[checked revision][checked revision]
Content deleted Content added
m Text replacement - "[[WP:" to "[[Wikipedia:WP:"
No edit summary
 
(5 intermediate revisions by the same user not shown)
Line 4:
{{Uses TemplateStyles|Template:Smallcaps/styles.css}}
{{template shortcut|sm|aut}}{{Commons Import}}
{{tlx|Smallcaps}} will display the lowercase part of your text as a soft format of typographical {{Smallcaps|[[wikipedia:small caps|small caps]]}}.<br />For example: {{tlx|Smallcaps|Beware of Dog}} → {{Smallcaps|Beware of Dog}}.
 
This template should be avoided or used sparingly in articles, as the Wikipedia [[Wikipedia: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.
Line 24:
== Technical notes ==
{{Anchors|Technical|Notes}}
* [[Wikipedia:Diacritic|Diacritic]]s (å, ç, é, ğ, ı, ñ, ø, ş, ü, etc.) are handled. However, because text formatting is performed by each reader's browser and fonts, inconsistencies in [[Wikipedia:CSS|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 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 [[Wikipedia:dotted and dotless I|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 [[Wikipedia:COinS|COinS]] metadata. This means that [[Wikipedia:reference management software|reference management software]] such as [[Wikipedia:Zotero|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, like {{tl|Cite LSA}}.
* 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>.
Line 89:
Note that most of these uses are not sanctioned by the [[Wikipedia:WP:Manual of Style]] and should be avoided in article prose.
 
== ReasonsSee to use small capsAlso ==
For more detail and examples see wikipedia page [[wikipedia:Template:Smallcaps]]
[[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.[http://worldcat.org/oclc/54321168?page=citation]
; 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 ==