Configuration

greatgramps is configured using a YAML file.

Create a config.yml pointing at your GRAMPS database and listing the GRAMPS IDs of the root people you want to browse the tree as:

db_path: /path/to/your/grampsdb/xxxxxxxx
roots:
- I0001
- I0002

The location of the config file must be set with an environment variable:

GREATGRAMPS_CONFIG=config.yml

Config file reference

Key	Required	Default	Description
db_path	yes	—	Path to your GRAMPS sqlite database directory
roots	yes	—	GRAMPS IDs of the people to build root views for
output_dir	no	www	Directory to write the built site into
ancestry_tree_id	no	—	Ancestry.com tree ID, used to generate profile links
templates_dir	no	—	Directory of custom Chameleon templates
static_dir	no	—	Directory of custom static files (CSS etc.)
nav_pages	no	[people, places, events, census, birthdays, surnames]	Which pages to show in the nav bar, and in what order
site_title	no	Family tree	Title used in the HTML <title> and the <h1> on the top-level index page

Relative paths are resolved relative to the config file’s directory.

The nav_pages list controls which links appear in the nav bar alongside Me, and in what order. Choose any subset of people, places, events, census, birthdays, surnames:

nav_pages:
- people
- events
- surnames

By default, the top-level index page (listing the available roots) is titled “Family tree”. Set site_title to override it:

site_title: The Nuttall Family