The Upper Panel is where you draw family tree charts (genealogies). The Lower Panel on the screen is for displaying information about persons and families in the charts below. In these help screens, we will refer to the lower panel as the Detail Display and the upper panel as the Chart.
To begin a new project, click on the chart where you would like to draw the first person. A menu will appear; choose a Female, Male or Union (marriage). (The choices to 'Link to Existing Person' and 'Draw Special Relationship' will be explained later.) To cancel the menu without making a choice, click somewhere outside the menu boundaries.
The first time you create a person or union in a new project, a pop-up box will appear asking the Name of Your Project. Normally, if you are studying the XYZ people you will name your project 'XYZ.'
After naming your project, you will be asked to identify yourself. The name you enter will be recorded as the 'data author' for your entries. This is handy when more than one person works on a project, or if you share your data with a colleague.
After naming the project and yourself, you will then be allowed to finish creating your first chart symbol.
When you create a project named 'XYZ' we will refer to this as the XYZ Context. The context includes all the people and unions (marriages), the kin terms of reference and kin terms of address in the local language, and (eventually) the logical definitions of all the kin terms. All the data for your XYZ context will be stored in a file named 'XYZ.silk'.
To create a new context, simply start creating the genealogical chart as described above. Periodically, and at the end of your session, you should save your data. The File Menu has 'Save' and 'Save As' options similar to other software programs. Use 'Save As' to change the file name or location.
Your data is saved in SILK files with an extension '.silk'; this format uses a slightly modified version of XML, (eXtensible Markup Language). Because of these modifications, SILK files cannot be viewed directly. However, if you use your browser's 'File > Open File' command to "open" a SILK file, you will see a Summary of the file, including progress statistics. This summary is also displayed when you "Act on Suggestions."
You should be very careful not to modify SILK files; this could corrupt the files and make them unusable in SILKin.
To continue working on a project you previously started, in the File Menu select 'Open' and navigate to the folder where your SILK file is stored. The suggested (and default) location is the 'Context Under Construction' folder in the 'Library' folder in the 'SILKin' folder. As soon as the file loads, you will be asked to 'log in' by selecting your name from the menu of data authors who have contributed to this project. If this is the first time you have worked on this SILK file, you can add your name to the menu. Everything you do on the chart will be linked to your name as 'Data Author.'
There is an 'Open Recent' choice in the File Menu, similar to other software programs. 'Open Recent' displays a list of the five most recently opened files, newest first. This can be handy when you are working with files stored in various locations (i.e. not all in the default location: 'Library > Context Under Construction'). Note that opening files — with either 'Open' or 'Open Recent' — does not change the default location. Saving a file updates the default location to that file's location.
Clicking 'Save As' creates a new SILK file with the same language name but a different file name. When you click 'Get New Suggestions' the suggestions will be stored in a file with the same base name as your SILK file, but the extension will be ".html" instead of ".silk". (The SILK file will be in the Library folder "Context Under Construction" and the HTML file will be in the Library folder "Suggestions.")
Gathering data about the genealogies and kin terms of a people group is mostly a matter of building a family tree chart and filling in the kin terms.
After you have created one or more people, you can create marriages (unions). To place someone in a union, drag and drop (or "pick and plop") them onto it. If you drop them onto the top of a union, they are added as a spouse. If you drop them onto the bottom of a union, they are added as children. As soon as they are added, a line appears linking them to the union. If you add someone to a union incorrectly, you can remove them by "re-dropping" them on the union. So... drop them once to add them to the union; drop them a second time to remove them.
Whenever you click on a person or union, the lower (Detail) display panel will display their data. When creating a new person, you should always enter a name and the kin terms of reference in the Detail Display for that person. Entering dates of birth/death or comments is useful but optional. A few fields are generated by the system (e.g. a person's or union's ID number) and cannot be altered.
SILKin allows you to have multiple pages for your genealogical charts. The Detail Display shows the 'home chart' of a person to the right of their birth date. If there are one or more links to a person, a drop-down list of the other charts on which those links appear is to the right of the home chart. If your context includes any User Defined Properties, the bottom of the Detail Display will show a drop-down menu of them; you can view and edit their values there.
The person whose data is displayed is called "Alter." In the upper right of the Detail Display is a box labeled "Current Ego." The kinship term of reference that Ego calls Alter is recorded in the first text field near the bottom of the display. The reciprocal term that Alter calls Ego is recorded in the second field.
When viewing the details about a union, the husband, wife and children are listed in text fields. You cannot edit these; the correct way to add or delete persons to a union is described above; you do it graphically by dragging and dropping.
In many cultures, the terms of reference and terms of address are the same. The third and fourth fields hold the term of address and its reciprocal. By default these terms are the same, and the system fills them in. You cannot edit those fields ordinarily. However, if you check the menu item "Distinct Terms of Address" in the Context menu, then these fields will not be filled automatically -- you must enter the terms of address manually.
Each kin term represents a "dyad" - the basic data you need to learn a kinship system. As you create persons and unions and fill in the kin terms, the system is capturing the dyads for analysis. The system is also capturing the genealogical data in the family tree charts.
The purpose of dyads, of course, is to record what kin term belongs to each set of kin types. You will enter kin terms in the Detail Display's boxes for each Alter relative to the current Ego. Every time you select a new Ego, you can enter a whole new set of kin terms for all the Alters.
Not every relationship (kin type) has a kin term in every language. In English, for example, there is no kin term for your son's wife's mother's sister. But there may be a kin term in some other language. It is useful to identify the relationships that have no kin term; this sets 'boundaries' for the kinship system. SILKin has a special symbol -- 'no__term' -- that means "there is no kin term". (Notice the two consecutive underscores.) When the system sees the 'no__term' symbol, it knows that no correct definition for a kin term will include this relationship. This helps the Learning Module to rule out incorrect candidate definitions.
The 'no__term' symbol has another practical use; it limits the amount of data you must enter. Because 'no__term' means "there is no term" then an empty data field can be interpreted as "the User has not yet made an entry here." So you can enter enough kin terms to give the Learning Module solid data, without entering every possible kin term for every possible relationship. Likewise, you don't have to enter 'no__term' in every data field where it could go. Just enter enough of them at the boundaries so the Learning Module can figure out where the boundaries are.
Kin terms can be composed of the following:
In addition to the above rules, certain terms are reserved in SILKin; you may not use them as kin terms.
Examples of LEGAL kin terms:
Examples of ILLEGAL kin terms:
Please note, the above restrictions apply only to kin terms. The names of persons, the comments fields for person and families, etc. are free of all such restrictions except three: