మూస:Infobox port/doc పేజీ సోర్సు చూడండి

{{Documentation subpage}}
<!--Place categories where indicated at the bottom of this page and interwikis at Wikidata (see [[Wikipedia:Wikidata]])-->
{{Lua|Module:Infobox|Module:InfoboxImage|Module:Check for unknown parameters}}
{{Auto short description}}

==Usage==
{{Parameter names example
|embed
|name
|image
|image_alt
|image_size
|image_caption
|logo
|logo_alt
|logo_size
|logo_caption
|native_name
|native_name_lang= en
|country
|location
|coordinates
|coordinates_footnotes
|grid_name
|grid_position
|locode
|built
|opened
|closed
|operated
|owner
|type
|sizewater
|sizeland
|size
|berths
|ships
|wharfs
|piers
|draft_depth
|air_draft
|platforms
|lines
|gauge
|streets
|trucks
|employees
|leadership-title
|leader
|blankdetailstitle1
|blankdetails1
|blankdetailstitle2
|blankdetails2
|blankdetailstitle3
|blankdetails3
|blankdetailstitle4
|blankdetails4
|arrivals
|cargotonnage
|containervolume
|teu
|cargovalue
|passengertraffic
|revenue
|profit
|blankstatstitle1
|blankstats1
|blankstatstitle2
|blankstats2
|blankstatstitle3
|blankstats3
|website
|embedded
}}
All fields are optional, if left blank they will not appear.  The 'Details' have four additional blank spots, and 'Statistics' have three blank spots, to facilitate additional field entries and allow for maximum flexibility.

{|
!full version!!short version
|-style=vertical-align:top
|<syntaxhighlight lang="wikitext">
{{Infobox port
|embed              = 
|name               = 
|image              = 
|image_alt          = 
|image_size         = 
|image_caption      = 
|logo               = 
|logo_alt           = 
|logo_size          = 
|logo_caption       = 
|pushpin_map        = 
|pushpin_map_geomask= 
|pushpin_map_zoom   = 
|pushpin_map_caption= 
|native_name        = 
|native_name_lang   = 
|country            = 
|location           = 
|coordinates        = 
|coordinates_footnotes= 
|grid_name          = 
|grid_position      = 
|locode             = 
|opened             = 
|closed             = 
|operated           = 
|owner              = 
|type               = 
|sizewater          = 
|sizeland           = 
|size               = 
|berths             = 
|ships              = 
|wharfs             = 
|piers              = 
|draft_depth        = 
|air_draft          = 
|platforms          = 
|lines              = 
|gauge              = 
|streets            = 
|trucks             = 
|employees          = 
|leadershiptitle    = 
|leader             = 
|blankdetailstitle1 = 
|blankdetails1      = 
|blankdetailstitle2 = 
|blankdetails2      = 
|blankdetailstitle3 = 
|blankdetails3      = 
|blankdetailstitle4 = 
|blankdetails4      = 
|arrivals           = 
|cargotonnage       = 
|containervolume    = 
|cargovalue         = 
|teu                = 
|passengertraffic   = 
|revenue            = 
|profit             = 
|blankstatstitle1   = 
|blankstats1        = 
|blankstatstitle2   = 
|blankstats2        = 
|blankstatstitle3   = 
|blankstats3        = 
|website            = 
|embedded           = 
}}</syntaxhighlight>
|<syntaxhighlight lang="wikitext">
{{Infobox port
|name            = 
|image           = 
|image_size      = 
|image_caption   = 
|pushpin_map     = 
|country         = 
|native_name     = 
|native_name_lang= 
|location        = 
|coordinates     = 
|locode          = 
|opened          = 
|operated        = 
|owner           = 
|type            = 
|sizewater       = 
|sizeland        = 
|size            = 
|berths          = 
|wharfs          = 
|piers           = 
|draft_depth     = 
|employees       = 
|arrivals        = 
|cargotonnage    = 
|containervolume = 
|cargovalue      = 
|passengertraffic= 
|website         = 
}}</syntaxhighlight>
|}

