Help:Extensions

From CharlestonWiki

An extension is an addition to the base wiki system. This page describes how to use them.

Gmaps

You can add google maps to articles (see Kudu for an example). This is a brief "how to".

First, add the following text to the article and hit the Show preview button.

<gmap lat="32.797953" long="-79.939270" zoom="6" helper="on"> 

</gmap>

This will add a basic map of Charleston to your page. Beneath it is a text box. When you click in the text box, you are given the current lat/lon of the center of the map, as well as the current zoom level. Move the map around and adjust the zoom level until the object(s) of importance are in the view. Then click in the text box to get the current lat/lon/zoom. Copy the text in the box, and replace the values in the original <gmap> tag. Then press the Show preview button. The map should be zoomed in to the correct area. Next, you'll want to add a pin. Now that you know the lat/lon values for the pin (the pin's location and the location you have centered on should be the same), you can modify your <gmap> tag so it looks like the following:

<gmap lat="32.783640" long="-79.937253" zoom="0" helper="on">
points:
32.783640|-79.937253|This is the text that goes in the info bubble
</gmap>

The format is a line containing just the word points: followed by a line/lines containing latitude|longitude|text description for each point you wish to add to the map. Go ahead and preview it, then remove the helper="on" text in the <gmap> tag if everything seems to be working. Then save the page.

Point syntax

points:
lat|long|wiki text for the first point
lat|long|wiki text for the second point
...

A set of points commences with a single line containing only the command points:. Next are lines (one for each point) with latitude and longitude in degrees and a piece of wikitext (may contain images etc.). The wiki text will become visible in a bubble above the point, it it is clicked on.

Line syntax

lines:
color|width|opacity|lat1|long1|lat2|long2|lat3|long3|....
color|width|opacity|lat1|long1|lat2|long2|lat3|long3|....
...

A set of lines commences with a single line containing only the command lines:. Next are lines (one for each line), color being the color of the line (6 character hex, i.e. ffaa77), width an integer setting the width of the line, and opacity a float from 0 (fully transparent) to 1 (completely visible), then an arbitrary number of latitude longitude pairs.

See http://www.schwen.de/wiki/GMap for the full documentation.