Changes

Jump to navigation Jump to search
1,764 bytes added ,  05:49, 8 May 2018
Line 3: Line 3:  
| mod_summary    = A more general verbal description of a relationship. Has support for a number of European languages
 
| mod_summary    = A more general verbal description of a relationship. Has support for a number of European languages
 
| mod_validation  =  
 
| mod_validation  =  
|  download_link  = download_link  =  [http://mossfamilytree.info/download.php?mod=relate&version=11.0.0.1c 11.0.0.1c]  for {{Tv110}} <hr />[http://mossfamilytree.info/download.php?mod=relate&version=10.1.3.1c 10.1.3.1c] for {{Tv1013}}
+
| mod_last_update = 29 Jun 2016
 +
|  download_link  = download_link  =  [http://mossfamilytree.info/download.php?mod=relate&version=11.0.0.2a 11.0.0.2a]  for {{Tv110}} <hr />[http://mossfamilytree.info/download.php?mod=relate&version=10.1.3.2a 10.1.3.2a] for {{Tv1013}}
 
   
 
   
 
| download_stats  = [http://mossfamilytree.info/downloadstats.php?mod=relate show]
 
| download_stats  = [http://mossfamilytree.info/downloadstats.php?mod=relate show]
Line 10: Line 11:  
| mod_support    = contact author
 
| mod_support    = contact author
 
| mod_contact    = author
 
| mod_contact    = author
| mod_version    = 11.0.0.1
+
| mod_version    = 11.0.0.2a
 
| min_TNG_ver    = 10.1
 
| min_TNG_ver    = 10.1
| max_TNG_ver    = 11.0
+
| max_TNG_ver    = 11.0.2
 
| TNG_file_list  = getperson.php, familychart.php, customconfig.php
 
| TNG_file_list  = getperson.php, familychart.php, customconfig.php
 
| related_mods    =
 
| related_mods    =
Line 18: Line 19:  
}}
 
}}
 
This mod puts a row or a button on several pages and charts in TNG which allows a person easily to check the relationship of an individual to an anchor person on the tree. This can include any reachable person in the database, and it is also possible to restrict the tree to purely genetic relationships. It can handle variations in genealogical terminology in 7 European languages.
 
This mod puts a row or a button on several pages and charts in TNG which allows a person easily to check the relationship of an individual to an anchor person on the tree. This can include any reachable person in the database, and it is also possible to restrict the tree to purely genetic relationships. It can handle variations in genealogical terminology in 7 European languages.
 +
 +
Install the mod in the usual way using the [[Mod Manager]]. From v2 it is important to clear the cache after installation as additions are made to a style sheet.
    
A graphical representation of the relationship is planned.
 
A graphical representation of the relationship is planned.
Line 28: Line 31:  
[[File:david_relate_adam.png|Example of the Relate mod in action]]
 
[[File:david_relate_adam.png|Example of the Relate mod in action]]
   −
On the line under the relationship there is an option to "Make this person the anchor", which will be used in future queries and continue until the end of the session or the anchor being reset (another option). There is also an option to "Show only genetic" relations which restricts the search to blood relations and excludes all marriages and also adoptive and similar relationships.
+
At the right hand side is a "more" button with a dropdown list with several options, including one to "Make this person the anchor", which will be used in future queries and continue until the end of the session or the anchor being reset (another option). There is also an option to "Show only genetic" relations which restricts the search to blood relations and excludes all marriages and also adoptive and similar relationships.
 
[[File:David family.png|thumb|right|350px|On family chart, with genetic set]]
 
[[File:David family.png|thumb|right|350px|On family chart, with genetic set]]
Clicking on the up-arrow or the icon will close the relationship display.
+
Clicking on the up-arrow or the icon will close the relationship display.  
   −
Relationships are shown by default with three relational clauses per sentence. Relations involving "removed" cousins are expressed as for instance, "the daughter of the cousin of" or "the cousin of the father of" as this is less obscure, doesn't represent very different relationships as the same and is also easier to translate into other languages.  
+
Relationships are shown by default with three relational clauses per sentence. Relations involving "removed" cousins are expressed as for instance, "the daughter of x, who is the cousin of y" or "the cousin of x, who is the father of" as this is less obscure, doesn't represent very different relationships as the same and is also easier to translate into other languages.  
    
