The Wiki for Tale 5 is in read-only mode and is available for archival and reference purposes only. Please visit the current Tale 11 Wiki in the meantime.

If you have any issues with this Wiki, please post in #wiki-editing on Discord or contact Brad in-game.

Difference between revisions of "Rogarian/GoogleMapsPageRewrite"

From ATITD5
Jump to navigationJump to search
Line 1: Line 1:
 
__TOC__  
 
__TOC__  
  
This wiki runs a modified version of the [http://www.mediawiki.org/wiki/Extension:Google_Maps Google Maps extension] for [http://www.mediawiki.org/wiki/MediaWiki MediaWiki].  It allows wiki users to create zoom-able, pan-able maps of Egypt with customized markers.  
+
== Google Maps ==
 +
 
 +
This wiki runs a modified version of the [http://www.mediawiki.org/wiki/Extension:Google_Maps Google Maps extension] for [http://www.mediawiki.org/wiki/MediaWiki MediaWiki].  The <nowiki><googlemap></nowiki> tag allows wiki users to create zoom-able, pan-able maps of Egypt with customized markers.
  
 
Simply add the following on a wiki page to create a default map:
 
Simply add the following on a wiki page to create a default map:
Line 8: Line 10:
 
</googlemap></nowiki>
 
</googlemap></nowiki>
  
Which creates:
+
This will generate a map like:
  
 
<googlemap>
 
<googlemap>
Line 14: Line 16:
  
  
== Tag Attributes ==
+
== Markers ==
 +
 
 +
In the content of the tag, you can define one marker per line. Each line may or may not start with an icon name in parentheses.  The line should then have the latitude (x), then a comma, optionally a space, then the longitude (y), then a comma, then a label for the point. The label can include wiki mark-up (and commas).
 +
 
 +
 
 +
A list of markers is available on [[User:Mayanah/map|Mayanahs map page.]]
 +
ATITD.org now hosts local copies of most of the icons Mayanah graciously provided.  These are used by default if the ''icons'' tag is not provided; the icons follow the same naming convention on Mayanahs page.  Click here to show all locally hosted markers: http://www.atitd.org/wiki/tale5/images/markers or visit [Rogarian/GoogleMapMarkerTest]] which shows all 1461 locally stored pins ('''Warning: will be VERY slow!''').
 +
 
 +
 
 +
 
 +
'''Marker Usage Example:'''
 +
 
 +
<nowiki><googlemap zoom="2" height="512" lon="0" controls="small" showposition="yes" showregion="yes" scrollwheel="nothing">
 +
(GH) 700,600,here goes the title
 +
400, 400, here goes the title, it can contain commas but not wiki markup
 +
(S) 100, 100, here goes the title
 +
first line of the caption
 +
Second line of the caption, not that the caption can contain wiki markup like [[Resources]]
 +
<br><br>
 +
</googlemap></nowiki>
 +
 
 +
 
 +
<googlemap zoom="2" height="512" lon="0" controls="small" showposition="yes" showregion="yes" scrollwheel="nothing">
 +
(GH) 700,600,here goes the title
 +
400, 400, here goes the title, it can contain commas but not wiki markup
 +
(S) 100, 100, here goes the title
 +
first line of the caption
 +
Second line of the caption, not that the caption can contain wiki markup like [[Resources]]
 +
<br><br>
 +
</googlemap>
 +
 
 +
 
 +
== Tabbed Info Balloons ==
 +
 
 +
Each tab should have a plain-text title surrounded by inward-leaning slashes (like /this\) followed by a caption that can include wiki mark-up. Tabs will be attached to the previous marker. Example:
 +
 
 +
<nowiki>
 +
<googlemap zoom="2" height="512" lon="0" controls="small" showposition="yes" showregion="yes" scrollwheel="nothing">
 +
(pyramid) 900,100
 +
/Info\
 +
This is where a pharaoh is buried! ;) (Not really)
 +
/Directions\
 +
[http://maps.google.com Click here] to get driving directions
 +
Or just drive in a random direction
 +
</googlemap></nowiki>
 +
 
 +
That will create a point whose info balloon has two tabs. Note that you can put as much or as little space as you'd like between the title and the caption to make the syntax more readable.
 +
 
 +
If a point has a regular caption ''and'' tabbed captions, clicking the point will only show the tabbed captions.
 +
 
 +
'''Example Map:'''
 +
 
 +
<googlemap zoom="2" height="512" lon="0" controls="small" showposition="yes" showregion="yes" scrollwheel="nothing">
 +
(pyramid) 900,100
 +
/Info\
 +
This is where a pharaoh is buried! ;) (Not really)
 +
/Directions\
 +
[http://maps.google.com Click here] to get driving directions
 +
Or just drive in a random direction
 +
</googlemap>
 +
 
 +
 
 +
== Map Customization / Tag Attributes ==
  
This extension defines a <nowiki><googlemap></nowiki> tag. Legal attributes are ('''boldface''' items are defaults):
+
To customize the map you can set various tags (attributes).
 +
Legal attributes are ('''boldface''' items are defaults):
  
 
{| border="1" cellpadding="5"  
 
{| border="1" cellpadding="5"  
Line 29: Line 94:
 
|cursor
 
|cursor
 
|Which mouse cursor to use on the map?
 
|Which mouse cursor to use on the map?
|Legal values: ''default'' (standard mouse cursor), ''crosshair'', '''pointer''' (hand).
+
|Legal values: '''pointer''' (hand), ''default'' (standard mouse cursor) and ''crosshair''.
 
|-
 
|-
 
|width
 
|width
Line 123: Line 188:
 
All attributes are optional.
 
All attributes are optional.
  
== Markers ==
+
== Customized Icons ==
 
 
In the content of the tag, you can define one marker per line. Each line may or may not start with an icon name in parentheses; unless you set the "icons" attribute, legal icon names are the upper-case letters of the alphabet. The line should then have the latitude, then a comma, optionally a space, then the longitude, then a comma, then a label for the point. The label can include wiki mark-up (and commas). These are all legal:
 
 
 
<nowiki><googlemap zoom="2" height="512" lon="0" controls="small" showposition="yes" showregion="yes" scrollwheel="nothing">
 
(GH) 700,600,here goes the title
 
400, 400, here goes the title, it can contain commas but not wiki markup
 
(S) 100, 100, here goes the title
 
first line of the caption
 
Second line of the caption, not that the caption can contain wiki markup like [[Resources]]
 
<br><br>
 
</googlemap></nowiki>
 
 
 
'''Example:'''
 
 
 
<googlemap zoom="2" height="512" lon="0" controls="small" showposition="yes" showregion="yes" scrollwheel="nothing">
 
(GH) 700,600,here goes the title
 
400, 400, here goes the title, it can contain commas but not wiki markup
 
(S) 100, 100, here goes the title
 
first line of the caption
 
Second line of the caption, not that the caption can contain wiki markup like [[Resources]]
 
<br><br>
 
</googlemap>
 
 
 
  
== Tabbed Info Balloons ==
+
You can host your own collection of icons on your server, but note that they'll have the same anchor points as ATITD.org's default icon (32x32). Check out [http://mapki.com/wiki/Icon_Image_Sets Mapki's collection of icon images] for a bunch of icons you can use. To use your icons, add an icon attribute to your googlemap-tags like this
 
 
Each tab should have a plain-text title surrounded by inward-leaning slashes (like /this\) followed by a caption that can include wiki mark-up. Tabs will be attached to the previous marker. Example:
 
 
 
<nowiki>
 
<googlemap zoom="2" height="512" lon="0" controls="small" showposition="yes" showregion="yes" scrollwheel="nothing">
 
(pyramid) 900,100
 
/Info\
 
This is where a pharo is buried! ;) (Not really)
 
/Directions\
 
[http://maps.google.com Click here] to get driving directions
 
Or just drive in a random direction
 
</googlemap></nowiki>
 
 
 
That will create a point whose info balloon has two tabs. Note that you can put as much or as little space as you'd like between the title and the caption to make the syntax more readable.
 
 
 
If a point has a regular caption ''and'' tabbed captions, clicking the point will only show the tabbed captions.
 
 
 
'''Example:'''
 
 
 
<googlemap zoom="2" height="512" lon="0" controls="small" showposition="yes" showregion="yes" scrollwheel="nothing">
 
(pyramid) 900,100
 
/Info\
 
This is where a pharo is buried! ;) (Not really)
 
/Directions\
 
[http://maps.google.com Click here] to get driving directions
 
Or just drive in a random direction
 
</googlemap>
 
 
 
 
 
== Icons ==
 
 
 
You can host your own collection of icons on your server, but note that they'll have the same anchor points as Google's default icon. Check out [http://mapki.com/wiki/Icon_Image_Sets Mapki's collection of icon images] for a bunch of icons you can use. To use your icons, add an icon attribute to your googlemap-tags like this
 
  
 
  <nowiki><googlemap lat="42.711618" lon="-73.205112" zoom="2" controls="small"  
 
  <nowiki><googlemap lat="42.711618" lon="-73.205112" zoom="2" controls="small"  
Line 187: Line 197:
  
 
[[User:Mayanah|Mayanah]] has some instructions for using an alternate set of icons [[User:Mayanah/map|map here]] and a set of [[User:Mayanah/map#Mine_Specific|Mine Specific]] icons and [[User:Mayanah/map#Quarry_Specific|Quarry Specific]]on the same page.
 
[[User:Mayanah|Mayanah]] has some instructions for using an alternate set of icons [[User:Mayanah/map|map here]] and a set of [[User:Mayanah/map#Mine_Specific|Mine Specific]] icons and [[User:Mayanah/map#Quarry_Specific|Quarry Specific]]on the same page.
 
ATITD.org now hosts local copies of all the icons Mayanah has provided and is used by default if the ''icons'' tag is not provided.
 
 
Click here to show all available markers: http://www.atitd.org/wiki/tale5/images/markers
 
  
  
Line 213: Line 219:
 
----
 
----
  
And a real map of egypt:
+
 
 +
===A real map of Egypt===
 
<pre>
 
<pre>
<googlemap lat="29.980624" lon="31.134653" zoom="14" controls="medium" type="hybrid" selector="yes">
+
<googlemap height="512" lat="29.980624" lon="31.134653" zoom="14" controls="medium" type="hybrid" selector="yes">
 
29.980624, 31.134653, PYRAMIDS
 
29.980624, 31.134653, PYRAMIDS
 
</googlemap>
 
</googlemap>
 
</pre>
 
</pre>
<googlemap lat="29.980624" lon="31.134653" zoom="14" controls="medium" type="hybrid" selector="yes">
+
<googlemap height="512" lat="29.980624" lon="31.134653" zoom="14" controls="medium" type="hybrid" selector="yes">
 
29.980624, 31.134653, PYRAMIDS
 
29.980624, 31.134653, PYRAMIDS
 
</googlemap>
 
</googlemap>
  
 +
----
  
== Multiple Maps/Tales Examples ==
 
  
 +
=== All Tales in a Table ===
 
{| border="1" style="background:#CFC38E;"
 
{| border="1" style="background:#CFC38E;"
 
!Tale 5 Shard A
 
!Tale 5 Shard A

Revision as of 23:29, 22 September 2010

Google Maps

This wiki runs a modified version of the Google Maps extension for MediaWiki. The <googlemap> tag allows wiki users to create zoom-able, pan-able maps of Egypt with customized markers.

Simply add the following on a wiki page to create a default map:

<googlemap>
</googlemap>

This will generate a map like:


Markers

In the content of the tag, you can define one marker per line. Each line may or may not start with an icon name in parentheses. The line should then have the latitude (x), then a comma, optionally a space, then the longitude (y), then a comma, then a label for the point. The label can include wiki mark-up (and commas).


A list of markers is available on Mayanahs map page. ATITD.org now hosts local copies of most of the icons Mayanah graciously provided. These are used by default if the icons tag is not provided; the icons follow the same naming convention on Mayanahs page. Click here to show all locally hosted markers: http://www.atitd.org/wiki/tale5/images/markers or visit [Rogarian/GoogleMapMarkerTest]] which shows all 1461 locally stored pins (Warning: will be VERY slow!).


Marker Usage Example:

<googlemap zoom="2" height="512" lon="0" controls="small" showposition="yes" showregion="yes" scrollwheel="nothing">
(GH) 700,600,here goes the title
400, 400, here goes the title, it can contain commas but not wiki markup
(S) 100, 100, here goes the title
first line of the caption
Second line of the caption, not that the caption can contain wiki markup like [[Resources]]
<br><br>
</googlemap>



Tabbed Info Balloons

Each tab should have a plain-text title surrounded by inward-leaning slashes (like /this\) followed by a caption that can include wiki mark-up. Tabs will be attached to the previous marker. Example:

<googlemap zoom="2" height="512" lon="0" controls="small" showposition="yes" showregion="yes" scrollwheel="nothing">
(pyramid) 900,100
/Info\
This is where a pharaoh is buried! ;) (Not really)
/Directions\
[http://maps.google.com Click here] to get driving directions
Or just drive in a random direction
</googlemap>

That will create a point whose info balloon has two tabs. Note that you can put as much or as little space as you'd like between the title and the caption to make the syntax more readable.

If a point has a regular caption and tabbed captions, clicking the point will only show the tabbed captions.

Example Map:


Map Customization / Tag Attributes

To customize the map you can set various tags (attributes). Legal attributes are (boldface items are defaults):

Command Desc Options
tale Which Tale to display? Legal values: 1, 2, 3, 4 and 5.
cursor Which mouse cursor to use on the map? Legal values: pointer (hand), default (standard mouse cursor) and crosshair.
width Width of the map in pixels. Defaults to 512 pixels.
height Height of the map in pixels. Defaults to 1024 pixels.
lat The center latitude (x) on the map. Defaults to 1024.
lon The center longitude (y) on the map. Defaults to 0.
zoom Default zoom level. Game Map Legal values: 1 to 8 (2 is default, only the T5 map contains data on levels 7 and 8).
type The type of map to display. Game Maps: game - Shard A, gameb - Shard B

Normal Google Maps: normal (or, equivalently, map) - Normal Google Map, terrain, hybrid, and satellite.

controls Zoom and navigation controls. Legal values: small creates +/- zoom buttons, medium has zoom buttons and pan buttons, large has pan buttons with a sliding scale for zoom, and none has no buttons.
showposition Show x,y coords under the mouse? Legal values: yes and no.
showregion Show the region name under of the mouse? Legal values: yes and no. Requires showpositions=yes; does not work in Tale 1, Tale 2 or Tale 3 maps.
icons URL template for custom markers. Use "{label}" where the name of the icon will be inserted; defaults to "/wiki/tale5/images/markers/marker{label}.png".
icon URL for markers without an icon specified. Defaults to "/wiki/tale5/images/markers/marker.png" marker.png
iconsize Height and width of the icons Defaults to: 32x32
doubleclick What to do when the user double-clicks? Legal values: recenter or zoom.
scrollwheel Define how the scroll wheel behaves. Legal values: nothing or zoom.
zoomstyle How does the map zoom? Legal values: fast and smooth, also known as continuous zooming (only works in some browsers).


Other Commands (Not useful for game maps):

Command Desc Options
stroke Width of paths, in pixels. Does not work in game maps.
scale Show the scale? Legal values are yes and no.
overview Show the inset navigation map? Legal values are yes and no.
selector Show the map/hybrid/satellite selector Legal values are yes and no.


All attributes are optional.

Customized Icons

You can host your own collection of icons on your server, but note that they'll have the same anchor points as ATITD.org's default icon (32x32). Check out Mapki's collection of icon images for a bunch of icons you can use. To use your icons, add an icon attribute to your googlemap-tags like this

<googlemap lat="42.711618" lon="-73.205112" zoom="2" controls="small" 
 icon="http://myserver.com/standardmarker.png" 
 icons="http://myserver.com/markers/marker{label}.png">

Mayanah has some instructions for using an alternate set of icons map here and a set of Mine Specific icons and Quarry Specificon the same page.


Example Maps

Good Default Settings

<googlemap zoom=1 width=256 height=512>
</googlemap>

All of Egypt, Square

<googlemap zoom=1 width=512 height=512>
</googlemap>



A real map of Egypt

<googlemap height="512" lat="29.980624" lon="31.134653" zoom="14" controls="medium" type="hybrid" selector="yes">
29.980624, 31.134653, PYRAMIDS
</googlemap>



All Tales in a Table

Tale 5 Shard A Tale 4 Shard B Tale 4 Shard A

tale=5
type=game
showposition=yes
showregion=yes
cursor=default
tale=4
type=gameb
showposition=yes
showregion=yes
cursor=crosshair
tale=4
type=game
showposition=yes
showregion=yes
cursor=pointer


Tale 3 Tale 2 Tale 1

tale=3
type=game
showposition=yes
tale=2
type=game
showposition=yes
tale=1
type=game
showposition=yes