View source for Template:Infobox ship career/doc

This template is part of the WikiProject Ships ship infobox.  It adds a Career box to the infobox.  Each section, except Infobox Ship Begin, can be repeated as necessary to support multiple careers, multiple sets of characteristics, etc.  The header of the Career box can be hidden by setting its "Hide header=yes".  This allows you to repeat certain fields by adding a second Career box with a hidden header.{{Infobox ship begin/shared doc}}
===TemplateData===
{{TemplateData header}}

<templatedata>
{
	"description": "This template is part of the WikiProject Ships ship infobox.  It adds a Career box to the infobox.  Each section, except Infobox Ship Begin, can be repeated as necessary to support multiple careers, multiple sets of characteristics, etc.  The header of the Career box can be hidden by setting its \"Hide header=yes\".  This allows you to repeat certain fields by adding a second Career box with a hidden header.",
	"params": {
		"Hide header": {
			"description": "If you need to repeat fields by using multiple copies of the \"Career\" subtemplate, enter \"Yes\" in this field to prevent display of the blue bar at the top of the second template. At least one \"Career\" header should be left visible.",
			"type": "boolean"
		},
		"Ship country": {
			"description": "The nation a ship is associated with; either the nation a warship belongs to, or the nation of registry for civilian ships. However, in case of civilian ships flying flags of convenience, this field should not be used. The country is placed in the infobox header. Do not use this field to indicate ranges.",
			"type": "string"
		},
		"Ship flag": {
			"description": "The ensign (maritime flag) associated with a ship",
			"type": "string"
		},
		"Ship class": {
			"description": "If the ship belongs to a recognized ship class, use this field to identify the class. The field displays as \"class & type\", so the type should be added here as well.",
			"type": "string"
		},
		"Ship name": {
			"description": "The name of the ship",
			"type": "string"
		},
		"Ship namesake": {
			"description": "If the ship's name originates from a particular person, location, event, or object, it may be added here. However, descriptions longer than a few words (e.g. a person's name or \"Finnish for \"potato\"\") should be placed in the article body.",
			"type": "string"
		},
		"Ship owner": {
			"description": "The company or organisation that owns the vessel. When multiple entries are made in this field, include year ranges. Leave this field blank for warships, as the combination of the |Ship country= and |Ship flag= fields will generally be enough for readers to identify ownership.",
			"type": "string"
		},
		"Ship operator": {
			"description": "The company or organisation that operates or runs the ship. If the owner of the vessel is also the operator, this field may be left empty. If it is necessary to mention the charterer of the ship in the infobox, use a separate custom field for that.",
			"type": "string"
		},
		"Ship registry": {
			"description": "The nation and port of registry for a civilian vessel. This is generally found painted on the ship's stern. The nation of registry should be expressed as text, not as a flag symbol. A flag symbol may be used in addition, but only if such usage meets Wikipedia:Manual of Style/Icons. When multiple entries are made in this field, include year ranges",
			"type": "string"
		},
		"Ship route": {
			"description": "If a civilian or merchant vessel has a long-term (multiple years +) association with a particular voyage path or route. Do not use this field for modern cruise ships, as their routes change on a regular basis.",
			"type": "string"
		},
		"Ship ordered": {
			"description": "The date that the ship was ordered from the shipbuilder.",
			"type": "string"
		},
		"Ship awarded": {
			"description": "For United States Navy vessels, the date that the contract to build the ships was signed/approved.",
			"type": "string"
		},
		"Ship builder": {
			"description": "The shipyard or other construction facility where the vessel was built. Usually, only the building company is listed here. The location of the shipyard may also be added, but avoid too much detail: anything more than a single 'location link' can be discussed in the body of the article or referred to with a link (for example [[Vickers-Armstrongs]], [[Barrow-in-Furness]] or [[BAE Systems Australia]], [[Williamstown, Victoria]], but not [[Scotts Shipbuilding and Engineering Company]], [[Greenock]], [[Scotland]], [[United Kingdom]])",
			"type": "string"
		},
		"Ship original cost": {
			"description": "The financial cost of building the ship, usually at the time of construction and using the currency of either the orderer or the builder. If other values are used (e.g. conversions), they should be specified and, if necessary, further discussed in the article",
			"type": "string"
		},
		"Ship yard number": {
			"description": "An identifying number assigned for the ship by the builder during construction",
			"type": "string"
		},
		"Ship way number": {
			"description": "If the particular slipway where a ship was built has been identified with a number, it may be added here. Rarely used for modern vessels.",
			"type": "string"
		},
		"Ship laid down": {
			"description": "The date on which the keel was laid down onto the slipway by the builder. For most ships, this is the point where construction of the vessel starts, and is usually accompanied by ceremony. Although modular construction techniques mean that fabrication of modern vessels can start prior to this, the first time a module is placed on the slipway or building dock is still recognised as the date a ship is laid down.",
			"type": "string"
		},
		"Ship launched": {
			"description": "The date a ship is launched, floated out, or other circumstance where the completed hull enters the water. Construction is not normally completed by this date. Take care not to confuse it with dates recognising the ship's entry into service (such as commissioning or maiden voyage)",
			"type": "string"
		},
		"Ship sponsor": {
			"description": "The individual (usually a woman and sometimes referred to as a \"launching lady\") who does the whole ceremonial \"smash-the-bottle,-launch-the-ship\" thing as part of the launching ceremony. This is not to be used for any companies or organisations providing sponsorship of a vessel in exchange for advertising or naming rights.",
			"type": "string"
		},
		"Ship christened": {
			"description": "The date of the ceremony in which the ship formally and/or ceremonially receives her name (see Ship naming and launching). Only use this field if the naming/christening happened at a separate point in time to either the launching or commissioning ceremonies.",
			"type": "string"
		},
		"Ship completed": {
			"description": "The date construction work finished",
			"type": "string"
		},
		"Ship acquired": {
			"description": "The date of delivery by the shipbuilder to the owner or operator. If it is the same as the completion date, this field may be left empty. Alternately, if the ship changes ownership and multiple, separate \"Career\" subtemplates are being used, the date the new owner/operator came into possession of the ship. Do not use this method if the change of ownership is being handled through multiple entries in the |Ship owner= field",
			"type": "string"
		},
		"Ship commissioned": {
			"description": "The date a warship was commissioned into naval service.\nDo not use for civilian merchant vessels",
			"type": "string"
		},
		"Ship recommissioned": {
			"description": "If a naval vessel was decommissioned from service, then reactivated, use this field to add the new commissioning date\nUsed best with multiple copies of the \"Career\" subtemplate (|Ship commissioned= and |Ship decommissioned= fields in the first template, |Ship recommissioned= and |Ship decommissioned= in the second).\nDo not use for civilian merchant vessels",
			"type": "string"
		},
		"Ship decommissioned": {
			"description": "The date a warship was decommissioned or paid off from naval service.\nDo not use this field if events related to the ship's fate (such as loss in action) mean the ship was never formally decommissioned.\nDo not use for civilian merchant vessels.",
			"type": "string"
		},
		"Ship maiden voyage": {
			"description": "The dates and locations of the start and end of the ship's maiden voyage: the first recognised voyage in full service, usually carrying passengers or cargo.\nThe transfer of a completed ship from the shipyard to its owner is not normally recognised as a maiden voyage; this is part of the sea trial or shakedown phase, which ensures the ship is working as built.\nMost commonly used for civilian passenger-carrying vessels",
			"type": "string"
		},
		"Ship in service": {
			"description": "The date a civilian vessel began operations.\nAlternately, this may be treated as a date range indicating the start and end points of a ship's career. If being used in this manner, ignore the |Ship out of service= field.",
			"type": "string"
		},
		"Ship out of service": {
			"description": "The date a civilian vessel ceased operations.\nIf the |Ship in service= field is being used with a date range instead of a set date, do not use this field.",
			"type": "string"
		},
		"Ship renamed": {
			"description": "If the ship changes names, the new names and corresponding dates may be listed here.\nIf multiple names are listed in the |Ship name= field, ignore this field.",
			"type": "string"
		},
		"Ship reclassified": {
			"description": "When a warship's classification is altered, the date and new classification may be listed here",
			"type": "string"
		},
		"Ship refit": {
			"description": "If the ship underwent a major modification or refit, the start and end dates may be listed here.",
			"type": "string"
		},
		"Ship struck": {
			"description": "When a ship is removed from an official register (such as the United States Navy's Naval Vessel Register), the date of removal (or striking) from the register should be listed here.\nThis field does not include collisions, groundings or attacks a ship has experienced.",
			"type": "string"
		},
		"Ship reinstated": {
			"description": "If, after a ship has been stricken from a register, she is returned to service and is re-listed on that register, the date of reinstatement should be listed here\nUsed best with multiple copies of the \"Career\" subtemplate.",
			"type": "string"
		},
		"Ship homeport": {
			"description": "The home port of the vessel (if different from |Ship registry=): For civilian ships, this will be the primary port from which the ship operates (i.e. for cruise ships, the port in which cruises start and end). Port of registry (the one painted on the stern) should be listed in |Ship registry=. For warships, this will be the ship's assigned naval base.\n\nWhen multiple entries are made in this field, include year ranges.\nFor ships that change their home port on a regular basis (more than once every couple of years), consider ignoring this field and elaborating in the body of the article",
			"type": "string"
		},
		"Ship identification": {
			"description": "Any identification numbers or codes for the vessel are listed here. This may include IMO numbers (use {{IMO number}}), MMSI numbers (use {{MMSI}}), call signs, and pennant/hull numbers (although consider not using the field for hull numbers if these are indicated in the lead sentence of the article).",
			"type": "string"
		},
		"Ship motto": {
			"description": "If the ship has a motto, it should be listed here. Wrap non-English mottos in {{lang}} templates followed by the English translation",
			"type": "string"
		},
		"Ship nickname": {
			"description": "If the ship has any nicknames, they should be listed here.\nTake care to ensure these are sourced (either in the infobox, or in the body of the article), and consider adding related context and/or circumstances to the article itself.",
			"type": "string"
		},
		"Ship honors": {
			"aliases": [
				"Ship honours"
			],
			"description": "Used to list any battle honours, battle stars, unit citations, or other unit awards awarded to the ship for her service.\nDo not list awards given to individuals, even if the award was for service aboard the vessel. Mention these awards in the relevant part of the ship's history.\nAvoid listing annual capability or competition awards (such as the Battle Effectiveness Award or the Gloucester Cup) to avoid bloat. Battle honours of a previous ship with the same name might be appropriate.\nBritish English (honours) and American English (honors) alternates are provided; delete whichever is inappropriate.",
			"type": "string"
		},
		"Ship captured": {
			"description": "When the ship falls into enemy hands, and whose hands they are.\nKeep it brief by only indicating the capturing nation and the date (i.e. \"Antarctica, 30 February 2012\"). Detail relating to the capture should be in the article.\nFollow up with a new \"Career\" subtemplate to discuss the ship's career with her captor.",
			"type": "string"
		},
		"Ship fate": {
			"description": "Used to indicate that a ship is no longer operational, and will not return to service in the future. This is usually when something pretty permanent happens to the ship, like sinking or scrapping. Rule of thumb: \"Is the ship permanently below the surface, or in pieces?\"\nOnly list the event and the date it occurred (for example: \"Sank following collision on 10 February 1964\", or \"Sold for scrap in 1975\". Details such as location, cause, etc. should be discussed in the article.\nIn the majority of cases, |Ship status= and |Ship fate= are mutually exclusive. Unlike other redundant fields, leave |Ship fate= in the article, as the ship's life will end one day.",
			"type": "string"
		},
		"Ship status": {
			"description": "Used to indicate that a ship is currently in service, or has been removed from service but is available for future use or preserved in some form. Rule of thumb: \"Is the ship above the water and intact?\"\nFor active ships, consider using {{Ship in active service}} or other means to indicate the last known date (generally year) the ship was active. However, if the ship is expected to remain in service in the near future and its decommissioning will not likely go unnoticed, simply |Ship in service= should be enough.\nFor inactive ships, indicate briefly what the ship is 'doing' (laid up, in reserve, preserved as museum ship, awaiting disposal, etc.) and, if deemed necessary, where it is moored.\nIn the majority of cases, |Ship status= and |Ship fate= are mutually exclusive. If the |Ship fate= field is used, delete this field.",
			"type": "string"
		},
		"Ship notes": {
			"description": "Any other important information not covered by the other infobox fields, but not important enough for a custom field.\nThis field should not be used for citations/references: either the citations should be attached to the specific entry, or the infobox should be treated as part of the lead section, with the citations attached to the information in the body of the article.",
			"type": "string"
		},
		"Ship badge": {
			"description": "An image or description of any naval heraldry, such as the ship's badge or crest, may be added here",
			"type": "string"
		}
	},
	"format": "block"
}
</templatedata>