قالب:جيوبوكس/مفتاح المتغيرات
- Copy the appropriate blank template into the edited page and fill in the fields. Do not re-use a template from another page.
- Do not erase empty fields, other editors might supply the missing data. The empty fields are not displayed and don't hinder anything.
- Do not put multiple items into a single field, use indexed fields. Not: city = Valencia, Alicante, Murcía but city = Valencia | city1 = Alicante | city2 = Murcía
- It isn't necessary to put [[ and ]] markup around anything that links to an existing article, the template does it for you. All cities in the example above will be linked to the appropriate articles.
- Before raising any question read the documentation first. Though not perfect it contains valuable information.
Field behavior
There exist base fields whose output can be modified or extended by adding additional fields, these always bear the name of the base field plus the name of the additional field starting with an underscore ("_"). The additional fields are not present in the blank templates as they can be added to virtually any Geobox. Following additional fields are defined for all base fields:
- _type - for redefining the default field name, e.g. the default field name for the region field is Region, adding region_type it can be changed to display Province, Department …. N.B.: keep the text short, it is always displayed on one line, if it is too long, the left column of the geobox gets too wide.
- _note - any sort of note which is printed after the field value, it can be even a reference, though the author of Geoboxes discourages from doing so as the implementation of <ref></ref> tags is very poor. The note is printed in a bit different font, currently implemented as italics.
- _label : puts the HTML title property on the item (the text displays on hover), it's useful for hints, it can be a longer text then the _type field.
The fields that link to existing articles don't need to be put between [[ and ]] markup, this is added automatically if the page exists. However, the markup can be used when the text of the link is different form the link itslef, e.g. [[Amazon|Solimões]].
Multiple fields
- Some fields might contain multiple values, these are not to be put in a single field and separated by commas but using numbered additional fields (e.g. for the country field there also exist country1, country2, country3 …. The additional "indexed" fields are usually not present in the blank templates. Usually up to 16 such fields can be used.
- When there are two many indexed fields, adding appropriate _fold = 1 parameter causes the values to be "folded" upon page load, with the "show/button" enabling the values to be shown/hidden.
- For countries a and states adding appropriate _flag = 1 parameter prints a small flag in front of every country/state in the list.
Units
All figures can be in either metric (default) or imperial (miles, feet etc) units; the Geoboxes display both, automatically calculating imperial figures from metric or metric from imperial ones. Unformated numbers (i.e. without commas) must be entered, otherwise the auto-conversion produces an error. The output is "nicely" formatted. Following additional fields can be used:
- _imperial - for input in imperial/customary units
- _round - for changing the rounding precision of auto-conversion, it's the position from the decimal point to which the figure is rounded, negative values can be used when the input figure is rounded/approximate, default value is 0
- _unit - for changing the default unit, appropriate unit abbreviation should be used; the default unit for e.g. area is usually square kilometre (or square mile respectively), this can be changed to ha for hectare, acre for acre etc.
The last two additional fields are defined for every field using any units, if there is a set of similar fields, e.g. for area (area, area_land, area_water etc., the _round and _unit fields of the basic one are applied on all of them if they aren't specifically set)
Coordinates
Coordinates can be entered in two ways:
- using separate _d, _m, _s…fields, _s and _m can be dropped out, the coordinate display template is adjusted accordingly
- using just _d field and a decimal number, the hemispehere can be defined by either _NS, _EW fields or by using negative figures for western and southern hemisphere (these two systems mustn't be combined)
For every location type which can be described in coordinates, there exist two additional fields
- _type (named coordinates_type for the main location), which can contain any paramteres that are passed to the mapping service, especially the scale of the map, the possible parameters are described here: Wikipedia:WikiProject_Geographical_coordinates#Parameters.
- _format (named coordinates_format for the main location) to override how the coordinates are diplayed, if the input is decimal the output is decimal too, if the input is DMS so is the output, the possible values are self-explanatory dms and dec
Both _type and _format fields can be defined for every location with coordinates separately or by the general coordinates_type and coordinates_format fields.
If coordinates_no_title is assigned any value (typically just 1) it switches off generation of the coordinates in the title of the page, this is useful when another template on the page displays the coordinates in title too and it cannot be offed.
Please be sensible when setting the coordinates, tenths or hundreths of seconds mean unnecessary centimeter precicision.
Maps
The map field should be used for a location map of the feature, i.e. where it is located within a country. The location map can be of three types:
- Self-contained location map. As in e.g. Greater Fatra.
- Semi-automated locator dot. The map field contains background map, whereas locator_x and locator_y contain relative coordinates of the locator dot (as a percent of the map width, inserted without the % symbol), this system can be used when the map is not (or cannnot be) calibrated for the automated locator dot.
- Fully automated locator dot. If coordinates of the location are defined in the Geobox and a calibrated map exists the locator dot is placed automatically based on the coordinates (map_locator field defines the appropriate map calibration). As in e.g. Ostrá. The same locator calibration can be used for all maps derived form one base map, e.g. Lysá hora and Plasy share the same calibration though the background map is different. The existing calibrations are listed here: Geobox locator.
See also Template talk:Geobox2 map for further info on maps.
Geobox layout
- geobox_width - width of the Geobox in pixels (without px, just the figure), it can be used when there are more Geoboxes or images stacked below each other and the same width is desirable; not in blank templates.
Fields
| field | explanation |
|---|---|
| Heading | |
| name | short name (without City of … etc., use official_name) |
| native_name | native name if different from the English one, it is printed in brackets on the same line as name |
| other_name, other_name1 … | other names |
| category | type of location, can be a type of protected area, settlement type etc., if left blank the pfirst parameter with which the Geobox is called is used (i.e. River, Valley, Settlement etc.) |
| native_category | native category if different from the English one, it is printed in brackets on the same line as category |
| Image | |
| image | a photograph |
| image_size | photograph size in pixels (set to 256 if left blank) |
| image_caption | photograph caption |
| Names | |
| official_name | official name (long form) |
| etymology | etymology (origin) of the name, do not enter lengthy prose, examples:
|
| motto | location motto (usually for cities) |
| nickname, nickname1 … | location nickname(s) |
| Symbols | |
| flag | official flag or banner |
| flag_size | flag size in pixels (set to 120 if left blank), without px |
| flag_border | if set it places a border around the flag, useful when the flag image itself has no border and it is in light colors (see Poděbrady) |
| symbol | official seal, shield, coat-of arms etc. |
| symbol_size | flag size in pixels (set to 120 if left blank), without px |
| symbol_border | if set it places a border around the symbol, useful when the flag image itself has no border and it is in light colors |
| Country | |
| Enter either just the appropriate administrative division name if the article on it has the same name (example: state = Illionois, NB you don't need to eneter the wiki mark-up [[ and ]]) or, usually when the article and the administrative unit name contains its type (XXX County, District XXX, XXX Municipality), use piped wikilink in the format (example: district = [[Martin District|Martin]]'') to prevent double display of the administrative unit title. | |
| country, country1 … | country/countries in which the location lies |
| state, state1 … | state(s), in which the location lies |
| region, region1 … | region(s) in which the location lies |
| district, district1 … | district(s) which the location lies |
| municipality, municipality1 … | municiplity/municipalities in which the location lies |
| Family - various features that lie within the area | |
| parent, parent1… | e.g. parent valley, higher orographic units |
| range | range in which the location lies |
| border, border1… | bordering ranges, regions |
| part | parts into which the location can be divided, can be a list of municipalities, lower orographic units etc., up to 42 parts can be defined |
| tributary_left, tributary_left1…, tributary_right, tributary_right1…, | major tributaries, listed as the river flows downstream (e.g., right tributary enters on the right-descending river bank) |
| child_left, child_left1…, child_right, child_right1…, | major children, e.g. side valleys |
| city, city1… | important settlements in the area |
| landmark, landmark1… | important landmarks in the area |
| river, river1… | important rivers in the area |
| building, building1… | important rivers in the area |
| Locations | |
| location | location name (e.g. name of main square in a city) |
| elevation | location elevation in metres (feet) |
| prominence | location prominence in metres (feet) |
| lat_d … | location coordinates (lat_d, lat_m, lat_s, lat_NS, long_d, long_m, long_s, long_EW), these coordinates are used for automeated locator dot placement |
| highest, highest_… | highest point of the area, highest field should contain the name, highest_location, highest_elevation, highest_lat_d … are defined too, also highest_region, highest_country, highest_country1 for defining more precisely where the location lies (e.g. for highest point of a range, highest_region field can be used for a part of the range, not necessarily administrative region) |
| lowest, lowest_… | lowest point of the area, same additional fields as for highest |
| River locations | |
| source, source1 | main and secondary source, same additional fields as for highest |
| source_confluence | source_confluence, same additional fields as for highest |
| mouth | mouth (estuary), same additional fields as for highest, use the main field for the river or sea into which it empties |
| Dimensions | |
| length, length_orientation | length in kilometers (miles) or metres (feet) for buildings |
| width, width_orientation | length in kilometers (miles) or metres (feet) for buildings |
| height | height in metres (feet) |
| depth | depth in metres (feet) |
| volume | volume in cubis metres (feet) |
| watershed | watershed (discharge basin) area in square kilometers (miles) |
| area, area_land, area_water, area_urban, area_metro, area1… | appropriate area in km² (mi²) or m² (ft²) for buildings, area_share, area_land_share etc. might be used to set a percentual share of the area in the total area, these can be assigned the auto value to have the value calculated automatically (it will always be calculated as given are figure divided by total area), area_share_round etc. might be used to set rounding precision |
| discharge_location | location where the following figures come from, typically mouth |
| discharge | average discharge in m³/s (ft³/s) |
| discharge_max | maximal discharge in m³/s (ft³/s), use discharge_max_note to indicate what the figure signifies (day of max discharge, season) |
| discharge_min | minimal discharge in m³/s (ft³/s), use discharge_min_note to indicate what the figure signifies (day of min discharge, season) |
| discharge1_location … | additional location where average discharge is provided |
| discharge1 … | additional location average discharge in m³/s (ft³/s) |
| Population | |
| population, population_urban, population_metro, population1… | appropriate population figure |
| population_date, population_urban_date, population_metro_date, population1_date, population1_date… | year or date to which population figures relate |
| population_density, population_density_urban, population_density_metro | appropriate population density figure in /km² (/mi²), if value auto is assigned the density is calculated from appopriate area and population figures |
| Features | |
| geology, geology1… | geological composition (rocks) |
| orogeny, orogeny1… | orogenic process(es) by which the area was created |
| period, period1… | geologic periods in which the area was created |
| biome, biome1… | major biomes/ecosystems in the area |
| plant, plant1… | major plants growing in the area |
| animal, animal1… | major animals living in the area |
| author, author1… | author/designer/creater of a man-made object |
| style, style1… | building styles (e.g. Gothic) |
| material, style1… | material from of which the object (monument, statue) is made (e.g. granite) |
| History & management | |
| established, etablished1… | establishment/foundation date, numbered fields can contain year of status upgrade, incorporation, enlargement etc. The earliest should use {{Start date}}. |
| date, date1… | other dates which do not fit in established |
| government, government_… | governing body, same additional fields as for highest |
| management, management_… | managing body, same additional fields as for highest |
| owner | owner of the site |
| mayor | mayor of the settlement, mayor_party might be added |
| leader, leader1 … | leaders of the region, settlement (then the first field automaticaly displays Mayor), _aprty might be added |
| Access | |
| public | is the site accessible for public, some text |
| visitation, visitation_date | visitation for given year |
| access | easiest access way |
| ascent, ascent1…, ascent_date | first ascent by and year |
| discovery, discovery1…, discovery_dete | discovered by and year |
| Codes | |
| timezone, utc_offset | timezone name and its UTC offset |
| timezone_DST, utc_offset_DST | summer/daylight saving timezone name and its UTC offset |
| iso_code, iso_subcode | Links to appropriate ISO 3166-2 article. Both parameters must be given. |
| postal_code, area_code, code, code1 | Various identification codes |
| UNESCO World Heritage, IUCN, and Topographic Mapping | |
| whs_name, whs_year, whs_number, whs_region, whs_criteria | World Heritage Site Classification, values are automaticaly linked to appropriate pages at UNESCO, session number is automatically generated from the year, region can be number from 1 to 5 and it is automatically expanded |
| category_iucn | IUCN category number (Roman), it is automatically expanded into type |
| topo_map, topo_maker | Information on topographic maps displaying the feature. topo_map is generally the topo quad name (e.g., Sinks of Gandy). topo_maker is the agency that produced the map in abbreviation form (e.g., USGS for U.S. Geological Survey) and is auto-wikilinking. |
| Free fields | |
| free, free_type, free1, freee1_type… | free fields for any purpose (it currently supports up to 8 fields). The entry opposite free= is the result of the entry. The entry free_type= is the type. See Shinnecock Canal for an example. |
| Map section | |
| map, map1, map2 | map showing river, its basin, tributaries etc. |
| map_size… | map size in pixels (set to 256 if left blank) |
| map_background… | background map for SVG overlays |
| map_caption… | map caption |
| map_locator… | calibrated map from Geobox locator |
| map_locator_x, map_locator_y | relative location dot position in percent of the map width, without the "%" symbol |
| Websites | |
| commons | Wikimedia Commons category with more images |
| statistics | statistical site link |
| website | official or major website |
| Footnotes | |
| footnotes | any unformated footnotes |
Geobox 1.0 > Geobox 2.0 conversion
There's now a testing version of a semi-automated tool that can convert a page with Geobox 1.0 template to a page with Geobox 2.0. The tool is located at
http://wikipedia.paloch.net/Geobox.php?page=.
You must add the full address to the page to convert at the end of the previous link, e.g.
http://wikipedia.paloch.net/Geobox.php?page=http://en.wikipedia.org/wiki/Ostrava.
It changes the template call and rearranges the fields in the Geobox 2 style (and it also renames several fields, although the old field names are accepted too). The page you get displayed is the full wiki text of the article with the converted Geobox. Just copy it all end paste it over all the text in the edit field of the page.
For Opera Browser users there's a button here: link. Is it possible to create a bookmark in Firefox, that could contain some variables (such as "%u" in an Opera bookmark will add the actual page address to it)? – Caroig (talk) 22:02, 10 September 2007 (UTC)