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 "User:Talibeh/Scratchpad2"

From ATITD5
Jump to navigationJump to search
(moving walkthrough)
 
(8 intermediate revisions by the same user not shown)
Line 1: Line 1:
''editing in progress''
+
''editing in progress (&&& marks missing info)''
  
 
== Map features ==
 
== Map features ==
*region/coord info box
+
*region/coord info box &&&
*move/zoom
+
*move/zoom &&&
*hover over pins
+
*hover over pins &&&
*click on pins
+
*click on pins &&&
  
== Putting a map on your page ==
+
== How to put a map on your page ==
The ATITD wiki gives you two options for generating maps on wiki pages. The [[Google Maps]] extension will create a map from location data you enter manually on your page. The [[Condmaps]] framework (built on top of [[Google Maps]]) will create a combined map from two types of data: location data that you enter manually on your page, and centrally-stored locations that are used in maps all over the wiki.  
+
The ATITD wiki gives you two options for generating maps on wiki pages. The [[Google Maps]] extension will create a map from location data you enter manually on your page. The [[Condmaps]] framework (built on top of [[Google Maps]]) will create a combined map from two types of data: location data that you enter manually on your page, as well as centrally-stored locations that are used in maps all over the wiki. Both styles of maps look and act exactly the same once added to your page.  
  
So when adding a map to your wiki page, your first question is whether it will contain only personal locations (home compound, guild hall, etc.), or whether it might also contain general locations such as chariot stop locations, public mines, and resource locations.  
+
So, when adding a map to your wiki page, your first question is whether it will contain only personal locations (home compound, guild hall, etc.), or whether it might also contain general locations such as chariot stop locations, public mines, and resource locations.  
  
