Template:Coord/doc - Revision history

Ookami: 374 revisions imported

2020-09-03T01:08:25Z

374 revisions imported

← Older revision	Revision as of 01:08, 3 September 2020
(No difference)

meta>Bsherr: as found, replacing Template:Tld with Template:Tlf or adding/updating category placement comments, plus general and typo fixes, typo(s) fixed: in the mean time → in the meantime

2020-08-09T22:57:32Z

as found, replacing Template:Tld with Template:Tlf or adding/updating category placement comments, plus general and typo fixes, typo(s) fixed: in the mean time → in the meantime

← Older revision		Revision as of 22:57, 9 August 2020
Line 9:		Line 9:

	__TOC__		__TOC__

	==Purpose==		==Purpose==
	{{~~Tld~~\|Coord}} provides a standard notation for encoding locations by their [[latitude]] and [[longitude]] coordinates. It is primarily for specifying the [[World Geodetic System\|WGS84]] geographic coordinates of locations on [[Earth]], at the same time emitting a machine-readable [[Geo (microformat)\|Geo microformat]]. However, it can also encode locations on natural satellites, dwarf planets, and planets other than Earth.		{{tlf\|Coord}} provides a standard notation for encoding locations by their [[latitude]] and [[longitude]] coordinates. It is primarily for specifying the [[World Geodetic System\|WGS84]] geographic coordinates of locations on [[Earth]], at the same time emitting a machine-readable [[Geo (microformat)\|Geo microformat]]. However, it can also encode locations on natural satellites, dwarf planets, and planets other than Earth.

	* To specify celestial coordinates, use {{tl\|Sky}} instead.		* To specify celestial coordinates, use {{tl\|Sky}} instead.
