omustardo / gedfmt

Formatting utilities for genealogy 'gedcom' files.

gedfmt

The gedfmt project supports text formatting related to genealogy 'gedcom' files. There are three different tools. A Windows desktop application, a command-line program, and a server to support formatting through a website.

The initial drive for the project was to get more reasonably formatted output from WikiTree.com's gedcom import tool, to reduce manual toil when adding many profiles.

As of November 2021, the goal is to set up a website to do the same sort of text formatting. The plan is to use http://gedfmt.com but it is not yet available. If you are technically inclined, you can run the server to use it locally.

Alternatives

• https://www.wikitree.com/wiki/Space:WikiTree_AGC This is a Chrome extension with a very similar goal.

Directories

windows_desktop

Otherwise known as "WikiTreeTextFormatter".

This is a Windows desktop application created in 2017 by David Loring.
It is documented at https://www.wikitree.com/wiki/Space:WikiTree_Text_Formatter. archive_link
It is part of this repository because other work is based closely on it, and it was not previously on github. David has given permission to have it here.

windows_gedfmt

An executable file with support for formatting the content of WikiTree gedcom-generated profiles. It is a hacked together version of WikiTreeTextFormatter, but with the GUI removed.

Sample usage:

$ gedfmt.exe path/to/file.txt

It will generate a file named path/to/file_fmt.txt (note the _fmt before the extension).

server

Server is a Golang executable that exposes an HTTP interface for formatting content. It also serves a very minimal webpage.

There are also a user instructions at https://github.com/Omustardo/gedfmt/blob/main/server/docs/user_documentation.md.

gedfmt's Issues

FR: Add original GEDCOM import to acknowledgements

For example:

== Biography ==
''This biography was auto-generated by a GEDCOM import.<ref>Seiler-146 was created by [[Saylor-293 | Maurice Saylor]] through the import of Saylor Family Tree 2014-02-05.ged on Feb  4, 2014. ''This comment and citation can be deleted after the biography has been edited and primary sources are included.''</ref> It's a rough draft and needs to be edited.''

This is currently stripped out entirely. It should be modified and then moved into Acknowledgements:

==Acknowledgements==
Seiler-146 was created by [[Saylor-293 | Maurice Saylor]] through the import of Saylor Family Tree 2014-02-05.ged on Feb  4, 2014.

I would argue that it doesn't make sense to put in the Sources section as the content in the rest of the profile should have real sources.

FR: Remove "Needs GEDCOM Cleanup" category

Some profiles contain a category that should arguably be removed: [[Category: Needs GEDCOM Cleanup]]

On one hand, the formatter does format the profile, so it's somewhat cleaned up. Even a formatted GEDCOM isn't necessarily all cleaned up though. Especially with duplicate references, and poorly ordered sections.

If we do want to remove it, it should probably be added here: https://github.com/Omustardo/gedfmt/blob/main/windows_gedfmt/GedcomTextFormatter.vb#L177

Formatting with no results at all

[[Category: Missoula, Montana]][[Category: Needs GEDCOM Cleanup]]
== Biography ==

''This biography was auto-generated by a GEDCOM import. It's a rough draft and needs to be edited.''

=== Birth ===
: Birth:
:: Date: 10 Jun 1891
:: Place: Missoula, Montana<ref>Source: [[#S3]] </ref><ref>Source: [[#S4]] </ref><ref>Source: [[#S7]] </ref>

=== Death ===
: Death:
:: Date: 29 Mar 1916
:: Place: San Francisco, San Francisco, California<ref>Source: [[#S7]] </ref>

=== Marriage ===

: Husband: [[Chapman-3803|Alfred Chapman]]
: Wife: [[Holbrook-860|Lydia Nancy Holbrook]]
: Marriage:
:: Date: Abt 1889<ref>Source: [[#S4]] </ref>
: Child: [[Chapman-3799|Alfred L. Chapman]]
: Child: [[Chapman-3804|Daisy Chapman]]
: Child: [[Chapman-3805|Mary Chapman]]
: Child: [[Chapman-3806|Pearl Chapman]]
: Child: [[Chapman-3807|Ione Chapman]]
: Child: [[Chapman-3808|Theodore Chapman]]
: Child: [[Chapman-3809|Susie Chapman]]

== Sources ==

* Source: <span id='S3'>S3</span> Title: 1910 US Census Italicized: Y Paranthetical: Y
* Source: <span id='S4'>S4</span> Title: 1900 US Census Italicized: Y Paranthetical: Y
* Source: <span id='S7'>S7</span> Title: FamilySearch.org Italicized: Y Paranthetical: Y

<references />

=== Acknowledgments ===

Thank you to [[Osmer-1 | Tami Osmer]] for creating WikiTree profile Chapman-3804 through the import of NANCYGed.ged on Aug 14, 2013. Click to the Changes page for the details of edits by Tami and others.

<!-- Please edit, add, or delete anything in this text. Thank you! -->