Template:Nocaps/doc
Jump to navigation
Jump to search
| icon | This is a documentation subpage for Template:Nocaps. It may contain usage information, categories and other content that is not part of the original template page. |
| File:Ambox current red Asia Australia.svg | Parts of this template (those related to warnings about cross-browser errors) need to be updated. Please help update this template to reflect recent events or newly available information. Relevant discussion may be found on the talk page. |
{{Nocaps|yOuR tExT}} will (in most browsers) display upper- or mixed-case text in, and (in many browsers) permanently convert it to, full lowercase.
Usage
[edit source]| File:Stop hand nuvola.svg | Warning: This template is not cross-browser compatible, and will corrupt upper- or mixed-case data, by permanently converting it to uppercase for users of many browsers, including Chrome, Chromium, Opera, and any text-only browser (Lynx, Lynx, W3M, etc), from which copy-pasted output will be all-uppercase. |
| icon | This template should not be used in citation templates such as Citation Style 1 and Citation Style 2, because it includes markup that will pollute the COinS metadata they produce; see Wikipedia:COinS. |
Your source text will be altered in many browsers (a copy-paste will not give it in its original form):
- In:
{{Nocaps|The ''Name'' of the Game}} - Out: The Name of the Game
- Pasted: Incorrectly as "the name of the game" or correctly as "The Name of the Game", depending on browser.
You can use this template to control the display of the variable output of magic words and of other templates.[dubious – discuss]
Technical notes
[edit source]
- This template is a wrapper for
<span class="nocaps" style="text-transform: lowercase;">...</span>– This method is implemented inconsistently in browsers, such that it copy-pastes as the original text in Firefox, but as the altered text in Chrome, Safari, Opera, and text-only browsers. - Preferably do not subst: it because the result will not be an lowercase source text but the original text wrapped in HTML code making it appear lowercase, so it is more efficient for this purpose to simply rewrite the text in uppercase, or use "{{subst:lc: ...text...}}" to store lowercase text into the page. You can also use the template in edit mode, then copy-paste the result from preview mode into the editing field, replacing the original material and the template.
- Diacritics (å, ç, é, ğ, ı, ñ, ø, ş, ü, etc.) are handled. However, because the job is performed by the browser, inconsistencies in CSS implementations can lead to some browsers not converting certain rare diacritics.
- As with most templates, if the argument contains an equals sign (
=), the sign should be replaced with {{=}}, or the whole argument be prefixed with1=. 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. - Do not use this inside Citation Style 1 or Citation Style 2 templates (most citation templates), or other templates that emit COinS metadata, or the markup will be included in the metadata.
- This template will not affect the use of HTML character entities like
.
Comparison of the case transformation templates
[edit source]| Template | Shortcut | Purpose | Example | Output | Copy-pastes as |
|---|---|---|---|---|---|
| {{Smallcaps}} | {{sc1}} {{SC}} |
No conversion, small-caps display, mixed case. No font size change (acronyms are unaffected). Common mixed-case heading style (not in Wikipedia). Uses: Rendering publication titles in citation styles that require them in small-caps. |
{{sc1|UNICEF}} and 312 {{sc1|BCE}}
|
UNICEF and 312 BCE Mixed Case |
UNICEF and 312 BCE Mixed Case |
| {{Smallcaps2}} | {{sc2}} | No conversion, small-caps display, mixed case. Slightly reduced font size. This is the conventional display of smallcaps for acronyms/initialisms in modern book typography. Other uses: Unicode character names. |
{{sc2|UNICEF}} and 312 {{sc2|BCE}}
|
UNICEF and 312 BCE Mixed Case |
UNICEF and 312 BCE Mixed Case |
| Deprecated {{Smallcaps all}} |
{{sc}} | red-outlined triangle containing exclamation point Warning: Use of the {{Smallcaps all}} template will corrupt upper- or mixed-case data, by permanently converting it to lowercase for users of many browsers. The size of lowercase letters. Uses: Stressed syllables (in {{Respell}}); and ???. |
{{sc|UNICEF}} and 312 {{sc|BCE}}
|
UNICEF and 312 BCE MIXED CASE |
unicef and 312 bce mixed case (in many browsers) |
| {{Allcaps}} | {{caps}} | No conversion, all-caps display. The size of uppercase letters. Uses: Text is displayed in all caps, while copy-and-paste preserves the capitalization of the original text. |
{{caps|UNICEF}} and 312 {{caps|BCE}}
|
UNICEF and 312 BCE Mixed Case |
UNICEF and 312 BCE Mixed Case |
| {{Nocaps}} | No conversion, all-lowercase display. The size of lowercase letters. Uses: ???. |
{{nocaps|UNICEF}} and 312 {{nocaps|BCE}}
|
UNICEF and 312 BCE Mixed Case |
UNICEF and 312 BCE Mixed Case |
TemplateData
[edit source]This is the TemplateData for this template used by TemplateWizard, VisualEditor and other tools. See a monthly parameter usage report for Template:Nocaps in articles based on its TemplateData.
TemplateData for Nocaps
No description.
| Parameter | Description | Type | Status | |
|---|---|---|---|---|
| Input text | 1 | no description | Unknown | required |
See also
[edit source]- {{R from other capitalisation}} – for categorizing Redirects from titles to article (or other pages) where the redirect is just a different capitalization
- {{Template capitalization}} – ??
- Module:String2
Magic words that rewrite the output (copy-paste will get the text as displayed, not as entered):
{{lc:}}– lower case output of the full text{{uc:}}– upper case output of the full text{{lcfirst:}}– lower case output of the first character only{{ucfirst:}}– upper case output of the first character only