Getting started with your Joaktree component
1. Installation
2. Getting started - step 1: set up your parameters
Before you can process your GedCom file, you have to set up some parameters.
Go to the control panel and click the Parameters icon.
The parameters are shown.
The following parameters are used while processing the GedCom file.
-
GEDCOM Path
This is the folder location of your GedCom file.
Default value is: tmp
-
GEDCOM File
This is the name of your GedCom file.
No default value.
-
Conversion ANSEL characters
When your GedCom file is generated with ANSEL characters set (that is the standard for GedCom),
and your website has UTF-8 character set, it is recommended to convert and
to choose the option: Conversion to UTF-8
When your GedCom file is generated with ANSEL characters set (that is the standard for GedCom),
and your website has Unicode character set, it is recommended to convert and
to choose the option: Conversion to Unicode
For all other situations, no conversion is recommended.
Option: No conversion
-
Administer name prepositions separatly
Dutch names sometime contains prepositions, like for example "van" in the name "van Dantzig".
In the GedCom file the last name is stored in one single field.
Here you have the option to separate the Dutch preposition from the rest of the name.
This will result in a different ordering of the names:
(a) option: Full names
There is no separation, and the name "van Dantzig" is alphabetized under the letter "V" and shown as "van Dantzig".
(b) option: Separated names
The names are separated, and the the name "van Dantzig" is alphabetized under the letter "D" and shown as "Dantzig, van".
-
Patronym setting
This is an option to store, show and search on patronyms.
(a) option: No patronyms
Patronyms are not shown.
(b) option: Patronyms from GedCom file relations
The program takes the first name of the father from the GedCom file and stores this separatly.
The patronym is shown in the lists of names and can be searched
The patronym is shown after the first names of the persons separated by a specific character (see below)
Example: Niels -Rene- van Dantzig
(c) option: Patronyms from GedCom name fields
If you have - like the author of this Joaktree viewer - stored the patronyms yourself in the name fields,
you may want to use this option.
When for example the first name is stored like "Niels -Rene-"
this option separates the first name "Niels" fro, the patronym "Rene"
-
Patronym separation character
See also "Patronym setting".
Here you define the separation character(s) for extracting (option c of Patronym setting)
and showing (options b and c of Patronym setting) patronyms.
back to the top
Before you process your GedCom file, you have to look at these extra parameters.
All persons in your Joaktree component will have three attributes.
These parameters can be set and changed by you on the Person page.
-
published
When a person is published, this person is shown in the viewer.
When a person is unpublished, this person is hidden and cannot be viewed.
-
living
When a person is living (and also is published),
only the name of this person is shown in the viewer.
When a person is not living (and also is published),
all available information - like birth date and death date - of this person is shown in the viewer.
-
page
When a person has page (and also is published),
this person will have its own page in the viewer and can be searched for in the lists.
When a person has no page (and also is published),
this person is shown as child or spouse of another person, but has no link to its own page.
(This is a feature to hide children who died young or are still born.)
The three paramters are also set while processing the GedCom file for newly added persons to your database.
-
Don't show people born after
People with a birth date after the year
automatically will get the setting unpublished.
-
No living people who are born before
The following people are set as not living
- when either a date of death, a place of death, a date of burial, or a place of burial is given;
- when none of the above is given, but the year of birth is given and this year is before this year.
All other people are automatically set as living
-
No page for children who died before
Children who died before the given age
automatically will get the setting no page.
Note: these settings are only for newly added persons to your database.
Manually set settings for existing persons are NOT written over.
back to the top
These are two advanced parameter setting used while processing your GedCom file.
-
Rebuild relations
Every time when your synchronize an updated GedCom file, you have the following choices.
(a) Option: no
This option is recommended when you upload every time a partial set of your genealogical data in your GedCom file
Existing relations stay unchanged (or are updated when necessary) and new relations are added for the existing persons.
No relations are removed.
(b) Option: yes
This option is recommended when you upload every time a full set of your genealogical data in your GedCom file
All relations between persons are removed and then added from the newly imported file.
-
Process steps
Default setting is to load and process your GedCom file in one big swoop
This is recomended option: Process all steps
When you process a very large file, you may run into system limitations.
To solve that you have the option to process your file in separate sub steps.
- Load GedCom file
- Process persons
- Process sources and repositories
back to the top
These parameters are not used while processing the GedCom file.
These parameters are described here.
back to the top