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
 
(9 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 [[#Step-by-Step 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).  
  
=== Step-by-Step Walkthrough ===
+
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).
# Add a point
 
## Location/Coordinates
 
## Marker pin
 
## Tooltip text
 
# (Add any existing points)
 
# Change center, zoom, and size
 
## (region examples)
 
  
==== Copy/paste the map framework text to your page source. ====
+
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.
To add a Googlemap-style map to your page, start by pasting in the following:
 
<pre><nowiki><googlemap
 
controls="small" showposition="yes" showregion="yes">
 
<!--map locations go here-->
 
  
</googlemap></nowiki></pre>
+
== Legends ==
 +
There are several pre-made map pin legends you can add to your page:
 +
*[[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)
  
To add a Condmap-style map to your page, start by pasting in the following:
+
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>
  
<pre><nowiki>{{CondMap|
+
== Centrally-stored Map Locations ==
<!--central maps go here-->
+
&&&
  
<!--map locations go here-->
+
== How to add/delete/update centrally-stored map locations ==
 +
&&&
  
}}</nowiki></pre>
+
== More details about editing maps ==
 +
=== Marker Pins ===
 +
&&&
  
 +
To see a list of all marker pins on the wiki, go to [http://www.atitd.org/wiki/tale5/images/markers]. &&&
  
==== Add a location to the map. ====
+
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.  
This step is the same whether you're using a Googlemap-style or Condmap-style map.  
 
  
For a map location, you can choose a marker (or use the default), and you can set a text description that will pop up when your mouse hovers over the marker.  
+
=== Tabbed Information Balloons ===
 +
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.  
  
First, find the coordinates in-game by looking at the top center of your screen or at the top of your minimap. Then, to add the location most simply, just type the coordinates on a new line below the "map locations go here" comment:
+
=== Zooming ===
<pre>400, 2250</pre>
+
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.
  
To add the same location with the description 'My home compound (400, 2550)', type the following below the "map locations go here" comment:
+
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.
<pre>400, 2250, My home compound (400, 2250)</pre>
 
  
Now, when you hover your mouse over that location marker on your map, everything after the first two numbers will pop up as a description.  
+
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.  
  
Finally, to add the same location to the map, but this time with both the description and a marker, type the following below the "map locations go here" comment:
+
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).
<pre>(GH) 400, 2250, My home compound (400, 2550)</pre>
 
  
You will end up with one of these two snippets, each of which will show the same location:
+
{| cellpadding="5" border="1"
 +
! Zoom Setting !! Height/Width Conversion
 +
|-
 +
| <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>
 +
|}
  
Googlemap style:
+
=== Other Google Maps Customization ===
<pre><nowiki><googlemap
+
The Google Maps page has a [[Google Maps#Map Customization / Tag Attributes|listing of all customization tags]].
controls="small" showposition="yes" showregion="yes">
 
<!--map locations go here-->
 
(GH) 400, 2250, My home compound (400, 2550)
 
</googlemap></nowiki></pre>
 
 
 
Condmap style:
 
<pre><nowiki>{{CondMap|
 
<!--central maps go here-->
 
 
 
<!--map locations go here-->
 
(GH) 400, 2250, My home compound (400, 2550)
 
}}</nowiki></pre>
 
 
 
==== Choosing markers ====
 
 
 
==== Size, zoom, and shift the map's center. ====
 
If you want your map to show all of Egypt, at a standard size that will fit on a wiki page, there is no need to do anything more. (The default settings will do all of that without you needing to type anything else in.)
 
 
 
 
 
 
 
=== More about marker pins ===
 
 
 
== Niceties ==
 
* Marker pins
 
* Legends
 
 
 
== Existing Data ==
 
 
 
    * 1 What is this here for
 
    * 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!
 
    * 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!
 
    * 7 Current map data
 
          o 7.1 Egypt-wide
 
                + 7.1.1 Automatically Generated
 
          o 7.2 Region-specific
 
                + 7.2.1 Public Works
 
                + 7.2.2 Public Mines
 
                + 7.2.3 Public Smelters
 
                + 7.2.4 Expedition Sites
 
                + 7.2.5 Test of Life - Aqua-ducts
 
    * 8 Map Pin Legends
 
    * 1 Google Maps
 
    * 2 Markers
 
          o 2.1 Some standardized icon suggestions
 
                + 2.1.1 Mines
 
    * 3 Tabbed Info Balloons
 
    * 4 Map Customization / Tag Attributes
 
    * 5 Customized Icons
 
    * 6 Example Maps
 
          o 6.1 Good Default Settings
 
          o 6.2 All of Egypt, Square
 
          o 6.3 A real map of Egypt
 
          o 6.4 All Tales in Table Design
 

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.