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
 
(11 intermediate revisions by the same user not shown)
Line 1: Line 1:
''editing in progress''
+
''editing in progress (&&& marks missing info)''
  
 +
== Map features ==
 +
*region/coord info box &&&
 +
*move/zoom &&&
 +
*hover over 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, 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.
  
''First question: put only your own points on, put only existing points on, or mix and match.''
+
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.  
  
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.  
+
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).  
  
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 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).  
  
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]]).  
+
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.
  
=== Step-by-Step Walkthrough ===
+
== Legends ==
==== Copy/paste the map framework text to your page source. ====
+
There are several pre-made map pin legends you can add to your page:
:To add a Googlemap-style map to your page, start by pasting in the following:
+
*[[Maps/Public Mines/Legend]] (pins for all types of metal and gem mines)
<pre><nowiki><googlemap controls="small" showposition="yes" showregion="yes" scrollwheel="nothing">
+
*[[Maps/Resources/Legend]] (pins for tar, limestone, red sand, white sand, sulphurous water)
<!--map locations go here-->
 
  
</googlemap></nowiki></pre>
+
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>
  
:To add a Condmap-style map to your page, start by pasting in the following:
+
== Centrally-stored Map Locations ==
 +
&&&
  
<pre><nowiki>{{CondMap|
+
== How to add/delete/update centrally-stored map locations ==
<!--map locations go here-->
+
&&&
  
}}</nowiki></pre>
+
== More details about editing maps ==
 +
=== Marker Pins ===
 +
&&&
  
==== Add a location to the map. ====
+
To see a list of all marker pins on the wiki, go to [http://www.atitd.org/wiki/tale5/images/markers]. &&&
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.  
+
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.  
  
To add the location most simply, just type the coordinates on a new line below the "map locations go here" comment:
+
=== Tabbed Information Balloons ===
<pre>400, 2250</pre>
+
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.
  
To add the same location with the description 'My home compound (400, 2550)', type the following below the "map locations go here" comment:
+
=== Zooming ===
<pre>400, 2250, My home compound (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.
  
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.  
+
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.  
  
<googlemap controls="small" showposition="yes" showregion="yes" scrollwheel="nothing">
+
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.
<!--map locations go here-->
 
(GH) 400, 2250, My home compound (400, 2550)
 
</googlemap>
 
  
{{CondMap|
+
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).
<!--map locations go here-->
 
(GH) 400, 2250, My home compound (400, 2550)
 
}}
 
  
==== Decide where the map should be centered, how far it should be zoomed, and what size it should be. ====
+
{| cellpadding="5" border="1"
# Add a point
+
! Zoom Setting !! Height/Width Conversion
## Location/Coordinates
+
|-
## Marker pin
+
| <tt>zoom=1</tt> || <tt>height/width= coordinates / 32</tt>
## Tooltip text
+
|-
# (Add any existing points)
+
| <tt>zoom=2</tt> || <tt>height/width= coordinates / 16</tt>
# Change center, zoom, and size
+
|-
## (region examples)
+
| <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>
 +
|}
  
== Niceties ==
+
=== Other Google Maps Customization ===
* Marker pins
+
The Google Maps page has a [[Google Maps#Map Customization / Tag Attributes|listing of all customization tags]].
* 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.