.
*/
define('WT_SCRIPT_NAME', 'help_text.php');
require './includes/session.php';
$help = Filter::get('help');
switch ($help) {
//////////////////////////////////////////////////////////////////////////////
// This is a list of all known gedcom tags. We list them all here so that
// xgettext() may find them.
//
// Tags such as BIRT:PLAC are only used as labels, and do not require help
// text. These are only used for translating labels.
//
// Tags such as _BIRT_CHIL are pseudo-tags, used to create family events.
//
// Generally, these tags need to be lists explicitly in add_simple_tag()
//////////////////////////////////////////////////////////////////////////////
case 'ADDR':
$title = WT_Gedcom_Tag::getLabel('ADDR');
$text = I18N::translate('Enter the address into the field just as you would write it on an envelope.
Leave this field blank if you do not want to include an address.');
break;
case 'AGNC':
$title = WT_Gedcom_Tag::getLabel('AGNC');
$text = I18N::translate('The organization, institution, corporation, individual, or other entity that has authority.
For example, an employer of an individual, or a church that administered rites or events, or an organization responsible for creating and/or archiving records.');
break;
case 'ASSO_1':
$title = WT_Gedcom_Tag::getLabel('ASSO');
$text = I18N::translate('An associate is another individual who was involved with this individual, such as a friend or an employer.');
break;
case 'ASSO_2':
$title = WT_Gedcom_Tag::getLabel('ASSO');
$text = I18N::translate('An associate is another individual who was involved with this fact or event, such as a witness or a priest.');
break;
case 'CAUS':
$title = WT_Gedcom_Tag::getLabel('CAUS');
$text = I18N::translate('A description of the cause of the associated event or fact, such as the cause of death.');
break;
case 'DATE':
$title = WT_Gedcom_Tag::getLabel('DATE');
$CALENDAR_FORMAT = null; // Don't perform conversions here - it will confuse the examples!
$dates = array(
'1900' =>new Date('1900'),
'JAN 1900' =>new Date('JAN 1900'),
'FEB 1900' =>new Date('FEB 1900'),
'MAR 1900' =>new Date('MAR 1900'),
'APR 1900' =>new Date('APR 1900'),
'MAY 1900' =>new Date('MAY 1900'),
'JUN 1900' =>new Date('JUN 1900'),
'JUL 1900' =>new Date('JUL 1900'),
'AUG 1900' =>new Date('AUG 1900'),
'SEP 1900' =>new Date('SEP 1900'),
'OCT 1900' =>new Date('OCT 1900'),
'NOV 1900' =>new Date('NOV 1900'),
'DEC 1900' =>new Date('DEC 1900'),
'11 DEC 1913' =>new Date('11 DEC 1913'),
'01 FEB 2003' =>new Date('01 FEB 2003'),
'ABT 1900' =>new Date('ABT 1900'),
'EST 1900' =>new Date('EST 1900'),
'CAL 1900' =>new Date('CAL 1900'),
'INT 1900 (...)' =>new Date('INT 1900 (...)'),
'@#DJULIAN@ 44 B.C.' =>new Date('@#DJULIAN@ 44 B.C.'),
'@#DJULIAN@ 14 JAN 1700' =>new Date('@#DJULIAN@ 14 JAN 1700'),
'BET @#DJULIAN@ 01 SEP 1752 AND @#DGREGORIAN@ 30 SEP 1752' =>new Date('BET @#DJULIAN@ 01 SEP 1752 AND @#DGREGORIAN@ 30 SEP 1752'),
'@#DJULIAN@ 20 FEB 1742/43'=>new Date('@#DJULIAN@ 20 FEB 1742/43'),
'FROM 1900 TO 1910' =>new Date('FROM 1900 TO 1910'),
'FROM 1900' =>new Date('FROM 1900'),
'TO 1910' =>new Date('TO 1910'),
'BET 1900 AND 1910' =>new Date('BET 1900 AND 1910'),
'BET JAN 1900 AND MAR 1900'=>new Date('BET JAN 1900 AND MAR 1900'),
'BET APR 1900 AND JUN 1900'=>new Date('BET APR 1900 AND JUN 1900'),
'BET JUL 1900 AND SEP 1900'=>new Date('BET JUL 1900 AND SEP 1900'),
'BET OCT 1900 AND DEC 1900'=>new Date('BET OCT 1900 AND DEC 1900'),
'AFT 1900' =>new Date('AFT 1900'),
'BEF 1910' =>new Date('BEF 1910'),
// Hijri dates
'@#DHIJRI@ 1497' =>new Date('@#DHIJRI@ 1497'),
'@#DHIJRI@ MUHAR 1497' =>new Date('@#DHIJRI@ MUHAR 1497'),
'ABT @#DHIJRI@ SAFAR 1497' =>new Date('ABT @#DHIJRI@ SAFAR 1497'),
'BET @#DHIJRI@ RABIA 1497 AND @#DHIJRI@ RABIT 1497'=>new Date('BET @#DHIJRI@ RABIA 1497 AND @#DHIJRI@ RABIT 1497'),
'FROM @#DHIJRI@ JUMAA 1497 TO @#DHIJRI@ JUMAT 1497'=>new Date('FROM @#DHIJRI@ JUMAA 1497 TO @#DHIJRI@ JUMAT 1497'),
'AFT @#DHIJRI@ RAJAB 1497' =>new Date('AFT @#DHIJRI@ RAJAB 1497'),
'BEF @#DHIJRI@ SHAAB 1497' =>new Date('BEF @#DHIJRI@ SHAAB 1497'),
'ABT @#DHIJRI@ RAMAD 1497' =>new Date('ABT @#DHIJRI@ RAMAD 1497'),
'FROM @#DHIJRI@ SHAWW 1497'=>new Date('FROM @#DHIJRI@ SHAWW 1497'),
'TO @#DHIJRI@ DHUAQ 1497' =>new Date('TO @#DHIJRI@ DHUAQ 1497'),
'@#DHIJRI@ 03 DHUAH 1497' =>new Date('@#DHIJRI@ 03 DHUAH 1497'),
// French dates
'@#DFRENCH R@ 12' =>new Date('@#DFRENCH R@ 12'),
'@#DFRENCH R@ VEND 12' =>new Date('@#DFRENCH R@ VEND 12'),
'ABT @#DFRENCH R@ BRUM 12' =>new Date('ABT @#DFRENCH R@ BRUM 12'),
'BET @#DFRENCH R@ FRIM 12 AND @#DFRENCH R@ NIVO 12'=>new Date('BET @#DFRENCH R@ FRIM 12 AND @#DFRENCH R@ NIVO 12'),
'FROM @#DFRENCH R@ PLUV 12 TO @#DFRENCH R@ VENT 12'=>new Date('FROM @#DFRENCH R@ PLUV 12 TO @#DFRENCH R@ VENT 12'),
'AFT @#DFRENCH R@ GERM 12' =>new Date('AFT @#DFRENCH R@ GERM 12'),
'BEF @#DFRENCH R@ FLOR 12' =>new Date('BEF @#DFRENCH R@ FLOR 12'),
'ABT @#DFRENCH R@ PRAI 12' =>new Date('ABT @#DFRENCH R@ PRAI 12'),
'FROM @#DFRENCH R@ MESS 12'=>new Date('FROM @#DFRENCH R@ MESS 12'),
'TO @#DFRENCH R@ THER 12' =>new Date('TO @#DFRENCH R@ THER 12'),
'EST @#DFRENCH R@ FRUC 12' =>new Date('EST @#DFRENCH R@ FRUC 12'),
'@#DFRENCH R@ 03 COMP 12' =>new Date('@#DFRENCH R@ 03 COMP 12'),
// Jewish dates
'@#DHEBREW@ 5481' =>new Date('@#DHEBREW@ 5481'),
'@#DHEBREW@ TSH 5481' =>new Date('@#DHEBREW@ TSH 5481'),
'ABT @#DHEBREW@ CSH 5481' =>new Date('ABT @#DHEBREW@ CSH 5481'),
'BET @#DHEBREW@ KSL 5481 AND @#DHEBREW@ TVT 5481'=>new Date('BET @#DHEBREW@ KSL 5481 AND @#DHEBREW@ TVT 5481'),
'FROM @#DHEBREW@ SHV 5481 TO @#DHEBREW@ ADR 5481'=>new Date('FROM @#DHEBREW@ SHV 5481 TO @#DHEBREW@ ADR 5481'),
'AFT @#DHEBREW@ ADR 5481' =>new Date('AFT @#DHEBREW@ ADR 5481'),
'AFT @#DHEBREW@ ADS 5480' =>new Date('AFT @#DHEBREW@ ADS 5480'),
'BEF @#DHEBREW@ NSN 5481' =>new Date('BEF @#DHEBREW@ NSN 5481'),
'ABT @#DHEBREW@ IYR 5481' =>new Date('ABT @#DHEBREW@ IYR 5481'),
'FROM @#DHEBREW@ SVN 5481' =>new Date('FROM @#DHEBREW@ SVN 5481'),
'TO @#DHEBREW@ TMZ 5481' =>new Date('TO @#DHEBREW@ TMZ 5481'),
'EST @#DHEBREW@ AAV 5481' =>new Date('EST @#DHEBREW@ AAV 5481'),
'@#DHEBREW@ 03 ELL 5481' =>new Date('@#DHEBREW@ 03 ELL 5481'),
);
foreach ($dates as &$date) {
$date = strip_tags($date->Display());
}
// These shortcuts work differently for different languages
switch (preg_replace('/[^DMY]/', '', str_replace(array('J', 'F'), array('D', 'M'), strtoupper($DATE_FORMAT)))) {
case 'YMD':
$example1 = '11/12/1913'; // Note: we ignore the DMY order if it doesn't make sense.
$example2 = '03/02/01';
break;
case 'MDY':
$example1 = '12/11/1913';
$example2 = '02/01/03';
break;
case 'DMY':
default:
$example1 = '11/12/1913';
$example2 = '01/02/03';
break;
}
$example1 .= '
' . str_replace('/', '-', $example1) . '
' . str_replace('/', '.', $example1);
$example2 .= '
' . str_replace('/', '-', $example2) . '
' . str_replace('/', '.', $example2);
$text =
'' . I18N::translate('Dates are stored using English abbreviations and keywords. Shortcuts are available as alternatives to these abbreviations and keywords.') . '
' .
'' .
'| ' . I18N::translate('Date') . ' | ' . I18N::translate('Format') . ' | ' . I18N::translate('Shortcut') . ' |
|---|
' .
'| ' . $dates['1900'] . ' | 1900 | |
' .
'' . $dates['JAN 1900'] . '
' . $dates['FEB 1900'] . '
' . $dates['MAR 1900'] . '
' . $dates['APR 1900'] . '
' . $dates['MAY 1900'] . '
' . $dates['JUN 1900'] . '
' . $dates['JUL 1900'] . '
' . $dates['AUG 1900'] . '
' . $dates['SEP 1900'] . '
' . $dates['OCT 1900'] . '
' . $dates['NOV 1900'] . '
' . $dates['DEC 1900'] . ' | JAN 1900
FEB 1900
MAR 1900
APR 1900
MAY 1900
JUN 1900
JUL 1900
AUG 1900
SEP 1900
OCT 1900
NOV 1900
DEC 1900 | |
' .
'| ' . $dates['11 DEC 1913'] . ' | 11 DEC 1913 | ' . $example1 . ' |
' .
'| ' . $dates['01 FEB 2003'] . ' | 01 FEB 2003 | ' . $example2 . ' |
' .
'| ' . $dates['ABT 1900'] . ' | ABT 1900 | ~1900 |
' .
'| ' . $dates['EST 1900'] . ' | EST 1900 | *1900 |
' .
'| ' . $dates['CAL 1900'] . ' | CAL 1900 | #1900 |
' .
'| ' . $dates['INT 1900 (...)'] . ' | INT 1900 (...) | |
' .
'
' .
'' . I18N::translate('Date ranges are used to indicate that an event, such as a birth, happened on an unknown date within a possible range.') . '
' .
'' .
'| ' . I18N::translate('Date range') . ' | ' . I18N::translate('Format') . ' | ' . I18N::translate('Shortcut') . ' |
|---|
' .
'| ' . $dates['BET 1900 AND 1910'] . ' | BET 1900 AND 1910 | 1900-1910 |
' .
'| ' . $dates['AFT 1900'] . ' | AFT 1900 | >1900 |
' .
'| ' . $dates['BEF 1910'] . ' | BEF 1910 | <1910 |
' .
'| ' . $dates['BET JAN 1900 AND MAR 1900'] . ' | BET JAN 1900 AND MAR 1900 | Q1 1900 |
' .
'| ' . $dates['BET APR 1900 AND JUN 1900'] . ' | BET APR 1900 AND JUN 1900 | Q2 1900 |
' .
'| ' . $dates['BET JUL 1900 AND SEP 1900'] . ' | BET JUL 1900 AND SEP 1900 | Q3 1900 |
' .
'| ' . $dates['BET OCT 1900 AND DEC 1900'] . ' | BET OCT 1900 AND DEC 1900 | Q4 1900 |
' .
'
' .
'' . I18N::translate('Date periods are used to indicate that a fact, such as an occupation, continued for a period of time.') . '
' .
'' .
'| ' . I18N::translate('Date period') . ' | ' . I18N::translate('Format') . ' | ' . I18N::translate('Shortcut') . ' |
|---|
' .
'| ' . $dates['FROM 1900 TO 1910'] . ' | FROM 1900 TO 1910 | 1900~1910 |
' .
'| ' . $dates['FROM 1900'] . ' | FROM 1900 | 1900- |
' .
'| ' . $dates['TO 1910'] . ' | TO 1910 | -1900 |
' .
'
' .
'' . I18N::translate('Simple dates are assumed to be in the gregorian calendar. To specify a date in another calendar, add a keyword before the date. This keyword is optional if the month or year format make the date unambiguous.') . '
' .
'' .
'| ' . I18N::translate('Date') . ' | ' . I18N::translate('Format') . ' |
|---|
' .
'| ' . I18N::translate('Julian') . ' |
' .
'| ' . $dates['@#DJULIAN@ 14 JAN 1700'] . ' | @#DJULIAN@ 14 JAN 1700 |
' .
'| ' . $dates['@#DJULIAN@ 44 B.C.'] . ' | @#DJULIAN@ 44 B.C. |
' .
'| ' . $dates['@#DJULIAN@ 20 FEB 1742/43'] . ' | @#DJULIAN@ 20 FEB 1742/43 |
' .
'| ' . $dates['BET @#DJULIAN@ 01 SEP 1752 AND @#DGREGORIAN@ 30 SEP 1752'] . ' | BET @#DJULIAN@ 01 SEP 1752 AND @#DGREGORIAN@ 30 SEP 1752 |
' .
'| ' . I18N::translate('Jewish') . ' |
' .
'| ' . $dates['@#DHEBREW@ 5481'] . ' | @#DHEBREW@ 5481 |
' .
'| ' . $dates['@#DHEBREW@ TSH 5481'] . ' | @#DHEBREW@ TSH 5481 |
' .
'| ' . $dates['ABT @#DHEBREW@ CSH 5481'] . ' | ABT @#DHEBREW@ CSH 5481 |
' .
'| ' . $dates['BET @#DHEBREW@ KSL 5481 AND @#DHEBREW@ TVT 5481'] . ' | BET @#DHEBREW@ KSL 5481 AND @#DHEBREW@ TVT 5481 |
' .
'| ' . $dates['FROM @#DHEBREW@ SHV 5481 TO @#DHEBREW@ ADR 5481'] . ' | FROM @#DHEBREW@ SHV 5481 TO @#DHEBREW@ ADR 5481 |
' .
'| ' . $dates['AFT @#DHEBREW@ ADR 5481'] . ' | AFT @#DHEBREW@ ADR 5481 |
' .
'| ' . $dates['AFT @#DHEBREW@ ADS 5480'] . ' | AFT @#DHEBREW@ ADS 5480 |
' .
'| ' . $dates['BEF @#DHEBREW@ NSN 5481'] . ' | BEF @#DHEBREW@ NSN 5481 |
' .
'| ' . $dates['ABT @#DHEBREW@ IYR 5481'] . ' | ABT @#DHEBREW@ IYR 5481 |
' .
'| ' . $dates['FROM @#DHEBREW@ SVN 5481'] . ' | FROM @#DHEBREW@ SVN 5481 |
' .
'| ' . $dates['TO @#DHEBREW@ TMZ 5481'] . ' | TO @#DHEBREW@ TMZ 5481 |
' .
'| ' . $dates['EST @#DHEBREW@ AAV 5481'] . ' | EST @#DHEBREW@ AAV 5481 |
' .
'| ' . $dates['@#DHEBREW@ 03 ELL 5481'] . ' | @#DHEBREW@ 03 ELL 5481 |
' .
'| ' . I18N::translate('Hijri') . ' |
' .
'| ' . $dates['@#DHIJRI@ 1497'] . ' | @#DHIJRI@ 1497 |
' .
'| ' . $dates['@#DHIJRI@ MUHAR 1497'] . ' | @#DHIJRI@ MUHAR 1497 |
' .
'| ' . $dates['ABT @#DHIJRI@ SAFAR 1497'] . ' | ABT @#DHIJRI@ SAFAR 1497 |
' .
'| ' . $dates['BET @#DHIJRI@ RABIA 1497 AND @#DHIJRI@ RABIT 1497'] . ' | BET @#DHIJRI@ RABIA 1497 AND @#DHIJRI@ RABIT 1497 |
' .
'| ' . $dates['FROM @#DHIJRI@ JUMAA 1497 TO @#DHIJRI@ JUMAT 1497'] . ' | FROM @#DHIJRI@ JUMAA 1497 TO @#DHIJRI@ JUMAT 1497 |
' .
'| ' . $dates['AFT @#DHIJRI@ RAJAB 1497'] . ' | AFT @#DHIJRI@ RAJAB 1497 |
' .
'| ' . $dates['BEF @#DHIJRI@ SHAAB 1497'] . ' | BEF @#DHIJRI@ SHAAB 1497 |
' .
'| ' . $dates['ABT @#DHIJRI@ RAMAD 1497'] . ' | ABT @#DHIJRI@ RAMAD 1497 |
' .
'| ' . $dates['FROM @#DHIJRI@ SHAWW 1497'] . ' | FROM @#DHIJRI@ SHAWW 1497 |
' .
'| ' . $dates['TO @#DHIJRI@ DHUAQ 1497'] . ' | TO @#DHIJRI@ DHUAQ 1497 |
' .
'| ' . $dates['@#DHIJRI@ 03 DHUAH 1497'] . ' | @#DHIJRI@ 03 DHUAH 1497 |
' .
'| ' . I18N::translate('French') . ' |
' .
'| ' . $dates['@#DFRENCH R@ 12'] . ' | @#DFRENCH R@ 12 |
' .
'| ' . $dates['@#DFRENCH R@ VEND 12'] . ' | @#DFRENCH R@ VEND 12 |
' .
'| ' . $dates['ABT @#DFRENCH R@ BRUM 12'] . ' | ABT @#DFRENCH R@ BRUM 12 |
' .
'| ' . $dates['BET @#DFRENCH R@ FRIM 12 AND @#DFRENCH R@ NIVO 12'] . ' | BET @#DFRENCH R@ FRIM 12 AND @#DFRENCH R@ NIVO 12 |
' .
'| ' . $dates['FROM @#DFRENCH R@ PLUV 12 TO @#DFRENCH R@ VENT 12'] . ' | FROM @#DFRENCH R@ PLUV 12 TO @#DFRENCH R@ VENT 12 |
' .
'| ' . $dates['AFT @#DFRENCH R@ GERM 12'] . ' | AFT @#DFRENCH R@ GERM 12 |
' .
'| ' . $dates['BEF @#DFRENCH R@ FLOR 12'] . ' | BEF @#DFRENCH R@ FLOR 12 |
' .
'| ' . $dates['ABT @#DFRENCH R@ PRAI 12'] . ' | ABT @#DFRENCH R@ PRAI 12 |
' .
'| ' . $dates['FROM @#DFRENCH R@ MESS 12'] . ' | FROM @#DFRENCH R@ MESS 12 |
' .
'| ' . $dates['TO @#DFRENCH R@ THER 12'] . ' | TO @#DFRENCH R@ THER 12 |
' .
'| ' . $dates['EST @#DFRENCH R@ FRUC 12'] . ' | EST @#DFRENCH R@ FRUC 12 |
' .
'| ' . $dates['@#DFRENCH R@ 03 COMP 12'] . ' | @#DFRENCH R@ 03 COMP 12 |
' .
'
';
break;
case 'EMAI':
case 'EMAIL':
case 'EMAL':
case '_EMAIL':
$title = WT_Gedcom_Tag::getLabel('EMAIL');
$text = I18N::translate('Enter the email address.
An example email address looks like this: name@hotmail.com Leave this field blank if you do not want to include an email address.');
break;
case 'FAX':
$title = WT_Gedcom_Tag::getLabel('FAX');
$text = I18N::translate('Enter the FAX number including the country and area code.
Leave this field blank if you do not want to include a FAX number. For example, a number in Germany might be +49 25859 56 76 89 and a number in USA or Canada might be +1 888 555-1212.');
break;
case 'FORM':
$title = WT_Gedcom_Tag::getLabel('FORM');
$text = I18N::translate('This is an optional field that can be used to enter the file format of the media object. Some genealogy programs may look at this field to determine how to handle the item. However, since media do not transfer across computer systems very well, this field is not very important.');
break;
// This help text is used for all NAME components
case 'NAME':
$title = WT_Gedcom_Tag::getLabel('NAME');
$text =
'' .
I18N::translate('The name field contains the individual’s full name, as they would have spelled it or as it was recorded. This is how it will be displayed on screen. It uses standard genealogical annotations to identify different parts of the name.') .
'
' .
'- ' .
I18N::translate('The surname is enclosed by slashes: <%s>John Paul /Smith/<%s>', 'span style="color:#0000ff;"', '/span') .
'
- ' .
I18N::translate('If the surname is unknown, use empty slashes: <%s>Mary //<%s>', 'span style="color:#0000ff;"', '/span') .
'
- ' .
I18N::translate('If an individual has two separate surnames, both should be enclosed by slashes: <%s>José Antonio /Gómez/ /Iglesias/<%s>', 'span style="color:#0000ff;"', '/span') .
'
- ' .
I18N::translate('If an individual does not have a surname, no slashes are needed: <%s>Jón Einarsson<%s>', 'span style="color:#0000ff;"', '/span') .
'
- ' .
I18N::translate('If an individual was not known by their first given name, the preferred name should be indicated with an asterisk: <%s>John Paul* /Smith/<%s>', 'span style="color:#0000ff;"', '/span') .
'
- ' .
I18N::translate('If an individual was known by a nickname which is not part of their formal name, it should be enclosed by quotation marks. For example, <%s>John "Nobby" /Clark/<%s>.', 'span style="color:#0000ff;"', '/span') .
'
';
break;
case 'SURN':
$title = WT_Gedcom_Tag::getLabel('SURN');
$text = '' .
I18N::translate('The surname field contains a name that is used for sorting and grouping. It can be different to the individual’s actual surname which is always taken from the name field. This field can be used to sort surnames with or without a prefix (Gogh / van Gogh) and to group spelling variations or inflections (Kowalski / Kowalska). If an individual needs to be listed under more than one surname, each name should be separated by a comma.') .
'
';
break;
case 'NOTE':
$title = WT_Gedcom_Tag::getLabel('NOTE');
$text = I18N::translate('Notes are free-form text and will appear in the Fact Details section of the page.');
break;
case 'OBJE':
$title = WT_Gedcom_Tag::getLabel('OBJE');
$text =
'' .
I18N::translate('A media object is a record in the family tree which contains information about a media file. This information may include a title, a copyright notice, a transcript, privacy restrictions, etc. The media file, such as the photo or video, can be stored locally (on this webserver) or remotely (on a different webserver).') .
'
';
break;
case 'PAGE':
$title = WT_Gedcom_Tag::getLabel('PAGE');
$text = I18N::translate('In the citation details field you would enter the page number or other information that might help someone find the information in the source.');
break;
case 'PEDI':
$title = WT_Gedcom_Tag::getLabel('PEDI');
$text = I18N::translate('A child may have more than one set of parents. The relationship between the child and the parents can be biological, legal, or based on local culture and tradition. If no pedigree is specified, then a biological relationship will be assumed.');
break;
case 'PHON':
$title = WT_Gedcom_Tag::getLabel('PHON');
$text = I18N::translate('Enter the phone number including the country and area code.
Leave this field blank if you do not want to include a phone number. For example, a number in Germany might be +49 25859 56 76 89 and a number in USA or Canada might be +1 888 555-1212.');
break;
case 'PLAC':
$title = WT_Gedcom_Tag::getLabel('PLAC');
$text = I18N::translate('Places should be entered according to the standards for genealogy. In genealogy, places are recorded with the most specific information about the place first and then working up to the least specific place last, using commas to separate the different place levels. The level at which you record the place information should represent the levels of government or church where vital records for that place are kept.
For example, a place like Salt Lake City would be entered as “Salt Lake City, Salt Lake, Utah, USA”.
Let’s examine each part of this place. The first part, “Salt Lake City,” is the city or township where the event occurred. In some countries, there may be municipalities or districts inside a city which are important to note. In that case, they should come before the city. The next part, “Salt Lake,” is the county. “Utah” is the state, and “USA” is the country. It is important to note each place because genealogical records are kept by the governments of each level.
If a level of the place is unknown, you should leave a space between the commas. Suppose, in the example above, you didn’t know the county for Salt Lake City. You should then record it like this: “Salt Lake City, , Utah, USA”. Suppose you only know that an individual was born in Utah. You would enter the information like this: “, , Utah, USA”.
You can use the Find Place link to help you find places that already exist in the database.');
break;
case 'RELA':
$title = WT_Gedcom_Tag::getLabel('RELA');
$text = I18N::translate('Select a relationship name from the list. Selecting Godfather means: This associate is the godfather of the current individual.');
break;
case 'RESN':
$title = WT_Gedcom_Tag::getLabel('RESN');
$text =
I18N::translate('Restrictions can be added to records and/or facts. They restrict who can view the data and who can edit it.') .
'
' .
I18N::translate('Note that if a user account is linked to a record, then that user will always be able to view that record.');
break;
case 'ROMN':
$title = WT_Gedcom_Tag::getLabel('ROMN');
$text = I18N::translate('In many cultures it is customary to have a traditional name spelled in the traditional characters and also a romanized version of the name as it would be spelled or pronounced in languages based on the Latin alphabet, such as English.
If you prefer to use a non-Latin alphabet such as Hebrew, Greek, Russian, Chinese, or Arabic to enter the name in the standard name fields, then you can use this field to enter the same name using the Latin alphabet. Both versions of the name will appear in lists and charts.
Although this field is labeled “Romanized”, it is not restricted to containing only characters based on the Latin alphabet. This might be of use with Japanese names, where three different alphabets may occur.');
break;
case 'SEX':
$title = WT_Gedcom_Tag::getLabel('SEX');
$text = I18N::translate('Choose the appropriate gender from the drop-down list. The unknown option indicates that the gender is unknown.');
break;
case 'SHARED_NOTE':
$title = WT_Gedcom_Tag::getLabel('SHARED_NOTE');
$text = I18N::translate('Shared notes are free-form text and will appear in the Fact Details section of the page.
Each shared note can be linked to more than one individual, family, source, or event.');
break;
case 'SOUR':
$title = WT_Gedcom_Tag::getLabel('SOUR');
$text = I18N::translate('This field allows you to change the source record that this fact’s source citation links to. This field takes a source ID. Beside the field will be listed the title of the current source ID. Use the Find ID link to look up the source’s ID number. To remove the entire citation, make this field blank.');
break;
case 'STAT':
$title = WT_Gedcom_Tag::getLabel('STAT');
$text = I18N::translate('This is an optional status field and is used mostly for LDS ordinances as they are run through the TempleReady program.');
break;
case 'TEMP':
$title = WT_Gedcom_Tag::getLabel('TEMP');
$text = I18N::translate('For LDS ordinances, this field records the temple where it was performed.');
break;
case 'TEXT':
$title = WT_Gedcom_Tag::getLabel('TEXT');
$text = I18N::translate('In this field you would enter the citation text for this source. Examples of data may be a transcription of the text from the source, or a description of what was in the citation.');
break;
case 'TIME':
$title = WT_Gedcom_Tag::getLabel('TIME');
$text = I18N::translate('Enter the time for this event in 24-hour format with leading zeroes. Midnight is 00:00. Examples: 04:50 13:00 20:30.');
break;
case 'WWW':
$title = WT_Gedcom_Tag::getLabel('WWW');
$text = I18N::translate('Enter the URL address including the http://.
An example URL looks like this: http://www.webtrees.net/. Leave this field blank if you do not want to include a URL.');
break;
case '_HEB':
$title = WT_Gedcom_Tag::getLabel('_HEB');
$text = I18N::translate('In many cultures it is customary to have a traditional name spelled in the traditional characters and also a romanized version of the name as it would be spelled or pronounced in languages based on the Latin alphabet, such as English.
If you prefer to use the Latin alphabet to enter the name in the standard name fields, then you can use this field to enter the same name in the non-Latin alphabet such as Greek, Hebrew, Russian, Arabic, or Chinese. Both versions of the name will appear in lists and charts.
Although this field is labeled “Hebrew”, it is not restricted to containing only Hebrew characters.');
break;
case '_PRIM':
$title = WT_Gedcom_Tag::getLabel('_PRIM');
$text = I18N::translate('Use this field to signal that this media item is the highlighted or primary item for the individual it is attached to. The highlighted image is the one that will be used on charts and on the individual’s page.');
break;
//////////////////////////////////////////////////////////////////////////////
// This section contains an entry for every configuration item
//////////////////////////////////////////////////////////////////////////////
case 'CHECK_MARRIAGE_RELATIONS':
$title = I18N::translate('Check relationships by marriage');
$text = I18N::translate('When calculating relationships, this option controls whether webtrees will include spouses/partners as well as blood relatives.');
break;
case 'MAX_DESCENDANCY_GENERATIONS':
$title = I18N::translate('Maximum descendancy generations');
$text = I18N::translate('Set the maximum number of generations to display on descendancy charts.');
break;
case 'PEDIGREE_LAYOUT':
$title = /* I18N: A site configuration setting */ I18N::translate('Default pedigree chart layout');
$text = /* I18N: Help text for the “Default pedigree chart layout” tree configuration setting */ I18N::translate('This option indicates whether the pedigree chart should be generated in landscape or portrait mode.');
break;
case 'PEDIGREE_SHOW_GENDER':
$title = I18N::translate('Gender icon on charts');
$text = I18N::translate('This option controls whether or not to show the individual’s gender icon on charts.
Since the gender is also indicated by the color of the box, this option doesn’t conceal the gender. The option simply removes some duplicate information from the box.');
break;
case 'SHOW_EST_LIST_DATES':
$title = I18N::translate('Estimated dates for birth and death');
$text = I18N::translate('This option controls whether or not to show estimated dates for birth and death instead of leaving blanks on individual lists and charts for individuals whose dates are not known.');
break;
case 'SHOW_MEDIA_DOWNLOAD':
$title = I18N::translate('Show download link in media viewer');
$text = I18N::translate('The Media Viewer can show a link which, when clicked, will download the media file to the local PC.
You may want to hide the download link for security reasons.');
break;
case 'SHOW_PARENTS_AGE':
$title = I18N::translate('Show age of parents next to child’s birthdate');
$text = I18N::translate('This option controls whether or not to show age of father and mother next to child’s birthdate on charts.');
break;
case 'THUMBNAIL_WIDTH':
$title = I18N::translate('Width of generated thumbnails');
$text = I18N::translate('This is the width (in pixels) that the program will use when automatically generating thumbnails. The default setting is 100.');
break;
//////////////////////////////////////////////////////////////////////////////
// This section contains all the other help items.
//////////////////////////////////////////////////////////////////////////////
case 'add_facts':
$title = I18N::translate('Add a fact');
$text = I18N::translate('Here you can add a fact to the record being edited.
First choose a fact from the drop-down list, then click the Add button. All possible facts that you can add to the database are in that drop-down list.');
$text .= '
';
$text .= '' . I18N::translate('Add from clipboard') . '';
$text .= '
';
$text .= I18N::translate('webtrees allows you to copy up to 10 facts, with all their details, to a clipboard. This clipboard is different from the clippings cart that you can use to export portions of your database.
You can select any of the facts from the clipboard and copy the selected fact to the individual, family, media, source, or repository record currently being edited. However, you cannot copy facts of dissimilar record types. For example, you cannot copy a marriage fact to a source or an individual record since the marriage fact is associated only with family records.
This is very helpful when entering similar facts, such as census facts, for many individuals or families.');
break;
case 'add_note':
// This is a general help text for multiple pages
$title = I18N::translate('Add a new note');
$text = I18N::translate('If you have a note to add to this record, this is the place to do so.
Just click the link, a window will open, and you can type your note. When you are finished typing, just click the button below the box, close the window, and that’s all.');
break;
case 'add_shared_note':
// This is a general help text for multiple pages
$title = I18N::translate('Add a new shared note');
$text = I18N::translate('When you click the Add a new shared note link, a new window will open. You can choose to link to an existing shared note, or you can create a new shared note and at the same time create a link to it.');
break;
case 'add_source':
// This is a general help text for multiple pages
$title = I18N::translate('Add a new source citation');
$text = I18N::translate('Here you can add a source Citation to this record.
Just click the link, a window will open, and you can choose the source from the list (Find ID) or create a new source and then add the citation.
Adding sources is an important part of genealogy because it allows other researchers to verify where you obtained your information.');
break;
case 'annivers_year_select':
$title = I18N::translate('Year input box');
$text = I18N::translate('This input box lets you change that year of the calendar. Type a year into the box and press Enter to change the calendar to that year.
Advanced features for View year- More than one year
- You can search for dates in a range of years.
Year ranges are inclusive. This means that the date range extends from 1 January of the first year of the range to 31 December of the last year mentioned. Here are a few examples of year ranges:
1992-5 for all events from 1992 to 1995.
1972-89 for all events from 1972 to 1989.
1610-759 for all events from 1610 to 1759.
1880-1905 for all events from 1880 to 1905.
880-1105 for all events from 880 to 1105.
To see all the events in a given decade or century, you can use ? in place of the final digits. For example, 197? for all events from 1970 to 1979 or 16?? for all events from 1600 to 1699.
Selecting a range of years will change the calendar to the year view.
');
break;
case 'block_move_right':
$title = I18N::translate('Move list entries');
$text = I18N::translate('Use these buttons to move an entry from one list to another.
Highlight the entry to be moved, and then click a button to move or copy that entry in the direction of the arrow. Use the » and « buttons to move the highlighted entry from the leftmost to the rightmost list or vice-versa. Use the > and < buttons to move the highlighted entry between the Available blocks list and the list to its right or left.
The entries in the Available Blocks list do not change, regardless of what you do with the Move right and Move left buttons. This is so because the same block can appear several times on the same page. The HTML block is a good example of why you might want to do this.');
break;
case 'block_move_up':
$title = I18N::translate('Move list entries');
$text = I18N::translate('Use these buttons to re-arrange the order of the entries within the list. The blocks will be printed in the order in which they are listed.
Highlight the entry to be moved, and then click a button to move that entry up or down.');
break;
case 'download_gedcom':
$title = I18N::translate('Download family tree');
$text = I18N::translate('This option will download the family tree to a GEDCOM file on your computer.');
break;
case 'edit_add_ASSO':
$title = I18N::translate('Add a new associate');
$text = I18N::translate('Add a new associate allows you to link a fact with an associated individual in the website. This is one way in which you might record that someone was the godfather of another individual.');
break;
case 'edit_add_GEDFact_ASSISTED':
$title = I18N::translate('GEDFact shared note assistant');
$text = I18N::translate('Clicking the “+” icon will open the GEDFact shared note assistant window.
Specific help will be found there.
When you click the “save” button, the ID of the shared note will be pasted here.');
break;
case 'edit_add_NOTE':
$title = I18N::translate('Add a new note');
$text = I18N::translate('This section allows you to add a new note to the fact that you are currently editing. Notes are free-form text and will appear in the Fact Details section of the page.');
break;
case 'edit_add_SHARED_NOTE':
$title = I18N::translate('Add a new shared note');
$text = I18N::translate('Shared notes, like regular notes, are free-form text. Unlike regular notes, each shared note can be linked to more than one individual, family, source, or fact.
By clicking the appropriate icon, you can establish a link to an existing shared note or create a new shared note and at the same time link to it. If a link to an existing shared note has already been established, you can also edit that note’s contents.
- Link to an existing shared note
If you already know the ID number of the desired shared note, you can enter that number directly into the field.
When you click the Find shared note icon, you will be able to search the text of all existing shared notes and then choose one of them. The ID number of the chosen note will be entered into the field automatically.
You must click the Add button to update the original record.
- Create a new shared note
When you click the Create a new shared note icon, a new window will open. You can enter the text of the new note as you wish. As with regular notes, you can enter URLs.
When you click the Save button, you will see a message with the ID number of the newly created shared note. You should click on this message to close the editing window and also copy that new ID number directly into the ID number field. If you just close the window, the newly created ID number will not be copied automatically.
You must click the Add button to update the original record.
- Edit an existing shared note
When you click the Edit shared note icon, a new window will open. You can change the text of the existing shared note as you wish. As with regular notes, you can enter URLs.
When you click the Save button, the text of the shared note will be updated. You can close the window and then click the Save button again.
When you change the text of a shared note, your change will be reflected in all places to which that shared note is currently linked. New links that you establish after having made your change will also use the updated text.
');
if (array_key_exists('GEDFact_assistant', Module::getActiveModules())) {
$text .= '' . I18N::translate('You should avoid using the vertical line character “|” in your notes. It is used internally by webtrees and may cause your note to display incorrectly.') . '
';
}
break;
case 'edit_add_SOUR':
$title = I18N::translate('Add a new source citation');
$text = I18N::translate('This section allows you to add a new source citation to the fact that you are currently editing.
In the Source field you enter the ID for the source. Click the “Create a new source” link if you need to enter a new source. In the citation details field you would enter the page number or other information that might help someone find the information in the source. In the Text field you would enter the text transcription from the source.');
break;
case 'edit_edit_raw':
$title = I18N::translate('Edit raw GEDCOM');
$text =
I18N::translate('This page allows you to bypass the usual forms, and edit the underlying data directly. It is an advanced option, and you should not use it unless you understand the GEDCOM format. If you make a mistake here, it can be difficult to fix.') .
'
' .
/* I18N: %s is a URL */ I18N::translate('You can download a copy of the GEDCOM specification from %s.', 'http://wiki.webtrees.net/w/images-en/Ged551-5.pdf');
break;
case 'edit_merge':
$title = I18N::translate('Merge records');
$text = I18N::translate('This page will allow you to merge two GEDCOM records from the same GEDCOM file.
This is useful for individuals who have merged GEDCOMs and now have many individuals, families, and sources that are the same.
The page consists of three steps.
- You enter two GEDCOM IDs. The IDs must be of the same type. You cannot merge an individual and a family or family and source, for example.
In the Merge To ID: field enter the ID of the record you want to be the new record after the merge is complete.
In the Merge From ID: field enter the ID of the record whose information will be merged into the Merge To ID: record. This record will be deleted after the Merge. - You select what facts you want to keep from the two records when they are merged. Just click the checkboxes next to the ones you want to keep.
- You inspect the results of the merge, just like with all other changes made online.
Someone with Accept rights will have to authorize your changes to make them permanent.');
break;
case 'edit_SOUR_EVEN':
$title = I18N::translate('Associate events with this source');
$text = I18N::translate('Each source records specific events, generally for a given date range and for a place jurisdiction. For example a Census records census events and church records record birth, marriage, and death events.
Select the events that are recorded by this source from the list of events provided. The date should be specified in a range format such as FROM 1900 TO 1910. The place jurisdiction is the name of the lowest jurisdiction that encompasses all lower-level places named in this source. For example, “Oneida, Idaho, USA” would be used as a source jurisdiction place for events occurring in the various towns within Oneida County. “Idaho, USA” would be the source jurisdiction place if the events recorded took place not only in Oneida County but also in other counties in Idaho.');
break;
case 'export_gedcom':
$title = I18N::translate('Export family tree');
$text =
'' .
I18N::translate('This option will save the family tree to a GEDCOM file on the server.') .
'
' .
/* I18N: %s is a folder name */
I18N::translate('GEDCOM files are stored in the %s folder.', '' . WT_DATA_DIR . '') .
'
';
break;
case 'fambook_descent':
$title = I18N::translate('Descendant generations');
$text = I18N::translate('This value determines the number of descendant generations of the root individual that will be printed in hourglass format.');
break;
case 'fan_width':
$title = I18N::translate('Width');
$text = I18N::translate('Here you can change the diagram width from 50 percent to 300 percent. At 100 percent the output image is about 640 pixels wide.');
break;
case 'gedcom_news_archive':
$title = I18N::translate('View archive');
$text = I18N::translate('To reduce the height of the News block, the administrator has hidden some articles. You can reveal these hidden articles by clicking the View archive link.');
break;
case 'gedcom_news_flag':
$title = I18N::translate('Limit:');
$text = I18N::translate('Enter the limiting value here.
If you have opted to limit the news article display according to age, any article older than the number of days entered here will be hidden from view. If you have opted to limit the news article display by number, only the specified number of recent articles, ordered by age, will be shown. The remaining articles will be hidden from view.
Zeros entered here will disable the limit, causing all news articles to be shown.');
break;
case 'gedcom_news_limit':
$title = I18N::translate('Limit display by:');
$text = I18N::translate('You can limit the number of news articles displayed, thereby reducing the height of the GEDCOM News block.
This option determines whether any limits should be applied or whether the limit should be according to the age of the article or according to the number of articles.');
break;
case 'google_chart_surname':
$title = I18N::translate('Surname');
$text = I18N::translate('The number of occurrences of the specified name will be shown on the map. If you leave this field empty, the most common surname will be used.');
break;
case 'import_gedcom':
$title = I18N::translate('Import family tree');
$text =
'' .
I18N::translate('This option deletes all the genealogy data in your family tree and replaces it with data from a GEDCOM file on the server.') .
'
' .
/* I18N: %s is a folder name */
I18N::translate('GEDCOM files are stored in the %s folder.', '' . WT_DATA_DIR . '') .
'
';
break;
case 'include_media':
$title = I18N::translate('Include media (automatically zips files)');
$text = I18N::translate('Select this option to include the media files associated with the records in your clippings cart. Choosing this option will automatically zip the files during download.');
break;
case 'lifespan_chart':
$title = I18N::translate('Lifespans');
$text = I18N::translate('On this chart you can display one or more individuals along a horizontal timeline. This chart allows you to see how the lives of different individuals overlapped.
You can add individuals to the chart individually or by family groups by their IDs. The previous list will be remembered as you add more individuals to the chart. You can clear the chart at any time with the Clear chart button.
You can also add individuals to the chart by searching for them by date range or locality.');
break;
case 'next_path':
$title = I18N::translate('Find the next relationship path');
$text = I18N::translate('You can click this button to see whether there is another relationship path between the two individuals. Previously found paths can be displayed again by clicking the link with the path number.');
break;
case 'no_update_CHAN':
$title = I18N::translate('Do not update the “last change” record');
$text = I18N::translate('Administrators sometimes need to clean up and correct the data submitted by users. For example, they might need to correct the PLAC location to include the country. When administrators make such corrections, information about the original change is normally replaced. This may not be desirable.
When this option is selected, webtrees will retain the original change information instead of replacing it with that of the current session. With this option selected, administrators also have the ability to modify or delete the information associated with the original CHAN tag.');
break;
case 'pending_changes':
$title = I18N::translate('Pending changes');
$text =
'' .
I18N::translate('When you add, edit, or delete information, the changes are not saved immediately. Instead, they are kept in a “pending” area. These pending changes need to be reviewed by a moderator before they are accepted.') .
'
' .
I18N::translate('This process allows the site’s owner to ensure that the new information follows the site’s standards and conventions, has proper source attributions, etc.') .
'
' .
I18N::translate('Pending changes are only shown when your account has permission to edit. When you log out, you will no longer be able to see them. Also, pending changes are only shown on certain pages. For example, they are not shown in lists, reports, or search results.') .
'
';
if (Auth::isAdmin()) {
$text .=
'' .
I18N::translate('Each user account has an option to “automatically accept changes”. When this is enabled, any changes made by that user are saved immediately. Many administrators enable this for their own user account.') .
'
';
}
break;
case 'ppp_view_records':
$title = I18N::translate('View all records');
$text = I18N::translate('Clicking on this link will show you a list of all of the individuals and families that have events occurring in this place. When you get to the end of a place hierarchy, which is normally a town or city, the name list will be shown automatically.');
break;
case 'show_fact_sources':
$title = I18N::translate('Show all sources');
$text = I18N::translate('When this option is checked, you can see all source or note records for this individual. When this option is unchecked, source or note records that are associated with other facts for this individual will not be shown.');
break;
case 'show_spouse':
$title = I18N::translate('Show spouses');
$text = I18N::translate('By default this chart does not show spouses for the descendants because it makes the chart harder to read and understand. Turning this option on will show spouses on the chart.');
break;
case 'upload_gedcom':
$title = I18N::translate('Upload family tree');
$text = I18N::translate('This option deletes all the genealogy data in your family tree and replaces it with data from a GEDCOM file on your computer.');
break;
case 'upload_media':
$title = I18N::translate('Upload media files');
$text = I18N::translate('Upload one or more media files from your local computer. Media files can be pictures, video, audio, or other formats.');
break;
case 'upload_server_file':
$title = I18N::translate('Filename on server');
$text = I18N::translate('The media file you are uploading can be, and probably should be, named differently on the server than it is on your local computer. This is so because often the local filename has meaning to you but is much less meaningful to others visiting this website. Consider also the possibility that you and someone else both try to upload different files called “granny.jpg“.
In this field, you specify the new name of the file you are uploading. The name you enter here will also be used to name the thumbnail, which can be uploaded separately or generated automatically. You do not need to enter the filename extension (jpg, gif, pdf, doc, etc.)
Leave this field blank to keep the original name of the file you have uploaded from your local computer.');
break;
case 'upload_server_folder':
$title = I18N::translate('Folder name on server');
$text =
'' .
I18N::translate('If you have a large number of media files, you can organize them into folders and subfolders.') .
'
';
break;
case 'upload_thumbnail_file':
$title = I18N::translate('Thumbnail to upload');
$text = I18N::translate('Choose the thumbnail image that you want to upload. Although thumbnails can be generated automatically for images, you may wish to generate your own thumbnail, especially for other media types. For example, you can provide a still image from a video, or a photograph of the individual who made an audio recording.');
break;
case 'zip':
$title = I18N::translate('Zip clippings');
$text = I18N::translate('Select this option as to save your clippings in a ZIP file. For more information about ZIP files, please visit http://www.winzip.com.');
break;
default:
$title = I18N::translate('Help');
$text = I18N::translate('The help text has not been written for this item.');
break;
}
// This file is called by a getJSON call so return the data
// in correct format
header('Content-Type: application/json');
echo json_encode(array('title' => $title, 'content' => $text));