===Usage as a child template===
The '''embed''' parameter is used when embedding this infobox into another (see the [[Template:Infobox]] documentation which explains [[Template:Infobox/doc#Embedding|embedding]] and [[Template:Infobox/doc#Subboxes|subboxes]]).

<syntaxhighlight lang="wikitext">
{{Infobox ABC
|name= 
|<!-- etc. -->
|embedded=<!-- or module= -->
  {{Infobox port
  |embed= yes
  |<!-- etc. -->
  }}
}}</syntaxhighlight>

===Embedding other templates===
The '''embedded''' parameter is used for embedding other templates into this infobox (see [[Wikipedia:Infobox modules]]).

<syntaxhighlight lang="wikitext">
{{Infobox port
|name= 
|<!-- etc. -->
|embedded=
  {{Infobox ABC
  |embed= yes
  |<!-- etc. -->
  }}
}}</syntaxhighlight>

==Parameter descriptions==
*{{Para|embed}}
*{{Para|name}} full name of port (in English)
*{{Para|image}} filename of image of the port
*{{Para|image_alt}} text for accessible caption
*{{Para|image_size}} width of image in px (use only for images smaller than 250px)
*{{Para|image_caption}} text for caption beneath image
*{{Para|logo}} filename of official logo image for the port
*{{Para|logo_alt}} alt text for the logo image
*{{Para|logo_size}} width of logo image in px (use only for images smaller than 250px) 
*{{Para|logo_caption}} caption for logo image
*{{Para|pushpin_map}} any value in this field will cause a map to appear
*{{Para|pushpin_map_geomask}} if set to 'Yes', the map with highlight the country and grey the rest
*{{Para|pushpin_map_zoom}} set zoom level for the map
*{{Para|pushpin_map_caption}} caption for pushpin map
*{{Para|country}} United Nations recognised country within which the port is located
*{{Para|location}} nearest city (also state/province/locale where relevant)
*{{Para|coordinates}} latitude and longitude - use {{Tlx|coord}} with {{Para|display|inline,title}}
*{{Para|coordinates_footnotes}} footnotes for coordinates
*{{Para|grid_name}}
*{{Para|grid_position}}
*{{Para|locode}} [[UN/Locode]] for the port 
*{{Para|opened}} year port was opened - use {{Tlx|Start date and age}} with {{Para|df|y}}
*{{Para|closed}} year port was closed (if it is no longer operating)
*{{Para|operated}} operator name
*{{Para|owner}} owner name
*{{Para|type}} type of port - open roadstead, coastal natural, coastal breakwater, coastal tide gate, river natural, river basin, river tide gate, lake, canal, offshore terminal, dry port - do not classify by cargo type (oil, container, etc) as this inevitably changes over time
*{{Para|sizewater}} size/area of the water surface of the port
*{{Para|sizeland}} size/area of the land of the port 
*{{Para|size}} total combined area of land and water
*{{Para|berths}} number of berths within the port
*{{Para|wharfs}} number of wharves within the port
*{{Para|piers}} number of piers within the port
*{{Para|draft_depth}} maximum draft or depth (please specify which) available within the port
*{{Para|air_draft}} any above-water height restrictions for vessels using the port; please also specify location of restriction, e.g. Hamilton Bridge.  
*{{Para|employees}} number of employees at the port
*{{Para|leadershiptitle}} job title of the port CEO
*{{Para|leader}} name of the port CEO
*{{Para|blankdetailstitle1}}
*{{Para|blankdetails1}}
*{{Para|blankdetailstitle2}}
*{{Para|blankdetails2}}
*{{Para|blankdetailstitle3}}
*{{Para|blankdetails3}}
*{{Para|blankdetailstitle4}}
*{{Para|blankdetails4}}
*{{Para|arrivals}} number of vessel arrivals at the port in an average or recent year
*{{Para|cargotonnage}} annual tonnage of cargo handled at the port
*{{Para|containervolume}} annual number of [[twenty foot equivalent unit]] (TEU) moved onto or off vessels  
*{{Para|cargovalue}} annual value of cargo handled at the port
*{{Para|passengertraffic}} annual number of passengers handled at the port
*{{Para|revenue}} annual revenue of the port
*{{Para|profit}} annual profit of the port
*{{Para|blankstatstitle1}}
*{{Para|blankstats1}}
*{{Para|blankstatstitle2}}
*{{Para|blankstats2}}
*{{Para|blankstatstitle3}}
*{{Para|blankstats3}}
*{{Para|website}} official websiter of the port (please us {{tl|official}})
*{{Para|embedded}}

==TemplateData==
{{TemplateData header}}
<templatedata>{
	"params": {
		"embed": {},
		"name": {
			"description": "name of port"
		},
		"image": {
			"description": "filename of image of the port",
            "type": "wiki-file-name"
		},
		"image_alt": {
			"description": "text for accessible caption"
		},
		"image_size": {
			"description": "width of image in px (use only for images smaller than 250px)"
		},
		"image_caption": {
			"description": "text for caption beneath image"
		},
		"logo": {
			"description": "filename of official logo image for the port"
		},
		"logo_alt": {
			"description": "alt text for the logo image"
		},
		"logo_size": {
			"description": "width of logo image in px (use only for images smaller than 250px)"
		},
		"logo_caption": {
			"description": "caption for logo image"
		},
		"pushpin_map": {
			"description": "any value in this field will cause a map to appear"
		},
		"pushpin_map_geomask": {
			"description": "if set to \"Yes\", the map with highlight the country and grey the rest"
		},
		"pushpin_map_zoom": {
			"description": "set zoom level for the map"
		},
		"pushpin_map_caption": {
			"description": "caption for pushpin map"
		},
		"country": {
			"description": "UN recognised country within which the port is located"
		},
		"location": {
			"description": "nearest city (also state/province/locale where relevant)"
		},
		"coordinates": {
			"description": "latitude and longitude - Use {{coord}} with |display=inline,title"
		},
		"coordinates_footnotes": {
			"description": "footnotes for coordinates"
		},
		"grid_name": {},
		"grid_position": {},
		"locode": {
			"description": "UN/Locode for the port"
		},
		"opened": {
			"description": "year port was opened"
		},
		"closed": {
			"description": "year port was closed (if it is no longer operating)"
		},
		"operated": {
			"description": "operator name"
		},
		"owner": {
			"description": "owner name"
		},
		"type": {
			"description": "Type of port - do not classify by cargo type (oil, container, etc) as this inevitably changes over time",
			"suggestedvalues": [
				"open roadstead",
				"coastal natural",
				"coastal breakwater",
				"coastal tide gate",
				"river natural",
				"river basin",
				"river tide gate",
				"lake",
				"canal",
				"offshore terminal",
				"dry port"
			]
		},
		"sizewater": {
			"description": "size/area of the water surface of the port"
		},
		"sizeland": {
			"description": "size/area of the land of the port"
		},
		"size": {},
		"berths": {
			"description": "number of berths within the port"
		},
		"wharfs": {
			"description": "number of wharves within the port"
		},
		"piers": {
			"description": "number of piers within the port"
		},
		"draft_depth": {
			"description": "maximum draft or depth (please specify which) available within the port"
		},
		"air_draft": {
			"description": "any above-water height restrictions for vessels using the port. Please also specify location of restriction, e.g. Hamilton Bridge."
		},
		"employees": {
			"description": "number of employees at the port"
		},
		"leadershiptitle": {
			"description": "job title of the port CEO"
		},
		"leader": {
			"description": "name of the port CEO"
		},
		"blankdetailstitle1": {},
		"blankdetails1": {},
		"blankdetailstitle2": {},
		"blankdetails2": {},
		"blankdetailstitle3": {},
		"blankdetails3": {},
		"blankdetailstitle4": {},
		"blankdetails4": {},
		"arrivals": {
			"description": "number of vessel arrivals at the port in an average or recent year"
		},
		"cargotonnage": {
			"description": "annual tonnage of cargo handled at the port"
		},
		"containervolume": {
			"description": "annual number of TEUs moved onto or off vessels"
		},
		"cargovalue": {
			"description": "annual value of cargo handled at the port"
		},
		"passengertraffic": {
			"description": "annual number of passengers handled at the port"
		},
		"revenue": {
			"description": "annual revenue of the port"
		},
		"profit": {
			"description": "annual profit of the port"
		},
		"blankstatstitle1": {},
		"blankstats1": {},
		"blankstatstitle2": {},
		"blankstats2": {},
		"blankstatstitle3": {},
		"blankstats3": {},
		"website": {
			"description": "official websiter of the port (please us {{official}})"
		},
		"embedded": {}
	},
	"format": "block",
	"description": "Infobox for use on articles about ports"
}</templatedata>

==Tracking category==
*{{Category link with count|Pages using infobox port with unknown parameters}}<includeonly>{{Sandbox other||
[[Category:Transport infobox templates|Port]]
[[Category:Water transport infobox templates|Port]]
[[Category:Place infobox templates|Port]]
[[Category:Embeddable templates]]
[[Category:Templates that add a tracking category]]
}}</includeonly>