Gramps Enhanced Narrated Web Site Report

• Purpose: Generates a complete, linked HTML website containing individuals, families, events, places, media, and sources from your family tree database.
• Customization: Allows you to configure options such as CSS styles, inclusion of living people, thumbnail sizes, and output directories.

Why

I find the Narrated Web Site report useful because it provides a good overview of a family tree when Gramps itself is not open.

If you have a website where the generated report can be uploaded, it can also be shared with selected people who have access.

If living people are included, the report may contain personal and sensitive information and should therefore be protected appropriately.

The standard Gramps Narrated Web Site does not require a web server for local viewing. My enhanced version includes additional scripts and search functions that require the generated site to be served through a web server.

Extra Features in My Version

• Calendar surname adjustment: a wife now uses her husband's surname unless she later remarries.
• Marking of non-biological children.
• Menu changes, including an added search page.
• PDF download of the pedigree chart.
• Relationship path to the Home person on the personal pages of biologically related people.
• Search by name, relationship, occupation, or role.

Requirements

• Gramps 6.0.x or later.

• Gramps tags named:

  • Adopted
  • FatherOfFoster
  • Foster
  • Godparent
  • MotherOfFoster
  • NotRelated
  • Witness

  See how to create and use tags here:
  https://myown-project.dk/guides/gramps-tags-filters/

• A Gramps filter named Gedcom.

• Python 3.x.

• The Python packages:

  • pandas
  • openpyxl
  • BeautifulSoup

• The GEDCOM Relationship Report must be run as part of the workflow because its JSON file is required. All required files are included.

  See the guide here:
  https://myown-project.dk/guides/gedcom-relationship-report/index.html

Tested Platforms

Tested with:

• Gramps 6.0.8 on Windows 11.
• Gramps 6.1.0-beta2-1 on Windows 11.

Files

The package contains:

6.0.8

• basepage.py
• calendar.py
• gramps.mo
• person.py
• Shortcut to gramps.mo
• Shortcut to the webreport folder

6.1.0

• basepage.py
• calendar.py
• gramps.mo
• person.py
• Shortcut to gramps.mo
• Shortcut to the webreport folder

Gedcom-relationship-report-V1.0

All required files for the GEDCOM Relationship Report.

Additional files

• people.py
• relationship.py
• relationship_names.xlsx
• roles.py
• search.html
• README.md
• RELEASE_NOTES.md
• License.txt

Important

• The Home person must be the same in both the GEDCOM Relationship Report and the Narrated Web Site report.
• Gramps must be run in English when generating this version of the report.

Install

The Gramps web-report Python files are normally located here:

C:\Program Files\GrampsAIO64-x.x.x\gramps\plugins\webreport

The Danish gramps.mo file is normally located here:

C:\Program Files\GrampsAIO64-x.x.x\share\locale\da\LC_MESSAGES

Replace x.x.x with your installed Gramps version.

1. Make backup copies of:

   • basepage.py
   • calendar.py
   • person.py
   • the Danish gramps.mo

2. Extract Narrated_files.zip into a new working folder. In this guide, the folder is called:

   family_tree_web_report

3. Copy the three Python files from the folder matching your Gramps version and overwrite the three original files in the Gramps webreport folder.

4. Copy gramps.mo from the folder matching your Gramps version and overwrite the original Danish gramps.mo.

Use

1. GEDCOM Relationship Report

1. Open family_tree_web_report in a terminal.

2. Run:

   python relationship.py

3. Copy the JSON file created by the GEDCOM Relationship Report into:

   family_tree_web_report

2. Gramps

1. Open Gramps in English with your family tree.

2. Set the Home person / Active person to the same person used in the GEDCOM Relationship Report.

3. Select:

   Reports → Web Pages → Narrated Web Site

The settings shown in bold are settings imported or required by this workflow.

Settings not shown in bold are the settings I personally use.

Report Options

1. Set Destination to the family_tree_web_report folder.

2. Enter a Website title.

3. Set Filter to Entire database.

4. Filter person should be your Home person.

5. Select Show the relationship....

6. Living people:

   • Included
   • All data

HTML Options

1. StyleSheet:

   • Mainz

2. Select Include ancestor's tree.

3. Select This is a secure....

Display

1. Set Date format.

2. Include Gramps ID.

3. Include Tags.

4. Select:

   • Sort all children...

5. Graph generations:

   • 6

6. Select:

   • Include narrative...

Extra Pages

1. Extra page name:

   I use the Home person's first name with a house icon in front.

   Example:

   🏠 Henning

2. Your extra page path:

   This should link to the Home person's personal page inside the generated Narrated Web Site.

   Example:

   ppl/d/c/10256833e45059885c246bddfccd.html

   If this is your first run, you will not yet know this path.

   Leave it blank for now. After the first report has been generated, find the Home person's personal page, copy the relative page path, and run the report again.

Images Generation

1. Select:

   • 1
   • 2
   • 5

2. Max width...:

   • 300

Advanced Options

1. Select the last five options.

Include

1. Select Include other roles.

2. Select all options except:

   • 5
   • 6
   • 7
   • 8

HeatMap Options

1. Do not select this option.

Other Inclusion Options

1. Select:

   • Include the news...

2. Max days...:

   • 30

3. Max number...:

   • 100

Calendar Options

1. Select Include the web calendar, with birthdays, anniversaries, and death dates enabled.

2. Birthday surname: Wives use husband's surname (from last...).

3. Show data...:

   • 1900

Generate the Report

Press OK.

The report may take some time to generate.

3. Browser

1. Open the generated index.html in your browser.

2. Find your Home person.

3. Open the Home person's personal page and copy the final relative part of the page address.

Example:

ppl/d/c/10256833e45059885c246bddfccd.html

4. Gramps

1. Run:

   Reports → Web Pages → Narrated Web Site

   again.

2. You can also change any other report settings if you were not satisfied with the first result.

3. The most important missing setting from the first run is the Extra Pages path.

4. Enter the copied personal-page path under:

   Extra Pages → Your extra page path

5. Generate the report again with OK.

6. Close the family tree and Gramps.

5. Python

Open family_tree_web_report in a terminal and run:

python people.py

Then run:

python roles.py

Finally start a local web server:

python -m http.server 8000

Do not close the terminal window while viewing the site.

6. Browser

Open:

http://localhost:8000/index.html

You can now review the completed Enhanced Narrated Web Site.

When you are finished, return to the terminal and stop the local web server with:

Ctrl+C

License

Released under the GNU General Public License v2.0 or later (GPL-2.0-or-later), the same license as Gramps.

Author

Henning — contact@myown-project.dk
https://myown-project.dk