If you might want your map to contain general information like that, use the Condmap framework map (see the [[#Step-by-Step Walkthrough|walkthrough]] below). If your map will only ever contain personal locations, you can use the Googlemap extension instead (also see the [[/Add Map Walkthrough|walkthrough]]).  
+
If you might want your map to contain centralized information used elsewhere on the wiki, use a Condmap-style map (see the [[/Add Condmap Walkthrough|walkthrough]] for adding a Condmap to your page).  
  
This walkthrough covers only the most basic and commonly used settings for sizing the map, displaying a location, and choosing a marker. See [[#below|below]] if you want more information on each of these features.  
+
If your map will only ever contain personal locations, you can use a Googlemap-style map instead (see the [[/Add Google Map Walkthrough|walkthrough]] for adding a Google map to your page).  
  
=== More about marker pins ===
+
These walkthroughs cover only the most basic and commonly used settings for sizing the map, displaying a location, and choosing a marker. See [[#More details about editing maps|below]] if you want more information on each of these features.
  
== Niceties ==
+
== Legends ==
* Marker pins
+
There are several pre-made map pin legends you can add to your page:
* Legends
+
*[[Maps/Public Mines/Legend]] (pins for all types of metal and gem mines)
 +
*[[Maps/Resources/Legend]] (pins for tar, limestone, red sand, white sand, sulphurous water)
  
== Existing Data ==
+
To include a legend on your page, add one of the following lines just below the map.
 +
<pre><nowiki>{{:Maps/Public Mines/Legend}}
 +
{{:Maps/Resources/Legend}}</nowiki></pre>
  
    * 1 What is this here for
+
== Centrally-stored Map Locations ==
    * 2 I want to use one or more of these maps on another page
+
&&&
          o 2.1 Zoom examples for different regions
+
 
    * 3 I want to add a new datapoint, Help Me!
+
== How to add/delete/update centrally-stored map locations ==
    * 4 I want to start a new data page
+
&&&
    * 5 What types of thing should be placed in this type of map
+
 
    * 6 Who inflicted this monstrosity on egypt!
+
== More details about editing maps ==
    * 7 Current map data
+
=== Marker Pins ===
          o 7.1 Egypt-wide
+
&&&
                + 7.1.1 Automatically Generated
+
 
          o 7.2 Region-specific
+
To see a list of all marker pins on the wiki, go to [http://www.atitd.org/wiki/tale5/images/markers]. &&&
                + 7.2.1 Public Works
+
 
                + 7.2.2 Public Mines
+
With Google-style maps, you can use marker pins that are hosted somewhere other than this wiki, allowing you to create your own custom icons. See the [[Google Maps#Markers|customized icons]] section on the Google maps page for more information.
                + 7.2.3 Public Smelters
+
 
                + 7.2.4 Expedition Sites
+
=== Tabbed Information Balloons ===
                + 7.2.5 Test of Life - Aqua-ducts
+
Maps can display tabbed information boxes when you click on a marker. The Google Maps page explains the [[Google Maps#Tabbed Info Balloons|details]] of how to add that information.
    * 8 Map Pin Legends
+
 
    * 1 Google Maps
+
=== Zooming ===
    * 2 Markers
+
If you want your map to have specific coordinate boundaries (such as a map of a particular region), it's helpful to understand how the map's zoom setting interacts with the width and height settings.
          o 2.1 Some standardized icon suggestions
+
 
                + 2.1.1 Mines
+
When zoom=6, each map pixel is one in-game coordinate. So if you want your top map boundary to be at 100, and your bottom map boundary to be at -100, set the map's height=200.
    * 3 Tabbed Info Balloons
+
 
    * 4 Map Customization / Tag Attributes
+
From there, each change in zoom setting doubles how many in-game coordinates are shown with each map pixel. So at zoom=5, a 200-pixel-high map will show 400 coordinates from top to bottom. At zoom=4, a 200-pixel-high map will show 800 coordinates from top to bottom.  
    * 5 Customized Icons
+
 
    * 6 Example Maps
+
If you want your map to show a certain number of coordinates from left to right or top to bottom, use this table to find the map's height/width at various zoom settings. For example, if your region is 800 coordinates wide and your zoom setting is 3, then the map width should be set to 100 (800 divided by 8).
          o 6.1 Good Default Settings
+
 
          o 6.2 All of Egypt, Square
+
{| cellpadding="5" border="1"
          o 6.3 A real map of Egypt
+
! Zoom Setting !! Height/Width Conversion
          o 6.4 All Tales in Table Design
+
|-
 +
| <tt>zoom=1</tt> || <tt>height/width= coordinates / 32</tt>
 +
|-
 +
| <tt>zoom=2</tt> || <tt>height/width= coordinates / 16</tt>
 +
|-
 +
| <tt>zoom=3</tt> || <tt>height/width= coordinates / 8</tt>
 +
|-
 +
| <tt>zoom=4</tt> || <tt>height/width= coordinates / 4</tt>
 +
|-
 +
| <tt>zoom=5</tt> || <tt>height/width= coordinates / 2</tt>
 +
|-
 +
| <tt>zoom=6</tt> || <tt>height/width= coordinates / 1</tt>
 +
|}
 +
 
 +
=== Other Google Maps Customization ===
 +
The Google Maps page has a [[Google Maps#Map Customization / Tag Attributes|listing of all customization tags]].

Latest revision as of 19:56, 10 November 2010

editing in progress (&&& marks missing info)

Map features

  • region/coord info box &&&
  • move/zoom &&&
  • hover over pins &&&
  • click on pins &&&

How to put a map on your page

The ATITD wiki gives you two options for generating maps on wiki pages. The Google Maps extension will create a map from location data you enter manually on your page. The Condmaps framework (built on top of Google Maps) will create a combined map from two types of data: location data that you enter manually on your page, as well as centrally-stored locations that are used in maps all over the wiki. Both styles of maps look and act exactly the same once added to your page.

So, when adding a map to your wiki page, your first question is whether it will contain only personal locations (home compound, guild hall, etc.), or whether it might also contain general locations such as chariot stop locations, public mines, and resource locations.

If you might want your map to contain centralized information used elsewhere on the wiki, use a Condmap-style map (see the walkthrough for adding a Condmap to your page).

If your map will only ever contain personal locations, you can use a Googlemap-style map instead (see the walkthrough for adding a Google map to your page).

These walkthroughs cover only the most basic and commonly used settings for sizing the map, displaying a location, and choosing a marker. See below if you want more information on each of these features.

Legends

There are several pre-made map pin legends you can add to your page:

To include a legend on your page, add one of the following lines just below the map.

{{:Maps/Public Mines/Legend}}
{{:Maps/Resources/Legend}}

Centrally-stored Map Locations

&&&

How to add/delete/update centrally-stored map locations

&&&

More details about editing maps

Marker Pins

&&&

To see a list of all marker pins on the wiki, go to [1]. &&&

With Google-style maps, you can use marker pins that are hosted somewhere other than this wiki, allowing you to create your own custom icons. See the customized icons section on the Google maps page for more information.

Tabbed Information Balloons

Maps can display tabbed information boxes when you click on a marker. The Google Maps page explains the details of how to add that information.

Zooming

If you want your map to have specific coordinate boundaries (such as a map of a particular region), it's helpful to understand how the map's zoom setting interacts with the width and height settings.

When zoom=6, each map pixel is one in-game coordinate. So if you want your top map boundary to be at 100, and your bottom map boundary to be at -100, set the map's height=200.

From there, each change in zoom setting doubles how many in-game coordinates are shown with each map pixel. So at zoom=5, a 200-pixel-high map will show 400 coordinates from top to bottom. At zoom=4, a 200-pixel-high map will show 800 coordinates from top to bottom.

If you want your map to show a certain number of coordinates from left to right or top to bottom, use this table to find the map's height/width at various zoom settings. For example, if your region is 800 coordinates wide and your zoom setting is 3, then the map width should be set to 100 (800 divided by 8).

Zoom Setting Height/Width Conversion
zoom=1 height/width= coordinates / 32
zoom=2 height/width= coordinates / 16
zoom=3 height/width= coordinates / 8
zoom=4 height/width= coordinates / 4
zoom=5 height/width= coordinates / 2
zoom=6 height/width= coordinates / 1

Other Google Maps Customization

The Google Maps page has a listing of all customization tags.