Template:United States Ship
 | This template is used on approximately 39,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. |
 | This template uses Lua: |
Usage
This is a typing shortcut 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}}.
"USS" is the abbreviation for "United States Ship". (It is almost never written out.)
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 |
(The last example could be used to link to a ship index (disambiguation) page.)
Target page
By default, the wikilink is built 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'']]→
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.
Unlink prefix
Adding |up=yes signifies unlink prefix, which put the prefix before (outside of) the wikilink. For example, {{USS|Constitution|up=yes}} yields USS Constitution.
TemplateData
TemplateData | |||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
This is the TemplateData for this template used by TemplateWizard, VisualEditor and other tools. See a monthly parameter usage report for Template:United States Ship in articles based on its TemplateData.
TemplateData for United States Ship This template provides a wikilink to a ship's page, with label options
| |||||||||||||||||||||||||
