Template:USS/doc
 | This is a documentation subpage for Template:USS. It may contain usage information, categories and other content that is not part of the original template page. |
 | This template is used on many pages and changes may be widely noticed. Test changes in the template's /sandbox or /testcases subpages, or in your own user subpage. Consider discussing changes on the talk page before implementing them. |
Usage
This is a typing short cut for linking to US Navy ship articles named in the format "USS Deep Six (AWOL-99)". Since ship names are italicized in article text, linking to them in the usual manner means typing everything twice, such as [[w:USS Deep Six (AWOL-99)|USS ''Deep Six'' (AWOL-99)]]. This template halves that to {{USS|Deep Six|AWOL-99}}.
This template does not support subst: (substitution). Behind the scenes, it invokes {{ship}}.
Formal usage
{{USS|Ship Name}}{{USS|Ship Name|ID}}, where ID can be the hull number, launch year, or pennant number, as specified in the article title.
Examples
| Template usage | Equivalent wikicode | Final result |
|---|---|---|
{{USS|Enterprise|CVN-65}}
|
[[w:USS Enterprise (CVN-65)|USS ''Enterprise'' (CVN-65)]]
|
USS Enterprise (CVN-65) |
{{USS|Constellation|1797}}
|
[[w:USS Constellation (1797)|USS ''Constellation'' (1797)]]
|
USS Constellation (1797) |
{{USS|Constitution}}
|
[[w:USS Constitution|USS ''Constitution'']]
|
USS Constitution |
Last example could be used to link to ship index (disambiguation) page
Target page
By default, the wikilink is build like this:
{{PREFIX|ship's name|ID}}.
- With
{{USS|Enterprise|CVN-65}}, the targetpage is [[w:USS Enterprise (CVN-65)|USS Enterprise (CVN-65)]].- Elements PREFIX and ID can be omitted (if they are not part of the targetpage title).
Formatted label
- Then the template by default adds the formatted label:
[[targetpage|label]]. By default:{{USS|Enterprise|CVN-65}}, by default the label is:[[w:USS Enterprise (CVN-65)|USS ''Enterprise'' (CVN-65)]], showing as:- USS Enterprise (CVN-65).
The default label can be changed with a simple parameter. The extra third position, unnamed parameter allows setting which changes the elements of the ship's full name. It sets the label in the link:
For example, in your article, the hull number (disambiguator) may not be needed to show. In that case, add option |2, and the result is:
{{USS|Enterprise|CVN-65|2}}→
[[w:USS Enterprise (CVN-65)|''Enterprise'']]→- USS Enterprise (CVN-65)
The options are:
| Value | Will show | Example | Wikilink [[targetpage|label]] | Shows |
|---|---|---|---|---|
| (default) | PREFIX name (ID) | {{USS|Enterprise|CVN-65}} | [[w:USS Enterprise (CVN-65)|USS ''Enterprise'' (CVN-65)]] | USS Enterprise (CVN-65) |
| 1 | ID | {{USS|Enterprise|CVN-65|1}} | [[w:USS Enterprise (CVN-65)|''CVN-65'']] | USS Enterprise (CVN-65) |
| 2 | name | {{USS|Enterprise|CVN-65|2}} | [[w:USS Enterprise (CVN-65)|''Enterprise'']] | USS Enterprise (CVN-65) |
| 3 | name (ID) | {{USS|Enterprise|CVN-65|3}} | [[w:USS Enterprise (CVN-65)|''Enterprise'' (CVN-65)]] | USS Enterprise (CVN-65) |
| 4 (dflt) | PREFIX name (ID) | {{USS|Enterprise|CVN-65|4}} | [[w:USS Enterprise (CVN-65)|USS ''Enterprise'' (CVN-65)]] | USS Enterprise (CVN-65) |
| 5 | PREFIX ID | {{USS|Enterprise|CVN-65|5}} | [[w:USS Enterprise (CVN-65)|USS ''CVN-65'']] | USS Enterprise (CVN-65) |
| 6 | PREFIX name | {{USS|Enterprise|CVN-65|6}} | [[w:USS Enterprise (CVN-65)|USS ''Enterprise'']] | USS Enterprise (CVN-65) |
- Note: options default (=blank), 2 and 6 are mostly used.
PREFIX not in article name
It is possible that the prefix is not part of the target pagename. In that case, extra parameter |up=yes (unlink prefix) puts the name outside of the link: [example here]
TemplateData
TemplateData
|
|---|
|
This is the TemplateData for this template used by TemplateWizard, VisualEditor and other tools. See a monthly parameter usage report for Template:USS in articles based on its TemplateData.
TemplateData for USS <templatedata> { "params": { "1": { "label": "Name", "description": "Ship's name", "example": "Bismarck, Belgrano", "type": "string" }, "2": { "label": "ID", "description": "Hull number, launch year, or pennant number", "example": "H75, 1975", "type": "string" }, "3": { "label": "Format", "description": "Formats the label (which name parts will show)", "example": "1, 2, 3, 5, 6", "type": "number", "default": "blank" }, "up": { "label": "unlink prefix", "description": "up=yes puts prefix before (outside of) the wikilink", "example": "up=yes", "default": "no", "type": "boolean" } }, "description": "This template provides a wikilink to a ship's page, with label options", "paramOrder": [ "1", "2", "3", "up" ] } </templatedata> |
See also
