User:Traveler100/map-listings-explained

All - please feel free to refine and expand this. Trying to understand what has happened with the new maps' POI markers. We need to create a user friendly help.

User guide

Documentation of attractions in articles are done using listings templates, these can be specific templates {{see}}, {{do}}, {{buy}}, {{eat}} {{drink}}, {{sleep}} or the general {{listing}}. If latitude and longitude values are set in the lat long parameters a number icon is places at the start of the entry on the article page. A corresponding numbered icon will then be displayed in the maps related to the page.

Currently the map top left of page, controlled by the {{geo}} template has different functionality to the embedded page maps controlled by {{mapframe}} template.

The listing template can also define the icon that is displayed using the type parameter. Valid values are city, go, other, view, vicinity, around. Also can specify the colors gold, lime, red, silver.

Destination articles

Simply use the see , do , buy, eat, drink and sleep templates, the color and numbering are taken care of.

Itineraries

Add parameter counter= with no value to all listings ( and see, do ..) so that numbers are sequential irrespective of type of listing.

Examples see Wales Coast Path and Rheinburgenweg.

Travel topics

Add parameter counter= with a lower case letter, to all listings (and see, do ..). Different letter for each sequence of numbers.

Example Roman Empire (England and France).

in line locations

{{marker}} template can be used within a sentence to show location of a poi or transportation hub.

Example Trier#By train

Simple technical explanation

What calls what

{{see}}, {{do}} etc ...., uses {{listing}}, which uses {{marker}}

Used in {{mapframe}} which invokes Module:Map, supported by mw:Extension:Kartographer (mw:Help:Extension:Kartographer).

markers on maps

number and symbol - how controlled by counter and type?

• shape of poi icons on geo map defined by type.
• shape of poi icons on mapframe map currently not possible.
• can user control shape?
• Numbers will by default increment from 1 separately for each type.
  • counter is set by default to the template type used, for example counter=see, when {{see}} template is used
  • type is also set to selected listing template, eg. see, do, ... or blank if listing used without type option.
  • In Marker
    • marker-symbol is set to counter if exists if not to type
    • marker-color is set by type using Module:TypeToColor
    • group is set to type
• If use parameter counter can control groups of number
  • appears only to take lowercase letters.
  • have not found out how to control map display of counter groups