Ancestral Sources Tutorial ~ Working With Templates ~ (1) Keywords and Functions

Introduction

Ancestral Sources allows many of its features to be customised with templates that change the way data is presented in a convenient and consistent manner.

Remember to use Help to obtain extra advice, and hover the mouse over buttons and boxes to obtain a brief Tooltip.

Concepts

Most of the templates use Keywords, such as {DATE} and {ADDR}, that represent current values entered while capturing the event data. For example, {DATE} represents the Date of the event, while {ADDR} represents the Address where the event took place. This is very similar to the way Family Historian defines a Fact Sentence using Template Codes.

Some templates support Functions that allow values to be managed. For example, =UPPER[{ADDR}] coverts the Address to uppercase, and =IF[{ADDR}|{ADDR}|<Not Recorded>] yields the Address if it exists, otherwise <Not Recorded>. These are similar to Functions in Family Historian and are intended for advanced users.

Other templates use a variety of options and parameters to define their behaviour and are intended for advanced users. See Associated Individual Types and Census Grid Templates for details.

Keywords

If you are comfortable with the concept of Keywords then please skip this tutorial.

Keywords Tutorial

  • Open Ancestral Sources and ensure the Family Historian Sample Project or the Sample.ged file opens by default, but if not then Configure Initial Settings
  • Ensure that the Census Records mode is active by clicking the Create census entries button near the middle of the toolbar, or by choosing View > Census Editor
  • Use the menubar option Tools > Autotext Template Editor… and in the Title: box enter Tutorial
  • Click the < Keyword button and choose {SOURCETYPE} from the bottom of the list
  • Type in a space then in and another space, then use < Keyword and choose {COUNTRY}
  • Now the template should look like {SOURCETYPE} in {COUNTRY}
  • Note that the Preview shows Census in UK
  • Click the Save button and then the Close button
  • From the Census Country: dropdown list choose Canada
  • Use the menubar option Tools > Autotext Template Editor… again
  • From the Template: dropdown list choose Tutorial that was saved above
  • Note that the Preview now automatically shows Census in Canada instead of UK
  • Click the Delete button, click OK to the warning, and click the Close button
  • Close Ancestral Sources

Keywords Reference

This table lists every Keyword, an Example representation, and an Explanation of its value. A different subset of these Keywords is available in each type of template as explained below.

Keyword Example Explanation
{YEAR} 1891 Year that the event took place
{COUNTRY} UK Census country (Census only)
{DATE} 3 September 1800 Date that the event being recorded took place
{DATE.DAY} 3 Day of the date
{DATE.DAY2} 03 Day of the date as 2 digits
{DATE.MONTH.NUM} 9 Month of the date in numeric format
{DATE.MONTH.NUM2} 09 Month of the date in numeric format as 2 digits
{DATE.MONTH.SHORT} Sep Month of the date in short format
{DATE.MONTH.SHORT.CAPS} SEP Month of the date in short format and capitals
{DATE.MONTH.FULL} September Month of the date in full format
{DATE.MONTH.FULL.CAPS} SEPTEMBER Month of the date in full format and capitals
{PLACE} Warrington, Lancashire, UK Place where the event took place
{PLACE.SHORT} Warrington First part of the place up to the first comma
{ADDR} The Rectory, Main Street Address where the event took place
{ADDR.SHORT} The Rectory First part of the address up to the first comma
{OTHER} Anything The data entered into the Other Info field
{REF} HO107 1234 56 78 The data entered into the Ref ID field
{KEYPERSON} Alan Jones Name of key person i.e. Head in Census, person being baptised, groom, etc.
{KEYPERSON…} See Keywords Sub-tags below
{SPOUSE} Alice Jane Smith Name of person marrying {KEYPERSON} (Marriage only)
{SPOUSE…} See Keywords Sub-tags below
{KEYFATHER} John Jones Name of father of {KEYPERSON} (non-Census Auto Text Templates only)
{KEYFATHER…} See Keywords Sub-tags below
{KEYMOTHER} Janet Jones Name of mother of {KEYPERSON} (non-Census Auto Text Templates only)
{KEYMOTHER…} See Keywords Sub-tags below
{SPOUSEFATHER} John Smith Name of father of {SPOUSE} (Marriage Auto Text Templates only)
{SPOUSEFATHER…} See Keywords Sub-tags below
{SPOUSEMOTHER} Janet Smith Name of mother of {SPOUSE} (Marriage Auto Text Templates only)
{SPOUSEMOTHER…} See Keywords Sub-tags below
{ASSOCPERSON} Jack Jones Name of associated person (Associated Individual Types Templates only)
{ASSOCPERSON…} See Keywords Sub-tags below
{ASSOCLIST.COMMA} Jack Jones, Tom Buck List of associated people separated by commas
{ASSOCLIST.COMMA.AND} Jack Jones and Tom Buck List of associated people separated by commas but with and before last one
{ASSOCLIST.COMMACR Jack Jones,
Tom Buck
List of associated people separated by commas and carriage returns
{MINISTER} Rev Ian James Name of minister entered in parish records (e.g. priest or vicar)
{SOURCETYPE} Census Either Census or Baptism or Christening or Marriage
{MARRIAGETYPE} By Banns Either After Banns or By Banns or By Certificate or By Licence (Marriage only)
{CENSUSGRID} Columns of text from census grid (Census Auto Text Templates only)
{SYSTEM.VERSION} 3.0.0 Current version of Ancestral Sources
{SYSTEM.DATE} 12 Mar 2012 Today’s date
{SYSTEM.TRANSCRIBER} Mike Name of Transcriber from Options ~ General Settings