Box Pedigree charts are User Items that create pedigree charts showing generations in overlapping columns.
For people in the chart who have a person entry, the chart entry links to the person entry and vice-versa.
A Box Pedigree chart is a Content Item and does not create a page of its own. You must add it to a Page User Item or you will not see its content.
The following screenshot shows a portion of an Box Pedigree chart. The subject is Alta Wood.
Edit Box Pedigree Chart
The Edit Box Pedigree Item window controls the properties of a Box Pedigree chart.
Chart colors are determined by the Theme but can be changed by the user via the properties in the Theme.Chart section. Other stylesheet options are controlled via the subsections under the the Styles.Charts section.
The Title property identifies the User Item in the User Items list.
See Enabled in the Common Properties section of the User Items help page.
Specify the ID number of the subject of the chart in the Subject textbox.
You may use the Picklist button to select the subject.
Use the Generations textbox to specify how many generations the chart should contain. The default is 999 generations, which should be enough to include all generations except in unusual usage scenarios.
The Connector Style property determines whether connectors attach at the top and bottom ("Connect on top and bottom"), which is the default, or at the right end ("Connect on right"). Connectors on the top and bottom produce a narrow chart, whereas connectors on the right produce a wider chart.
The following examples show the same entries using the two Connector Styles.
See the Boxes Tab section to see diagrams of the two different connector options.
When using the "Connect on right" option, consider changing the Connector Offset and Connector Width properties to 8 and 8, respectively, to reduce the width of the chart.
If Suppress Duplicates is checked, GedSite will detect duplicates in the chart and stop processing the lineage for the second and subsequent duplicates. The default is checked.
Duplicates entries include a button to scroll the original into view.
Chart entries that are linked from one or more later duplicates are marked with a small circle.
Add On-Chart Links
If Add On-Chart Links is checked, GedSite will add button links on the page to scroll the chart from the current location to an entry above or below. The buttons are added when there is a large vertical gap between the current person and the next or previous peer.
The Person Legend property determines whether GedSite adds items that explain the entries in the chart that are colored by gender, and if so, where they will appear:
- None – not added to the legend
- Top – added to the top legend only
- Top, Bottom – added to both the top and bottom legend
- Bottom – added to the bottom legend only
The Accent Legend property determines whether GedSite adds items that explain the entries in the chart that are colored by an Accent, and if so, where they will appear. The choices are the same as listed above.
Legend entries are mixed together. The subject item appears first, then Accents, if any, followed by the person items.
In the example, the "Direct Ancestors" item was created with an Accent.
The Class textbox allows you to specify the name of a CSS class that will be added to the chart's container. To alter the appearance of every chart that shares the class name, define the class using a User Style.
If Add References is checked, GedSite will add a chart-type reference to each person who is included in the chart.
Person Filter Tab
Use the Person Filter tab to reduce the set of people included in the chart.
People must pass the basic requirements to be included in a chart before the Person Filter is applied. So, for example, in a pedigree chart limited to five generations, a person must be an ancestor of the progenitor within five generations. In addition, the People section filters are applied before the Person Filter and so living or excluded people may or may not be eligible to be in the chart.
If those requirements are met, GedSite applies the Person Filter. The Person Filter may decrease the number of people in a chart, but it cannot increase the number of people because of the processing described in the paragraph above.
For example, using a Person Filter with a DNA Descendant Of criteria term may be used to limit a pedigree chart to the subset that inherits a particular type of DNA from the progenitor identified in the criteria term.
See the Filters page for more information about filters.
Name and Date Tab
The Name Format pull-down menu controls the format of names in the chart. The choices are "Full Name" and "Name w/ Middle Initials". The default is "Name w/ Middle Initials".
When Name Format is set to "Name w/ Middle Initials", GedSite transforms the given name field into a first name and middle initial.
Given names that include any of these characters are not changed:
" ' , ; : ( ) [ ]
For example, "John (Jack)" will appear as "John (Jack)", i.e., it is unchanged.
If a given name begins with one or more initials, the first non-initial middle name is retained. For example, "J. William Henry" will appear as "J. William".
If a given name includes more than one middle name, only the initial for the first middle name is retained. For example, "John Jacob Jingleheimer" will appear as "John J.".
When a chart includes a shortened version of the given name, the visitor may hover over the chart entry to see the person's full name.
The Date Format pull-down menu controls the format of dates in the chart. It has the same choices as the date formats property described in the Dates section. The default is "Aaa yyy".
The Lifespan Format determines the format of lifespans in the chart. The default value is "(b. birth, d. death)".
The tooltip that is visible when a visitor hovers their mouse over a chart entry shows a lifespan will full dates.
The Include Images property determines whether GedSite adds the person's primary image to a box in the chart.
When a person has a primary image, and that image can be included in the site, GedSite will expand the box and embed the image. The layout of the chart will be adjusted to accommodate the image, and that may include increasing the size of rows and/or columns in the chart.
Images are subject to one of the "Show Primary Image" detail filters in the People section.
The Image Alignment pull-down menu controls the alignment of the embedded image. The choices are "Left", "Right", "Top", and "Bottom". The default is "Left".
GedSite expects images that are taller than they are wide. This is a common format for formal photographs and works well with images that show the head and shoulders of the subject.
The chart will look best if the all the images use the same aspect ratio. The aspect ratio is the ratio of the pixel width to the pixel height. So, for example, if you assign primary images that are all in the 4:5 ratio, then good image sizes are 200x250, 400x500, 800x1000, etc.
The best image ratio for use with GedSite is 4:5. Other portrait-mode (taller than wide) ratios will also work well.
The Boxes tab includes several properties for managing the layout of the chart.
The Width and Height properties control the size of the boxes.
The Row Leading, Connector Offset, and Connector Width properties control the spacing of the boxes in the chart.
Use the Accents tab to add Accents to highlight selected members of the chart.