Verify the Data → HTML report

A Gramps tool that runs the built-in Verify the Data checks and saves the result as a self-contained, sortable HTML report in which each item can be ticked off once you have reviewed it.

What it does

How it works

The tool does not copy the checks. It imports the Verify class from Gramps' own verify module and calls its run_the_tool() through a light "shim", collecting the results instead of showing them in the usual window.

That means:

Requirements

Installation

  1. Close Gramps.

  2. Extract the downloaded ZIP archive.

  3. Copy or extract the project folder into your Gramps user plugin folder. Keep the complete folder structure unchanged, including any locale folder included with the project.

    The user plugin folder is normally located here:

    Replace <version> with the Gramps version folder used on your system.

  4. Start Gramps again.

  5. Check that the installed filter, rule, gramplet or tool is available where described in the project documentation.

If the project does not appear or fails to load, check Help → Plugin Manager for an error message.

Removing the test version

  1. Close Gramps.
  2. Delete the project folder that you added to the Gramps user plugin folder.
  3. Start Gramps again.

Because the project was installed only in the user plugin folder, removing that folder removes the test installation without changing the original Gramps program files.

The tool appears under Tools → Analysis and Exploration.

Usage

1. Set your thresholds (once)

The thresholds — maximum age, young parent, spacing between children, and so on — are read from the built-in Verify the Data tool. Those settings are only stored when that tool is actually run. So:

Open Tools → Family Tree Repair → Verify the Data, set your preferred values, and click Run. Changing a value and closing the window without running does not save it.

Once run, your values are remembered and reused every time. You only need to do this again when you want to change a threshold.

2. Generate the report

Run Verify the Data → HTML report. It reads your saved thresholds, runs the checks, asks where to save the .html file, and opens it in your browser. The confirmation dialog reminds you which tool the thresholds came from.

The report

Feature Notes
Sort Click any column header; click again to reverse.
Filter All / Errors only / Warnings only.
Search Matches name, ID, object type and check text.
Hide reviewed Temporarily removes ticked items from the list.
Check mark Marks an item as reviewed.
Save a copy Downloads a copy with the current check marks baked in.
Reset check marks Clears all marks for this family tree.

About saving your progress

Check marks are stored in your browser and are normally kept between visits. Each item has a stable key (ID|rule), so the marks even survive regenerating the report.

To be completely sure of keeping your progress — or to move it to another device — use Save a copy. The downloaded file has your current check marks baked in, so they show up wherever the file is opened.

One caveat: when the file is opened as a local file (file://) in Chrome, browser storage is not always kept between sessions. In that case, Save a copy is the safe way to keep your work. Served over http (from a website) or opened in Firefox, the marks persist on their own.

Language

English is the source language. The report and the tool interface are fully translatable through a bundled catalog:

VerifyHTML/locale/<lang>/LC_MESSAGES/addon.mo

A Danish translation is provided. To rebuild it after editing po/da.po:

msgfmt po/da.po -o locale/da/LC_MESSAGES/addon.mo

If no matching .mo is found, the tool falls back to English.

Author

Henning — contact@myown-project.dk Documentation: https://myown-project.dk/tools/verify-the-data/index.html