Line 42:		Line 43:
	The template '''must not''' be modified without prior discussion.		The template '''must not''' be modified without prior discussion.

	Tools which read Wikipedia database dumps (such as [[Google Earth]]) often ignore inline coordinates. To ensure that coordinates are seen by these tools, one set should be displayed beside the title. See [https://support.google.com/earth/bin/answer.py?hl=en&answer=2395280 How do I get my Wikipedia article to show up in the Google Earth Geographic Web layer?]{{dead link}}. However, if multiple title coordinates appear on a single page, they will overlap, making them illegible.		Tools which read Wikipedia database dumps (such as [[Google Earth]]) often ignore inline coordinates. To ensure that coordinates are seen by these tools, one set should be displayed beside the title. See [https://support.google.com/earth/bin/answer.py?hl=en&answer=2395280 How do I get my Wikipedia article to show up in the Google Earth Geographic Web layer?]{{dead link\|date=August 2020}}. However, if multiple title coordinates appear on a single page, they will overlap, making them illegible.

	== Usage ==		== Usage ==
Line 76:		Line 77:
	Helper functions are available to manipulate the output from {{tl\|Coord}} when it appears in a container template such as an infobox.		Helper functions are available to manipulate the output from {{tl\|Coord}} when it appears in a container template such as an infobox.

	===To extract the latitude from a Coord template===		===To extract the latitude from a Coord template===
	Use:		Use:

Line 200:		Line 201:

	==Incorrect uses and maintenance categories==		==Incorrect uses and maintenance categories==
	The template has some input checks built in. Most errors display a <span style="color:red;">~~<b>~~bold, red~~</b>~~</span> message inline and categorize the article in the [[Wikipedia:Hidden category\|hidden]] [[Wikipedia:Categorization#Non-article and maintenance categories\|maintenance category]] '''[[:Category:Pages with malformed coordinate tags\|Pages with malformed coordinate tags]]'''. There {{#IFEQ:{{PAGESINCATEGORY:Pages with malformed coordinate tags}}\|1\|is currently '''1''' page\|are currently '''{{PAGESINCATEGORY:Pages with malformed coordinate tags}}''' pages}} in that category. See the category description for further instructions.		The template has some input checks built in. Most errors display a <span style="color:red;">'''bold, red'''</span> message inline and categorize the article in the [[Wikipedia:Hidden category\|hidden]] [[Wikipedia:Categorization#Non-article and maintenance categories\|maintenance category]] '''[[:Category:Pages with malformed coordinate tags\|Pages with malformed coordinate tags]]'''. There {{#IFEQ:{{PAGESINCATEGORY:Pages with malformed coordinate tags}}\|1\|is currently '''1''' page\|are currently '''{{PAGESINCATEGORY:Pages with malformed coordinate tags}}''' pages}} in that category. See the category description for further instructions.

	A more thorough daily report of coordinates needing repair is at [[tools:~dispenser/view/File viewer#log:coord-enwiki.log]].		A more thorough daily report of coordinates needing repair is at [[tools:~dispenser/view/File viewer#log:coord-enwiki.log]].
Line 216:		Line 217:

	===Template Data===		===Template Data===
	This template uses overloading which does not work well with the [[Wikipedia:TemplateData\|VisualEditor/TemplateData]]. Consider using "Edit source" instead of the visual editor until this defect is corrected. To facilitate visual editing in the ~~mean time~~, consider using {{tl\|coordDec}} for signed decimal degrees, {{tl\|coordDMS}} when degrees minutes and seconds are specified, and {{tl\|coordDM}} when just degrees and minutes are given.		This template uses overloading which does not work well with the [[Wikipedia:TemplateData\|VisualEditor/TemplateData]]. Consider using "Edit source" instead of the visual editor until this defect is corrected. To facilitate visual editing in the meantime, consider using {{tl\|coordDec}} for signed decimal degrees, {{tl\|coordDMS}} when degrees minutes and seconds are specified, and {{tl\|coordDM}} when just degrees and minutes are given.

	{{TemplateData header}}		{{TemplateData header}}
Line 371:		Line 372:
	-->		-->
	<includeonly>{{Sandbox other\|\|		<includeonly>{{Sandbox other\|\|
	<!-- Categories below this line~~, please~~; interwikis at Wikidata -->		<!-- Categories below this line; interwikis at Wikidata -->
	[[Category:Coord template]]		[[Category:Coord template]]
	[[Category:Coordinates conversion templates\| ]]		[[Category:Coordinates conversion templates\| ]]

meta>Vanisaac: /* Template Data */clean up per WP:CAT#T and WP:AWBREQ add template:Sandbox other

2020-04-24T16:14:13Z

Template Data: clean up per WP:CAT#T and WP:AWBREQ add template:Sandbox other

← Older revision		Revision as of 16:14, 24 April 2020
Line 370:		Line 370:

	-->		-->
	<includeonly>{{~~#ifeq:{{SUBPAGENAME}}\|sandbox~~ \| \|		<includeonly>{{Sandbox other\|\|
	<!-- Categories below this line, please; interwikis at Wikidata -->		<!-- Categories below this line, please; interwikis at Wikidata -->
	[[Category:Coord template]]		[[Category:Coord template]]

meta>TheDJ: preserve history, but don't present

2020-03-13T11:30:12Z

preserve history, but don't present

← Older revision		Revision as of 11:30, 13 March 2020
Line 207:		Line 207:

	==Internals==		==Internals==
	~~See [[Template:Coord/doc/internals]] and [[:Category:Coord~~ template~~]].~~		This template is completely powered by the [[Wikipedia:Lua\|Lua module]] {{tlm\|Coordinates}}.

	~~===Subtemplates===~~
	~~{{Coord/sub doc}}~~

	~~===Coordinates in PDF===~~
	~~For generating PDF, printed books, and Open Office export format, two templates are [[Help:Books/for_experts#Improving_the_book_layout\|substituted for~~ the ~~regular templates]]:~~
	*[[Template:Coord/display/title/Print]] for {{tl\|Coord/display/title}}
	*[[~~Template~~:~~Coord/link/Print]] for {{tl~~\|~~Coord/link}}~~
	*[[Template:Coord/display/inline,title/Print]] ~~for~~ {{tl\|~~Coord/display/inline,title~~}}

	~~Samples are available at:~~
	*[[Help:Books/Feedback/Tests/coord 1]]
	*[[Help:Books/Feedback/Tests/coord 2]]

	===Class names===		===Class names===
	The class names '''geo''', '''latitude''' and '''longitude''' are used to generate the microformat and '''MUST NOT''' be changed.		The class names '''geo''', '''latitude''' and '''longitude''' are used to generate the microformat and '''MUST NOT''' be changed.

			===History===
			This template used to use a lot of [[Template:Coord/doc/internals\|sub templates]] but these have all been replaced by {{tlm\|Coordinates}}.

	===Template Data===		===Template Data===

meta>TheDJ: ancient info, lets stop confusing people with it

2020-03-06T14:15:10Z

ancient info, lets stop confusing people with it

← Older revision		Revision as of 14:15, 6 March 2020
Line 43:		Line 43:

	Tools which read Wikipedia database dumps (such as [[Google Earth]]) often ignore inline coordinates. To ensure that coordinates are seen by these tools, one set should be displayed beside the title. See [https://support.google.com/earth/bin/answer.py?hl=en&answer=2395280 How do I get my Wikipedia article to show up in the Google Earth Geographic Web layer?]{{dead link}}. However, if multiple title coordinates appear on a single page, they will overlap, making them illegible.		Tools which read Wikipedia database dumps (such as [[Google Earth]]) often ignore inline coordinates. To ensure that coordinates are seen by these tools, one set should be displayed beside the title. See [https://support.google.com/earth/bin/answer.py?hl=en&answer=2395280 How do I get my Wikipedia article to show up in the Google Earth Geographic Web layer?]{{dead link}}. However, if multiple title coordinates appear on a single page, they will overlap, making them illegible.

	~~==Superseded templates==~~
	This single template supersedes {{tl\|coor d}}, (and others in that family which have since been redirected to it), plus the [{{fullurl:Special:PrefixIndex\|from=Geolinks&namespace=10}} Geolinks] and [{{fullurl:Special:PrefixIndex\|from=Mapit&namespace=10}} Mapit] templates. Most parameters can be used as before – see [[#Usage\|Usage]].

	~~Examples:~~
	~~<table class="wikitable">~~
	~~<tr><td>{{coord\|10.2\|N\|-20.3\|E\|'''type:'''city}}</td><td>Replaces {{coor d\|10.2\|N\|-20.3\|E\|city}}</td></tr>~~

	~~<tr><td>{{coord\|44.4\|-111.1\|'''type:city_region:US'''\|display=inline,title}}</td><td>Replaces {{Geolinks-'''US-cityscale'''\|44.4\|-111.1}}</td></tr>~~

	~~<tr><td>{{coord\|51.01234\|-1.56789\|'''type:landmark_region:GB'''\|display=inline,title}}</td><td>Replaces {{Geolinks-'''UK-buildingscale'''\|51.01234\|-1.56789}}</td></tr>~~

	~~<tr><td>{{coord\|-35.5\|150.1\|'''type:landmark_region:AU'''\|display=inline,title}}</td><td>Replaces {{Mapit-'''AUS-suburbscale'''\|lat=-35.5\|long=150.1}}</td></tr>~~

	~~<tr><td>{{coord\|12\|34\|12\|N\|45\|33\|45\|W\|'''display=title'''}}</td><td>Replaces {{'''CoorHeader'''\|12\|34\|12\|N\|45\|33\|45\|W}}</td></tr>~~

	~~</table>~~

	== Usage ==		== Usage ==

meta>TheDJ: /* Usage */

2020-03-06T13:03:58Z

Usage

← Older revision		Revision as of 13:03, 6 March 2020
Line 88:		Line 88:
	::Note: a ''name='' parameter causes {{tl\|Coord}} to emit an [[hCard]] [[microformat]] using that name, ''even if used within an existing hCard''. Do not use when the name is that of a person (e.g for a gravesite), as the generated hCard would be invalid. Also, do not use square brackets in names.		::Note: a ''name='' parameter causes {{tl\|Coord}} to emit an [[hCard]] [[microformat]] using that name, ''even if used within an existing hCard''. Do not use when the name is that of a person (e.g for a gravesite), as the generated hCard would be invalid. Also, do not use square brackets in names.
	:* '''notes=''' specifies text to be displayed immediately following the coordinates. This is primarily intended for adding footnotes to coordinates displayed beside the title.		:* '''notes=''' specifies text to be displayed immediately following the coordinates. This is primarily intended for adding footnotes to coordinates displayed beside the title.
			:* '''qid=''' specify Q item to display the coordinates of. Used primarily by Wikidata powered infoboxes.

	==Helper functions==		==Helper functions==

meta>TheDJ: use suggested mode and add the qid param

2020-03-06T12:51:08Z

use suggested mode and add the qid param

← Older revision		Revision as of 12:51, 6 March 2020
Line 252:		Line 252:
	"description": "Either degrees latitude or a signed decimal degrees latitude",		"description": "Either degrees latitude or a signed decimal degrees latitude",
	"type": "number",		"type": "number",
	"required": true		"required": false,
			"suggested": true
	},		},
	"2": {		"2": {
Line 258:		Line 259:
	"description": "Either: minutes latitude, signed decimal degrees longitude or 'N' or 'S'.",		"description": "Either: minutes latitude, signed decimal degrees longitude or 'N' or 'S'.",
	"type": "string",		"type": "string",
	"required": true		"required": false,
			"suggested": true
	},		},
	"3": {		"3": {
Line 301:		Line 303:
	"type": "string",		"type": "string",
	"required": false		"required": false
			},
			"qid": {
			"label": "Wikidata item",
			"description": "Retrieve coordinates from a WikiData entry instead of from this template's parameters",
			"type": "line",
			"required": false,
			"example": "Q513"
	},		},
	"display": {		"display": {
Line 307:		Line 316:
	"type": "line",		"type": "line",
	"default": "inline",		"default": "inline",
			"suggested": true,
	"required": false		"required": false
	},		},

meta>GreenComputer: Update TemplateData

2019-12-24T11:57:44Z

Update TemplateData

Show changes

meta>Paine Ellsworth: update /doc

2019-09-23T21:28:01Z

update /doc

← Older revision		Revision as of 21:28, 23 September 2019
Line 1:		Line 1:
	{{Documentation subpage}}		{{Documentation subpage}}
	{{#ifeq: {{FULLPAGENAME}} \| Template:Coord \| {{high-risk\|~~1,140,000+~~}} }}		{{#ifeq: {{FULLPAGENAME}} \| Template:Coord \| {{high-risk\| 1186993 }} }}
	{{Transwiki guide candidate}}		{{Transwiki guide candidate}}
	{{lua\|Module:Coordinates}}		{{lua\|Module:Coordinates}}

meta>Colonies Chris: minor fixes

2019-05-22T21:03:33Z

minor fixes

← Older revision		Revision as of 21:03, 22 May 2019
Line 24:		Line 24:
	The template displays the formatted coordinates with a [[hyperlink]] to [[tswiki:GeoHack\|GeoHack]]. GeoHack displays information customized to the location, including links to external mapping services.		The template displays the formatted coordinates with a [[hyperlink]] to [[tswiki:GeoHack\|GeoHack]]. GeoHack displays information customized to the location, including links to external mapping services.

	For ~~[[Earth\|~~terrestrial]] locations, a blue globe ([[Image:Erioll_world.svg\|18px]]) appears to the left of the hyperlink. Clicking on the globe activates the [[:meta:WikiMiniAtlas\|WikiMiniAtlas]] (requires [[JavaScript]]).		For terrestrial locations, a blue globe ([[Image:Erioll_world.svg\|18px]]) appears to the left of the hyperlink. Clicking on the globe activates the [[:meta:WikiMiniAtlas\|WikiMiniAtlas]] (requires [[JavaScript]]).

	By default, coordinates appear "in line" with the adjacent text. However, the <code>display=</code> parameter can be used to move the coordinates up near the page title—or display them in both places at once.		By default, coordinates appear "in line" with the adjacent text. However, the <code>display=</code> parameter can be used to move the coordinates up near the page title—or display them in both places at once.
Line 42:		Line 42:
	The template '''must not''' be modified without prior discussion.		The template '''must not''' be modified without prior discussion.

	Tools which read Wikipedia database dumps (such as [[Google Earth]]) often ignore inline coordinates. To ensure that coordinates are seen by these tools, one set should be displayed beside the title. See [https://support.google.com/earth/bin/answer.py?hl=en&answer=2395280 How do I get my Wikipedia article to show up in the Google Earth Geographic Web layer?]{{~~deadlink~~}}. However, if multiple title coordinates appear on a single page, they will overlap, making them illegible.		Tools which read Wikipedia database dumps (such as [[Google Earth]]) often ignore inline coordinates. To ensure that coordinates are seen by these tools, one set should be displayed beside the title. See [https://support.google.com/earth/bin/answer.py?hl=en&answer=2395280 How do I get my Wikipedia article to show up in the Google Earth Geographic Web layer?]{{dead link}}. However, if multiple title coordinates appear on a single page, they will overlap, making them illegible.

	==Superseded templates==		==Superseded templates==
Line 88:		Line 88:
	::Note: a ''name='' parameter causes {{tl\|Coord}} to emit an [[hCard]] [[microformat]] using that name, ''even if used within an existing hCard''. Do not use when the name is that of a person (e.g for a gravesite), as the generated hCard would be invalid. Also, do not use square brackets in names.		::Note: a ''name='' parameter causes {{tl\|Coord}} to emit an [[hCard]] [[microformat]] using that name, ''even if used within an existing hCard''. Do not use when the name is that of a person (e.g for a gravesite), as the generated hCard would be invalid. Also, do not use square brackets in names.
	:* '''notes=''' specifies text to be displayed immediately following the coordinates. This is primarily intended for adding footnotes to coordinates displayed beside the title.		:* '''notes=''' specifies text to be displayed immediately following the coordinates. This is primarily intended for adding footnotes to coordinates displayed beside the title.

	==Helper functions==		==Helper functions==
	Helper functions are available to manipulate the output from {{t\|Coord}} when it appears in a container template such as an infobox.		Helper functions are available to manipulate the output from {{tl\|Coord}} when it appears in a container template such as an infobox.

	===To extract the latitude from a Coord template===		===To extract the latitude from a Coord template===
	Use:		Use:
Line 214:		Line 216:

	==Incorrect uses and maintenance categories==		==Incorrect uses and maintenance categories==
	The template has some input checks built in. Most errors display a <span style="color:red;"><b>bold, red</b></span> message inline and categorize the article in the [[Wikipedia:Hidden category\|hidden]] [[Wikipedia:Categorization#Non-article and maintenance categories\|maintenance category]] '''[[:Category:Pages with malformed coordinate tags\|Pages with malformed coordinate tags]]'''. There {{#IFEQ:{{PAGESINCATEGORY:Pages with malformed coordinate tags}}\|1\|is currently '''1''' page\|are currently '''{{PAGESINCATEGORY:Pages with malformed coordinate tags}}''' pages}} in that category. See the category description for further instructions.		The template has some input checks built in. Most errors display a <span style="color:red;"><b>bold, red</b></span> message inline and categorize the article in the [[Wikipedia:Hidden category\|hidden]] [[Wikipedia:Categorization#Non-article and maintenance categories\|maintenance category]] '''[[:Category:Pages with malformed coordinate tags\|Pages with malformed coordinate tags]]'''. There {{#IFEQ:{{PAGESINCATEGORY:Pages with malformed coordinate tags}}\|1\|is currently '''1''' page\|are currently '''{{PAGESINCATEGORY:Pages with malformed coordinate tags}}''' pages}} in that category. See the category description for further instructions.

	A more thorough daily report of coordinates needing repair is at [[tools:~dispenser/view/File viewer#log:coord-enwiki.log]].		A more thorough daily report of coordinates needing repair is at [[tools:~dispenser/view/File viewer#log:coord-enwiki.log]].
Line 240:		Line 242:

	===Template Data===		===Template Data===
	This template uses overloading which does not work well with the [[Wikipedia:~~VisualEditor/~~TemplateData\|VisualEditor/TemplateData]]. Consider using "Edit source" instead of the visual editor until this defect is corrected. To facilitate visual editing in the mean time, consider using {{tl\|coordDec}} for signed decimal degrees, {{tl\|coordDMS}} when degrees minutes and seconds are specified, and {{tl\|coordDM}} when just degrees and minutes are given.		This template uses overloading which does not work well with the [[Wikipedia:TemplateData\|VisualEditor/TemplateData]]. Consider using "Edit source" instead of the visual editor until this defect is corrected. To facilitate visual editing in the mean time, consider using {{tl\|coordDec}} for signed decimal degrees, {{tl\|coordDMS}} when degrees minutes and seconds are specified, and {{tl\|coordDM}} when just degrees and minutes are given.

	{{~~TemplateDataHeader~~}}		{{TemplateData header}}
	<templatedata>{		<templatedata>{
	"description": "Encodes the latitude and longitude coordinates of a location, provides a link to map of the location. This template does not work well with the Visual Editor, consider using {{coordDec}} for signed decimal degrees, {{coordDMS}} when degrees minutes and seconds are specified {{coordDM}} when only degrees and minutes are specified. To use this template you will need to use positional parameter following one of these schemes: {{coord \| D \| M \| S \| NS \| D \| M \| S \| EW \| geo \| opts}}, {{coord \| D \| M \| NS \| D \| M \| EW \| geo \| opts}}, {{coord \| D\| NS \| D\| EW \| geo \| opts}} {{coord \| sD \| sD \| geo \| opts}} where D is degrees, M is minutes, S seconds, sD signed decimal degrees, NS is N or S, EW is E or W, opts are named parameter and geo are the coordinate parameters described on the main doc page.",		"description": "Encodes the latitude and longitude coordinates of a location, provides a link to map of the location. This template does not work well with the Visual Editor, consider using {{coordDec}} for signed decimal degrees, {{coordDMS}} when degrees minutes and seconds are specified {{coordDM}} when only degrees and minutes are specified. To use this template you will need to use positional parameter following one of these schemes: {{coord \| D \| M \| S \| NS \| D \| M \| S \| EW \| geo \| opts}}, {{coord \| D \| M \| NS \| D \| M \| EW \| geo \| opts}}, {{coord \| D\| NS \| D\| EW \| geo \| opts}} {{coord \| sD \| sD \| geo \| opts}} where D is degrees, M is minutes, S seconds, sD signed decimal degrees, NS is N or S, EW is E or W, opts are named parameter and geo are the coordinate parameters described on the main doc page.",