 | This template is used on approximately 37,000 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 [[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}}
|
[[USS Enterprise (CVN-65)|USS ''Enterprise'' (CVN-65)]]
|
USS Enterprise (CVN-65) |
{{USS|Constellation|1797}}
|
[[USS Constellation (1797)|USS ''Constellation'' (1797)]]
|
USS Constellation (1797) |
{{USS|Constitution}}
|
[[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 [[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:[[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}}→
[[USS Enterprise (CVN-65)|''Enterprise'']]→- Enterprise
The options are:
| Value | Will show | Example | Wikilink [[targetpage|label]] | Shows |
|---|---|---|---|---|
| (default) | PREFIX name (ID) | {{USS|Enterprise|CVN-65}} | [[USS Enterprise (CVN-65)|USS ''Enterprise'' (CVN-65)]] | USS Enterprise (CVN-65) |
| 1 | ID | {{USS|Enterprise|CVN-65|1}} | [[USS Enterprise (CVN-65)|''CVN-65'']] | CVN-65 |
| 2 | name | {{USS|Enterprise|CVN-65|2}} | [[USS Enterprise (CVN-65)|''Enterprise'']] | Enterprise |
| 3 | name (ID) | {{USS|Enterprise|CVN-65|3}} | [[USS Enterprise (CVN-65)|''Enterprise'' (CVN-65)]] | Enterprise (CVN-65) |
| 4 | invalid | {{USS|Enterprise|CVN-65|4}} | — | Error: {{USS}} invalid control parameter: 4 (help) |
| 5 | PREFIX ID | {{USS|Enterprise|CVN-65|5}} | [[USS Enterprise (CVN-65)|USS ''CVN-65'']] | USS CVN-65 |
| 6 | PREFIX name | {{USS|Enterprise|CVN-65|6}} | [[USS Enterprise (CVN-65)|USS ''Enterprise'']] | USS Enterprise |
- 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 This template provides a wikilink to a ship's page, with label options
| |||||||||||||||||||||||||
