سانچو:Location map/Creating a new map definition

هي رهنمائي وضاحت ڪري ٿي ته {{Location map}} سانچن جي خاندان لاءِ نقشي جون وصفون ڪيئن ٺاهجن.

نقشي جي وصف وارو ڊيٽا

هي سانچا نقشي جي وصفن جي هڪ مجموعي مان ڪنهن هڪ کي استعمال ڪن ٿا۔ اهي الڳ فورڪ نه آهن، بلڪه مددگار صفحا آهن ۽ انهن جا نالا "Module:Location map/data/location" يا "Template:Location map location" واري نموني مطابق هجڻ گهرجن، جتي location ان علائقي جو نالو آهي جيڪو نقشو ڍڪي ٿو۔ سانچي واري جڳهه صرف پٺتي مطابقت لاءِ سهائتا ڪئي وڃي ٿي؛ سڀئي نيون نقشي جون وصفون ماڊيول طور ٺاهڻ گهرجن۔ اهم: جيڪڏهن نئون نقشو پراڻي نقشي جهڙي ئي پروجيڪشن ۽ حدون رکي ٿو (جهڙوڪ File:Iraq location map.svg ۽ File:Iraq location map2.svg)، ته نئين وصف نه ٺاهي وڃي؛ ان جي بدران، پراڻي وصف کي AlternativeMap پيراميٽر سان استعمال ڪيو وڃي۔ هڪ سادي نقشي جي وصف وارو ماڊيول ٺاهڻ لاءِ جيڪو equirectangular projection استعمال ڪندڙ نقشي جي تصوير تي ٻڌل هجي ۽ جنهن ۾ خط استوا معياري متوازي طور هجي (جنهن کي plate carrée، “unprojected”، lat/lon projection پڻ چيو وڃي ٿو):

1. نئين نقشي جي تصوير ٺاهيو ۽ ان کي وڪيميڊيا العام تي اپلوڊ ڪريو يا ساڳئي سائيٽ تي موجود نقشو ڳوليو۔
2. Module:Location map/data/location نالي ماڊيول ٺاهيو، هيٺ ڏنل مواد ان ۾ نقل ڪريو ۽ مناسب قدرن سان مٽايو۔
3. Module:Location map/data/location/doc نالي صفحو ٺاهيو ۽ #Documentation هيٺ ڏنل هدايتن تي عمل ڪريو۔

هڪ اهڙي نقشي جي مثال طور جيڪو equirectangular projection استعمال ڪري ٿو، اسان Module:Location map/data/Belgium استعمال ڪريون ٿا۔ مهرباني ڪري فعال سانچن تي تجربا نه ڪريو۔

return {
	name = 'Belgium',
	top = 51.8,
	bottom = 49.2,
	left = 2.2,
	right = 6.9,
	image = 'Belgium location map.svg',
	image1 = 'Belgium relief location map.jpg'
}

پيراميٽر	وضاحت
name	ڍڪيل علائقي جو نالو
top	تصوير جي مٿئين ڪناري جو ويڪرائي ڦاڪ (decimal degrees استعمال ڪندي)
bottom	تصوير جي هيٺئين ڪناري جو ويڪرائي ڦاڪ
left	تصوير جي کاٻي ڪناري جو ڊگھائي ڦاڪ
right	تصوير جي ساڄي ڪناري جو ڊگھائي ڦاڪ
image	العام تي تصويري فائل جو نالو
image1	متبادل تصوير جو نالو، عام طور رليف نقشو، جنهن تائين relief پيراميٽر ذريعي رسائي ٿي سگهي ٿي۔

هن قسم جا نقشا ننڍن کان وچولي علائقن لاءِ ڪم ڪندا۔ Module:Location map/data/USA Alabama اهڙي نقشي جي وضاحت جو ٻيو مثال آهي جيڪو equirectangular projection استعمال ڪري ٿو۔ ڌيان ڏيو ته ملڪ جي تصوير اها نه آهي جيڪا گهڻا ماڻهو توقع ڪن ٿا۔

ترقي يافته پروجيڪشنون