A limit of 24 steps for the search is initially assumed which should cover many databases and has so far not yielded too much usage on the server. The search is only done when the user clicks the button, in order not to incur an overhead when it is not needed. The limit can be changed by a parameter in the mod manager. The search is a bidirectional breadth-first search, so that if either end of the search is isolated in the tree it will not waste too much time and the user is informed which end of the search failed. It also means that it doesn't take more than half of those steps in either direction, so the maximum time is equivalent to only 12 steps on a single direction search which the built-in search uses. If you have only a few thousand people in the tree then it may be ok to increase this up to 50 or 80. But if it's 100,000 then the default is more sensible.
 
A limit of 24 steps for the search is initially assumed which should cover many databases and has so far not yielded too much usage on the server. The search is only done when the user clicks the button, in order not to incur an overhead when it is not needed. The limit can be changed by a parameter in the mod manager. The search is a bidirectional breadth-first search, so that if either end of the search is isolated in the tree it will not waste too much time and the user is informed which end of the search failed. It also means that it doesn't take more than half of those steps in either direction, so the maximum time is equivalent to only 12 steps on a single direction search which the built-in search uses. If you have only a few thousand people in the tree then it may be ok to increase this up to 50 or 80. But if it's 100,000 then the default is more sensible.
Line 88: Line 91:  
Literal translations of the English relationship terms are misleading in many languages. For example, a 2nd cousin in English is called a 3rd cousin in Nordic languages (counting from the common ancestor). Norwegian also has a separate word for "great grandfather" and generations before this count from there. A different distinction occurs in Portuguese where the word that represents the closeness of a cousin relationship follows the main noun and also must agree with it in gender.
 
Literal translations of the English relationship terms are misleading in many languages. For example, a 2nd cousin in English is called a 3rd cousin in Nordic languages (counting from the common ancestor). Norwegian also has a separate word for "great grandfather" and generations before this count from there. A different distinction occurs in Portuguese where the word that represents the closeness of a cousin relationship follows the main noun and also must agree with it in gender.
   −
These language-specific changes are represented in the cust_text.php file for each language by a separate array called "$text-settings". The value of this is itself an array of values which allow the mod to represent the name of a relationship according to the rules of that language. This array can be extended in future versions of this mod to take account of the structure of languages not yet handled properly.
+
These language-specific changes are represented in the cust_text.php file for each language by a separate array called "$text_settings". The value of this is itself an array of values which allow the mod to represent the name of a relationship according to the rules of that language. This array can be extended in future versions of this mod to take account of the structure of languages not yet handled properly.
    
The relationships for more distant grandparents, grandchildren etc. are generally represented by a "2 x" notation which is understandable when "2 x great" stands for "great great" but is not so obvious a representation for "second cousin". So the mod uses ordinals for cousin relationships up to a limit defined in the settings array and more distant relations are given as "6th cousin" etc. Relationship terms which don't have wide coverage in other European languages, such as "step-cousin", or "second cousin 3 x removed" are not used.
 
