Skip to content

Commit

Permalink
Documented more overview in the README
Browse files Browse the repository at this point in the history
  • Loading branch information
nigelhorne committed Aug 8, 2024
1 parent fff0490 commit 07f0f85
Show file tree
Hide file tree
Showing 2 changed files with 19 additions and 1 deletion.
18 changes: 17 additions & 1 deletion README.md
Original file line number Diff line number Diff line change
Expand Up @@ -10,6 +10,7 @@ at https://genealogy.nigelhorne.com.
This is quite complex software, so if you are a genealogist looking to create
a website and aren't an IT guru,
it would be better to e-mail me on `<njh at nigelhorne.com>` for professional help.
The software is aimed to be useful for people with limited genealogical knowledge.
If you contact me, please let me know the program you're using to create your
Gedcom file, and the operating system you are using.

Expand All @@ -24,8 +25,13 @@ Typical usage:
You will then have two sites created in sub directories
- static-site is static HTML (no CGI),
- dynamic-site is a [VWF](//github.com/nigelhorne/vwf) based website which uses templates to support more than one
language and present different content to mobile/web/search-engine clients. This is much more easily customisable
language and present different content to mobile/web/search-engine clients.
This allows for better SEO and a seemless experience on mobile as well as desktops
in a multi-lingual environment.
This is much more easily customisable
by you to create the look and feel of the website that you want.
The dynamic site contains more data visualisation such as trend analysis,
time-lapse views and heatmaps in a visually appealing way.

If you decide to use the static site, just copy files in the static-site directory to your web-server.

Expand Down Expand Up @@ -54,6 +60,11 @@ since they contain cached copies of pages that will be inconsistent with the new

Finally, for the dynamic site, set-up the logging, if you want any. To do that modify the page.l4pconf file to taste.

Different people use different ways to format and enter information,
ged2site goes out of its way to support all of these,
such as different location and date formats.
If your data shows issues with this aim, let me know.

## Installation and Pre-Requisites

Ged2site uses many CPAN modules which it will try to install if they are not
Expand Down Expand Up @@ -106,6 +117,9 @@ The options to ged2site are:
NOTE: when you use the -m option, your Google API key will be included in the output,
so ensure that you restrict the key's use just to this app on your host's IP.

Data privacy and handling of sensitive data is important,
the default configuration works hard to avoid sharing information about living people.

If [gedcom](https://github.com/nigelhorne/gedcom) is installed,
ged2site will also create a calendar of births and deaths,
one page for each month in the current year.
Expand Down Expand Up @@ -239,6 +253,8 @@ please e-mail me or add a bug report to github.com/nigelhorne/ged2site.

Profile pictures are not handled with output from Ancestry. Findmypast is handled correctly.

The story telling format is hard coded, it would be useful if it were configurable.

## Acknowledgements

https://fullcalendar.io for the calendar view
Expand Down
2 changes: 2 additions & 0 deletions ged2site
Original file line number Diff line number Diff line change
Expand Up @@ -31,6 +31,8 @@
# TODO: investigate User::Identity
# TODO: handle https://www.compart.com/en/unicode/U+25CF in notes as <li>
# TODO: collapsable lists: https://www.w3schools.com/howto/howto_js_collapsible.asp
# TODO: is there anything that could be better modeled in a 3D way?
# TODO: data analysis of notes to find extra information

# -d: Download copies of objects rather than link to them, useful if the
# objects are on pay sites such as FMP
Expand Down

0 comments on commit 07f0f85

Please sign in to comment.