عرض مصدر قالب:Location map/doc/Converting map definition templates to modules

== Converting definitions ==
This checklist lists the steps required to convert a location map definition from a template to a module. In this example, the definition will be called "Foobar".
#Create [[وحدة:Location map/data/Foobar]] with the same values as [[قالب:Location map Foobar]]. See [[قالب:Location map/Creating a new map definition]] for more details on this step. Note that if a map contains formulas for x and/or y, all occurrences of <nowiki>{{{2}}} or {{{2|}}}</nowiki> need to be changed to $1, and all occurrences of <nowiki>{{{3}}} or {{{3|}}}</nowiki> need to be changed to $2.
#If [[قالب:Location map Foobar]] is protected, request that [[وحدة:Location map/data/Foobar]] be protected at the same level.
#If any pages redirect to [[قالب:Location map Foobar]], follow the steps under the [[#Converting redirects]] heading below for each of them.
#If [[قالب:Location map Foobar/doc]] exists, move it to [[وحدة:Location map/data/Foobar/doc]] and convert it following the instructions under the [[#Converting documentation]] heading below.
#If [[نقاش القالب:Location map Foobar]] exists, move it to [[نقاش الوحدة:Location map/data/Foobar]].
#Blank [[قالب:Location map Foobar]].
#Move [[قالب:Location map Foobar]] to [[نقاش الوحدة:Location map/data/Foobar/attribution]], or request this move at [[أرابيكا:RM/TR]] if you're unable to perform it yourself.
#Request that [[نقاش الوحدة:Location map/data/Foobar/attribution]] be indefinitely fully protected, since it's only being kept for its history.
#Add the following to the top of [[نقاش الوحدة:Location map/data/Foobar]], or create it with this content if it doesn't exist:{{#tag:pre|<nowiki>{{صندوق رسالة نقاش
|type=notice
|text=Revision history for the template that was converted to [[Module:Location map/data/Foobar]] can be found at [[Module talk:Location map/data/Foobar/attribution]].
}}</nowiki>}}
#Update any links that point to [[قالب:Location map Foobar]] to point to [[وحدة:Location map/data/Foobar]].
#Request that [[قالب:Location map Foobar]] be deleted under CSD G6.
#Request that any subpages or talk pages of [[قالب:Location map Foobar]] be deleted under CSD G8.

== Converting redirects ==
This checklist lists the steps required to convert a redirect to a location map definition from a template to a module. In this example, the redirect will be called "Foo" and will point to "Foobar".
#Create [[وحدة:Location map/data/Foo]] with <syntaxhighlight lang="lua">return require('Module:Location map/data/Foobar')</syntaxhighlight> as the content.
#If [[قالب:Location map Foo]] is protected, request that [[وحدة:Location map/data/Foo]] be protected at the same level.
#Create [[وحدة:Location map/data/Foo/doc]] as a redirect to [[وحدة:Location map/data/Foobar/doc]].
#Request that [[قالب:Location map Foo]] be deleted under CSD G6.
#Request that any subpages or talk pages of [[قالب:Location map Foo]] be deleted under CSD G8.

== Converting documentation ==
Replace the documentation page, except for comments, categories, etc. with a transclusion of [[وحدة:Location map/data/شرح|Module:Location map/data/doc]]. To match the appearance of the old doc page, the following parameters are accepted:
*<tt>image</tt> - the image displayed to the right of the introductory text. If omitted, no image is displayed.
*<tt>projection</tt> - the type of projection the map uses. If omitted, defaults to "an [[إسقاط متساوي المستطيلات]]".
*<tt>name</tt> - the name to use in the introductory text. If omitted, defaults to the name specified in the map definition.
*<tt>examples</tt> - the contents of the Examples section. The Examples header itself and the final {{قا|تحديد}} template are not required. If omitted, no examples section is displayed.
*<tt>see also</tt> - additional links to display at the top of the See also section. If omitted, no additional links are displayed.
If any features are present in the old doc page that [[وحدة:Location map/data/شرح|Module:Location map/data/doc]] does not support, please add support for them.

Here is an example of a converted doc page:
{{#tag:pre|<nowiki>
<!-- Categories and interwikis go at the bottom of this page. -->
{{Module:Location map/data/doc|image=<!-- [[File:|thumb|300px|Map of Sevastopol]] -->
|examples=
=== Location map, using default map (image) ===
{{خريطة مواقع| Sevastopol
| width   = 250
| lat_deg = 44.5
| lon_deg = 33.6
| label   = Balaklava
}}
<pre style="width:25em">
{{خريطة مواقع| Sevastopol
| width   = 250
| lat_deg = 44.5
| lon_deg = 33.6
| label   = Balaklava
}}
</pre>
|see also=
* [[قالب:خريطة مواقع/شبه جزيرة القرم]]
}}
<includeonly>
<!-- Categories and interwikis go here: -->

</includeonly></nowiki>}}<noinclude>
[[تصنيف:قوالب بأسماء أجنبية]]
</noinclude>