Help - Gazetteer

DRAFT

This document is intended as a practical guide to working with the GENUKI Gazetteer.

Gazetteer

The GENUKI Gazetteer covers the whole of England, Ireland, Wales, Scotland, Isle of Man, and the Channel Islands. The gazetteer can be used to find the location of places, view online maps, and discover which GENUKI pages may contain information about that place and the genealogical resources which are available for it.

Gazetteer Node
A gazetteer node contains location and other information such as placename aliases, place codes, etc, largely corresponding to that formerly held in a single row in the county csv files that were formerly used to rebuild the gazetteer database on a daily basis.

To Create a New Gazetteer Node
When logged in, on the Maintenance Menu click "Add Content", then choose "GENUKI Gazetteer". The GENUKI Gazetteer template will open and should then be completed and saved.

To modify an existing Gazetteer Node, open the gazetteer node in question in Edit Mode, make the necessary amendments, then save.

The template comprises a number of fields as below, with appropriate guidance text as below, and other supporting information. Fields marked with a * MUST be completed. A unique URL alias in the appropriate format must be provided, the URL alias should be of the form "gaz/CCC/PlaceName", without the quotes.

Title *
The place name.
 
Place Name Extra
Corresponds to MOREPLACE in the former county csv file, providing additional comments about the location. There are frequently multiple places in a county with the same name, and this field can be used to help distinguish them. E.g. there are at least 5 Broughtons in Lancashire, and we could include here 'near Preston'.

Place Name Alias
Alternative names(s) by which the place is known. Provide alternative name if required. To add further alternative names use the "Add Item" link.

Section
Select country and county from the drop-down lists, e.g. England, Suffolk

Place Code
The gazetteer place code field for the town/parish node associated with this Gazetteer location. This is used to associate places with a location.
Add a unique place code of the form CCCPlacename if none is shown.

Each gazetteer node must have a unique Place Code.  In Drupal, we now link non-prime locations such as a hamlet to the primary parish in which it resides by use of the "Place Unit" field.

Place Unit
Place nodes containing this string. When you have selected an item, the number following it is the node id of that node. So if there are multiple options when setting this field you will need to know the nid (Node ID) of the node you want (the name of the Place Page).

Select or enter a unique place unit:

• Click "Add Item".
• Enter the county name (not the CCC) into County box and click "Filter Place Node".
• Select the appropriate place (parish) name.
• Click "Submit".

Location
For a new gazetteer entry, enter the location using the map.

For a new entry, either enter an OS gridref into the Ordnance Survey gridref box and click "Replace", or enter a lat/lon into the Geometry data box (longitude first) , e.g. POINT (-3.12345 57.67890) and click "Replace".

OS gridrefs are converted to lat/lon for use within Drupal.

The exact location can then be adjusted using the tools within the map. (See below.)

Data
Enter Geometry data in WKT format and click "Replace" to insert new geometries onto the map, e.g. for a pointer insert POINT (-3.12345 57.67890) and click "Replace".

(WKT Format - Well-known text (WKT) is a text markup language for representing vector geometry objects on a map, spatial reference systems of spatial objects and transformations between spatial reference systems.

Coordinates for geometries may be 2D (x, y), 3D (x, y, z), 4D (x, y, z, m) with an m value that is part of a linear referencing system or 2D with an m value (x, y, m). Three-dimensional geometries are designated by a "Z" after the geometry type and geometries with a linear referencing system have an "M" after the geometry type. Empty geometries that contain no coordinates can be specified by using the symbol EMPTY after the type name.) 

Can alternatively be an OS Gridref entered in the Ordnance Survey gridref box, which is later converted to lat/lon for use within Drupal.

Unable to display image - file not migrated. See error log

Gazetteer Precision
Select the precision from the drop-down list.

Location Type
Select the location type from the drop-down list, e.g. Parish.

Parish
Normally only used for Ireland. Enter the name of the civil parish in which the place is located. For Ireland this field is used to link townlands to the relevant parish. If parish boundaries run through a townland, put the others in here as well, using a colon : character as a separator. Do not put in space characters next to the colon. As we do not have any web pages for most of the Irish parishes the normal link via the URL field cannot be made.

Place Name Prime
Tick the radio button if this is a primary location.
A flag indicating whether this is the primary entry for the Town/Parish page in the subsequent URL.

Notes
This field does not get entered into the database, but is a place to hold any notes that the maintainer may need particularly during development of new place entries

Family History Society
Experimental, currently only in use in LAN.
Eventually will hold the code(s) for the FHS(s) covering the Town/Parish (a preliminary former description).

Other CCC
Some parishes and places have county boundaries running through them. This field helps handle these and can hold the county code(s), separated by colon : characters if there is more than one other county.

URL Alias *
Specify a URL by which this content can be accessed. Don't add a trailing slash or the URL alias won't work.
The URL alias should be of the form "gaz/CCC/PlaceName", without the quotes. No leading or trailing slashes.

Published
If a new entry, tick the radio button to publish the node and make it visible to users.
Leave all other options un-ticked.

Click "Save" when complete.

For further background information see Gazetteer Development.