The relationships for more distant grandparents, grandchildren etc. are generally represented by a "2 x" notation which is understandable when "2 x great" stands for "great great" but is not so obvious a representation for "second cousin". So the mod uses ordinals for cousin relationships up to a limit defined in the settings array and more distant relations are given as "6th cousin" etc. Relationship terms which don't have wide coverage in other European languages, such as "step-cousin", or "second cousin 3 x removed" are not used.
Line 183: Line 186:  
| [http://www.katiandgraham.com/genealogy Chamberlain & Eidenbenz Genealogy]
 
| [http://www.katiandgraham.com/genealogy Chamberlain & Eidenbenz Genealogy]
 
| [[User:hiraeth|Graham Chamberlain]]
 
| [[User:hiraeth|Graham Chamberlain]]
|  
+
| Public site
| 11.0.0.1c/11.0.1
+
| 11.0.0.2/11.0.1
 
| EN,NL,FR,DE,ES
 
| EN,NL,FR,DE,ES
 
|-
 
|-
Line 190: Line 193:  
| [[User:Pingo|Ingo Wagner]]
 
| [[User:Pingo|Ingo Wagner]]
 
| Not a public site.
 
| Not a public site.
| 11.0.0.1c/11.0.1
+
| 11.0.0.2a/11.0.1
 
| EN, DE,FR,NO
 
| EN, DE,FR,NO
 
|-
 
|-
Line 199: Line 202:  
| DA, EN
 
| DA, EN
 
|-
 
|-
| [http://www.kmtrees.com Roots & Relatives Remembered]
+
| [https://www.kmtrees.com Roots & Relatives Remembered]
 
| [[User:Tngrlkrz|Ron Krzmarzick]]
 
| [[User:Tngrlkrz|Ron Krzmarzick]]
| Quasi-Public site.
+
| Public & Private
| 11.0.0.1c/11.0.1
+
| 11.0.0.2a/11.1.2
| EN
+
| EN,DE,CS,ES
 
|-
 
|-
 
| [http://www.reventlow.dk Slægten Reventlow]
 
| [http://www.reventlow.dk Slægten Reventlow]
Line 222: Line 225:  
| 10.1.3 / 10.1.3
 
| 10.1.3 / 10.1.3
 
| SE, EN, DE
 
| SE, EN, DE
 +
|-
 +
| [http://www.luithlenfamilie.de Luithlenfamilie]
 +
| [[User:pingo|Ingo Wagner]]
 +
| Not a Public site
 +
| 11.0.0.2a / 11.1.2
 +
| DE, EN, NO, FR
 
|-
 
|-
 
| [http://craxford-family.co.uk  The Extended Craxford Genealogy Website]
 
| [http://craxford-family.co.uk  The Extended Craxford Genealogy Website]
Line 229: Line 238:  
| EN  
 
| EN  
 
|-
 
|-
| [http://www.royandboucher.com/tng/  Our Roy and Boucher Family]
+
| [https://www.royandboucher.com/tng/  Our Roy and Boucher Family]
 
| [[User:Ken Roy|Ken Roy]]
 
| [[User:Ken Roy|Ken Roy]]
 
| Public site using template 4.
 
| Public site using template 4.
| 11.0.0.1c / 11.0.1
+
| 11.0.0.2a / 11.0.2
 
| EN, FR
 
| EN, FR
  |}
+
|-
 +
| [http://heuser.pro.br/gen.php Brazilian-German genealogies]
 +
| [[User:Carheu|Carlos Heuser]]
 +
| Public site
 +
| 11.0.0.2 / 11.0.1
 +
| EN, DE, PT-BR
 +
|-
 +
| [http://www.duttongenealogy.com  The Dutton's of Vermont]
 +
| [[User:darrin65|Darrin Dutton]]
 +
| Public site
 +
| 11.0.0.2 / 11.0.2
 +
| EN
 +
|-
 +
| [http://www.bussiererobinsonfamily.ca Bussiere, Robinson, Gingras Website]
 +
| [[User:Brian Bussiere|Brian Bussiere]]
 +
| Public site
 +
| 10.1.3.2a / 10.1.3
 +
| English, French
 +
|-
 +
| [http://mijnstamboom.net  Genealogy Family Smit - Kamp]
 +
| [[User:Netnoord|Bert Smit]]
 +
| Public site
 +
| 11.0.0.2a / 11.1
 +
| NL, EN, DE, DA
 +
|-
 +
| [http://racine-ad.fr/TNG/index.php Racine d'Alsace]
 +
| J-Louis Valory
 +
| Public/Private - Template 1
 +
| 11.0.0.2a - 11.1.1
 +
| French
 +
|-
 +
| [https://roeljongman.nl Stamboom Jongman]
 +
| [[User:Roelj|Roel Jongman]]
 +
| Public/Private site
 +
| 10.1.3.2a
 +
| 10.1.3
 +
| NL, DE, EN
 +
|-
 +
| [https://martius-familie.de Martius Family History]
 +
| [[User:Hemar|Hendrik Martius]]
 +
| Half-Public site - Template 12
 +
| 11.0.0.2a / 11.0.2
 +
| DE, FR, EN, NL
 +
|-
 +
| [http://graham-clan.co.uk/thefamilytree/index.php The Grahams of Helensburgh]
 +
| [[User:Fruin|Jim Graham]]
 +
| Public/Private
 +
| 11.0.0.2a / 12.0
 +
| English
 +
|}
    
==Revision History==
 
==Revision History==
{|
+
{| border="0" cellspacing="1" cellpadding="2" class="wikitable"
 
!Version
 
!Version
 
!Date
 
!Date
Line 249: Line 307:  
| 2 Aug 2016
 
| 2 Aug 2016
 
|  
 
|  
* Replaced links at bottom of row with a single dropdown button on the right
+
* Replaced links at bottom of row with a single dropdown button on the right, which now appears on all outputs
 
* Compatibility with Expand all/Collapse all feature
 
* Compatibility with Expand all/Collapse all feature
 
* Intermediate names added to some relationships where they were not used
 
* Intermediate names added to some relationships where they were not used
* Bug where second half cousin showed as third half cousin corrected
+
* Fixed bugs with second half cousin showed as third half cousin and one with generation limit
 
* Used case-insensitive comparisons for ids and tree ids
 
* Used case-insensitive comparisons for ids and tree ids
 
|}
 
|}
   −
==Known problems==
+
===Known problems===
* Half cousins currently show up as one more than they should. i.e. a second half cousin shows as a third half cousin. This will be corrected shortly.
+
* None current
    
==External References==
 
==External References==
 
Useful reference mainly from wikis for genealogical terms in different languages. If you don't speak the language, use the Chrome browser for easier understanding.
 
Useful reference mainly from wikis for genealogical terms in different languages. If you don't speak the language, use the Chrome browser for easier understanding.
 
* German: [https://de.wikipedia.org/wiki/Verwandtschaftsbeziehung Family relationships] and [https://de.wikipedia.org/wiki/Generationsbezeichnungen generations]
 
* German: [https://de.wikipedia.org/wiki/Verwandtschaftsbeziehung Family relationships] and [https://de.wikipedia.org/wiki/Generationsbezeichnungen generations]
* Dutch: [https://nl.wikipedia.org/wiki/Familie_(verwanten) Families] and [https://nl.wikipedia.org/wiki/Lijst_van_benamingen_voor_generaties generations]
+
* Dutch: [https://nl.wikipedia.org/wiki/Familie_(verwanten) Families] and [https://nl.wikipedia.org/wiki/Lijst_van_benamingen_voor_generaties generations] [https://www.dutchgenealogy.nl/dutch-terms-for-family-relationships/ Dutch terms]
 
* Danish: [http://www.slaegtogdata.dk/vaerktoejer/slaegtskab Relationship names] by Svend-Erik Christiansen
 
* Danish: [http://www.slaegtogdata.dk/vaerktoejer/slaegtskab Relationship names] by Svend-Erik Christiansen
 
* Swedish: [http://wiki.genealogi.se/index.php/Sl%C3%A4ktskapsrelation Relationships]
 
* Swedish: [http://wiki.genealogi.se/index.php/Sl%C3%A4ktskapsrelation Relationships]
* French: [http://www.geneafrance.org/rubrique.php?page=parente Kinship terms]
+
* French: [http://www.geneafrance.org/rubrique.php?page=parente Kinship terms] [https://www.thoughtco.com/la-famille-french-family-vocabulary-1368103 La famille]
 
* English: [https://en.wikipedia.org/wiki/Family Family], [https://en.wikipedia.org/wiki/Cousin Cousin]
 
* English: [https://en.wikipedia.org/wiki/Family Family], [https://en.wikipedia.org/wiki/Cousin Cousin]
 
* Spanish: [https://es.wikipedia.org/wiki/Anexo:Nomenclatura_de_parentesco_en_espa%C3%B1ol Kinship Nomenclature]
 
* Spanish: [https://es.wikipedia.org/wiki/Anexo:Nomenclatura_de_parentesco_en_espa%C3%B1ol Kinship Nomenclature]
130

edits

Navigation menu