اهي نقشا جيڪي ٻيون پروجيڪشنون استعمال ڪن ٿا، جهڙوڪ Module:Location map/data/USA، جيڪو equidistant conic projection استعمال ڪري ٿو، انهن لاءِ فارمولن جي ضرورت هوندي آهي جيڪي مقام واري نشان لاءِ x ۽ y همراهون ڳڻپ ڪن ٿا۔ انهن فارمولن کي سمجهڻ لاءِ موضوع سان واقفيت ضروري آهي، تنهنڪري توهان ڀلي هن حصي کي ڇڏي سگهو ٿا۔

ان پُٽ $1 ويڪرائي ڦاڪ آهي ۽ $2 ڊگھائي ڦاڪ، ٻئي decimal صورت ۾۔ اظهار ParserFunction "#expr" جي نحو تي عمل ڪري ٿو۔ ٻه آئوٽ پُٽ همراهون اهڙي طرح بيان ڪيل آهن جو x جو فارمولو تصوير جي کاٻي ڪناري لاءِ 0 ۽ ساڄي ڪناري لاءِ 100 ڏئي؛ جڏهن ته y جو فارمولو مٿئين ڪناري لاءِ 0 ۽ هيٺئين ڪناري لاءِ 100 ڏئي ٿو۔

دستاويزڪاري

دستاويزي صفحو ٺاهڻ لاءِ Template:Location map data documentation تي موجود de facto سانچو استعمال ڪرڻ آسان ترين طريقو آهي۔ هتي هڪ ٻيو مثال ڏنو ويو آهي ته دستاويزڪاري ڪيئن نظر اچي سگهي ٿي:

<!-- زمرا ۽ بين الويڪي هن صفحي جي آخر ۾ وڃن ٿا۔ -->
{{Location map data documentation|image=[[File:Belgium-CIA WFB Map.png|thumb|250px|بيلجيم جو نقشو]]
|examples=
=== مقام جو نقشو، ڊفالٽ نقشو (image) استعمال ڪندي ===
{{Location map | Belgium
| width   = 200
| lat_deg = 50.85
| lon_deg = 4.35
| label   = Brussels
}}
<pre style="width:30em">
{{Location map | Belgium
| width   = 200
| lat_deg = 50.85
| lon_deg = 4.35
| label   = Brussels
}}
</pre>
{{clear}}

=== گھڻن جڳهن وارو مقام جو نقشو، رليف نقشو (image1) استعمال ڪندي ===
{{Location map many | Belgium
| relief   = yes
| width    = 200
| caption  = بيلجيم ۾ ٻه جڳهيون
| lat1_deg = 50.85
| lon1_deg = 4.35
| label1   = Brussels
| lat2_deg = 51.22
| lon2_deg = 4.40
| label2   = Antwerp
}}
<pre style="width:30em">
{{Location map many | Belgium
| relief   = yes
| width    = 200
| caption  = بيلجيم ۾ ٻه جڳهيون
| lat1_deg = 50.85
| lon1_deg = 4.35
| label1   = Brussels
| lat2_deg = 51.22
| lon2_deg = 4.40
| label2   = Antwerp
}}
</pre>
{{clear}}

=== Location map+، AlternativeMap استعمال ڪندي ===
{{Location map+ | Belgium
| AlternativeMap = Belgium relief location map.jpg
| width   = 200
| caption = بيلجيم ۾ ٻه جڳهيون
| places  =
  {{Location map~ | Belgium
  | lat_deg = 50.85
  | lon_deg = 4.35
  | label   = Brussels
  }}
  {{Location map~ | Belgium
  | lat_deg = 51.22
  | lon_deg = 4.40
  | label   = Antwerp
  }}
}}
<pre style="width:35em">
{{Location map+ | Belgium
| AlternativeMap = Belgium relief location map.jpg
| width   = 200
| caption = بيلجيم ۾ ٻه جڳهيون
| places  =
  {{Location map~ | Belgium
  | lat_deg = 50.85
  | lon_deg = 4.35
  | label   = Brussels
  }}
  {{Location map~ | Belgium
  | lat_deg = 51.22
  | lon_deg = 4.40
  | label   = Antwerp
  }}
}}
</pre>
}}
<includeonly>
<!-- زمرا هتي وڃن، ۽ بين الويڪي وڪي ڊيٽا تي وڃن: -->

[[زمرو:بيلجيم مقام-نقشي سانچا|بيلجيم مقام-نقشي سانچا]]

</includeonly>