Difference between revisions of "Addon:TinyTafel"

From Gramps
Jump to: navigation, search
m (the default options dialog is not instructive. added a Custom Filtler)
 
(15 intermediate revisions by 3 users not shown)
Line 1: Line 1:
 
{{Third-party plugin}}
 
{{Third-party plugin}}
[[File:TinyTafel-ReportOptions-defaults-51.png|thumb|450px|right|Tiny Tafel - Report Options tab - defaults]]
+
[[File:TinyTafel-ReportOptions-filtered-51.png|thumb|373px|right|Tiny Tafel - Report Options tab - with custom filter]]
The {{man label|Tiny Tafel}} report (ListeEclair) provides a compact way of describing the main surnames found in a family genealogy, which can be read by humans and matched by computers using a Tafel Matching System.
+
The {{man label|Tiny Tafel}} report (ListeEclair) provides a compact way of listing the main surnames found in a place and showing what years those surnames were found in that place.  It helps Genealogists determine if they might have overlapping research materials that could be shared from a family genealogy database.
 +
== Usage ==
 +
[[File:TinyTafel-ReportOutput-51.png|thumb|200px|right|Tiny Tafel - Report Options tab - with Custom Place filter]]Select {{man menu|Reports > Text Reports > Tiny Tafel...}} to run the report.
  
== Usage ==
+
Use {{man label|Select using filter:}} to choose ''Entire Database'' or an existing Places category [[Gramps_{{man version}}_Wiki_Manual_-_Filters#Custom_Filters|custom filter]]. Place [[Gramps_{{man version}}_Wiki_Manual_-_Filters#Define_Filter_dialog|custom filters can be defined]] in the Place category view's Filter gramplet or from the {{man menu|Place Filter Editor}} option in the {{man menu|Edit}} menu.
Select {{man menu|Reports > Text Reports > Tiny Tafel...}} to run the report.
+
 
 +
You can narrow down the geographical locations of the list by using {{man label|Select places individually:}}
 +
 
 +
From the {{man label|Type of list:}} 
 +
* Tiny Tafel ''(default)''<br />
 +
Place Name:Surname:Begin Year:End Year
 +
* CousinGenWeb<br />
 +
Surname:Place Name
 +
 
 +
You can {{man label|[x] Include private data}} by default.
 +
 
 +
==Background==
 +
The concept was to catalog areas of interest in genealogical research collections. It was a compromise between rows which can be read by humans and those that can be automatically interpreted by computers using a Tafel Matching System.
 +
 
 +
This report in Gramps is not in the classic Tiny Tafel format. Rather, it is the same category of encouraging research collaboration. Objectives are collated in a form intended for sharing on the '''[https://www.genealogie.mu/?option=com_sppagebuilder&view=page&id=41 CousinsGenWeb]''', a French genealogy service circa 2012. The Report output is suitable for pasting into the body of an e-mail or posting to Social Networking Services. 
 +
 
 +
However, the filtering has limited utility. While you could filter to just the Places where a particular group of Ancestor resided, the report still returns rows with ALL surnames logged in those Places, in all eras. You cannot limit to all surnames you've recorded in each place while your Ancestors were also residents. Nor can you limit it to listing just the Surnames in one branch of the Tree.
 +
 
 +
The defaults (without any filters) generated a report running over 24 pages when using the [[Example.gramps|Example.gramps]] sample tree.  To winnow down to a single page sample report, an arbitrary custom filter was applied.  It uses a {{man label|[[Gramps_{{man version}}_Wiki_Manual_-_Filters#Places_Category_2|Places with a reference count of ''<11>'']]}} rule. ''This is a completely useless custom filter for any collaboration goal.  But it gave a predictably small report length.''
 +
 
 +
 
 +
{{man tip|The English report name uses Loan words from German and French|The term "tafel" is a German word meaning "Table". "Liste Eclair" is a French phrase meaning "Lighting List.}}
 +
 
 +
== What would comprise an original Tiny Tafel? ==
 +
<!--
 +
Jimmy D. Roberts (b. ~1940)
 +
 +
7325 Ortega Hills Dr.
 +
Jacksonville FL 32244-4631
 +
(904) 317-2768
 +
[http://sites.rootsweb.com/~jimrobsr/Reports/whatistinytafel.htm
 +
-->
 +
The following is summarized from the  2000 article ''What Is A Tiny Tafel Report?'' published on RootsWeb.com by Jimmy D. Roberts Sr.:
 +
 
 +
The ''Tiny-Tafel for Database Scope Indexing'' article was printed in the April-May-June 1986 issue (vol.5, no.4) of ''[https://lccn.loc.gov/85641390 Genealogical Computing]'' magazine (acquired by Ancestry in July 1886) authored by Paul Arthur Andereck 1928-2007, that magazine's editor. The [https://wikipedia.org/wiki/Tiny_Tafel Tiny Tafel] text file specification was developed by Commsoft in 1986. Originally, the <code>.tt</code> text file format had a header with submitter contact identification followed by a simple table of a [[Gramps_{{man version}}_Wiki_Manual_-_Gramplets#SoundEx|SoundEx code]] for the surname, beginning date, end date and the locality.
 +
 
 +
One of the driving forces in developing the tiny tafel was to implement a very standardized database that could compare tiny tafels and provide a report on matches. The '''Tafel Matching System''' was developed to do this. The original tiny tafel text files were intended for sharing with early online services and [https://wikipedia.org/wiki/Bulletin_board_system Bulletin Board Systems] (BBSes). The format evolved as the technology changed.  There were a number of bulletin boards around the country that had the Tafel Matching System installed.
 +
 
 +
<pre>
 +
N John Smith
 +
A 123 Any St.
 +
A Anytown, NY 12345
 +
T 212-555-1212
 +
 +
S www.example.com
 +
Z 3
 +
A160 1813*1850*AVERY\ Hampshire, England/Hampshire, England
 +
M635 1810*1850*MARTIN\ Armagh, Ireland/Grey County, Ontario, Canada
 +
S530 1920*1948*SMITH\ Brock, Saskatchewan, Canada/San Jose, CA, USA
 +
W 24 May 1997</pre>
 +
The SoundEx codes above are described: [https://rpwrhs.org/w/index.php?title=Soundex_Code_A160 A160] [https://rpwrhs.org/w/index.php?title=Soundex_Code_M635 M635] [https://rpwrhs.org/w/index.php?title=Soundex_Code_S530 S530] 
 +
 
 +
The format began with header lines. Headers contained some basic identification: the researcher's name (N), address (A), and telephone number (T). Following these required lines are optional lines.  They can include (S) giving more information about the communication system. For example, it could include an e-mail address and/or Web page address.
 +
 
 +
The optional lines are followed by a required line (Z), which gives the count of data lines. Those data lines follow (described below), and finally a closing line (W) with the freshness date for the file.
  
==History==
+
The data lines might contain:<table>
* Announcement Message [https://sourceforge.net/p/gramps/mailman/message/29001988/ 2012]
+
<tr><th align=right>data description</th><th>&bull;</th><th align=left>format</th></tr>
 +
<tr><td align=right>Soundex code for surname</td><th>&bull;</th><td>(4 characters)</td></tr>
 +
<tr><td align=right>Space delimiter</td><th>&bull;</th><td>(1 space)</td></tr>
 +
<tr><td align=right>Earliest ancestor birth year</td><th>&bull;</th><td>(4 numbers yyyy)</td></tr>
 +
<tr><td align=right>Ancestor interest level</td><th>&bull;</th><td>(1 character)</td></tr>
 +
<tr><td align=right>Latest descendant birth year</td><th>&bull;</th><td>(4 numbers yyyy)</td></tr>
 +
<tr><td align=right>Descendant interest level</td><th>&bull;</th><td>(1 character)</td></tr>
 +
<tr><td align=right>Surname</td><th>&bull;</th><td>(variable length)</td></tr>
 +
<tr><td align=right>\ Ancestor birth place</td><th>&bull;</th><td>(variable length)</td></tr>
 +
<tr><td align=right>/Descendant birth place</td><th>&bull;</th><td>(variable length)</td></tr>
 +
</table>
 +
== Release History==
 +
* Announcement Message [https://sourceforge.net/p/gramps/mailman/message/29001988/ 2012][https://sourceforge.net/p/gramps/mailman/message/29010638/] by Eric Doutreleau <[email protected]>
 
* Github code [https://github.com/gramps-project/addons-source/tree/master/ListeEclair ListeEclair]
 
* Github code [https://github.com/gramps-project/addons-source/tree/master/ListeEclair ListeEclair]
  
 
==See also==
 
==See also==
*[https://en.wikipedia.org/wiki/Tiny_Tafel Tiny Tafel] - Wikipedia
+
*[https://wikipedia.org/wiki/Tiny_Tafel Tiny Tafel] - Wikipedia
  
 
== Issues ==
 
== Issues ==

Latest revision as of 05:32, 8 January 2021

Gramps-notes.png

Please use carefully on data that is backed up, and help make it better by reporting any comments or problems to the author, or issues to the bug tracker
Unless otherwise stated on this page, you can download this plugin by following these instructions.
Please note that some Addons have prerequisites that need to be installed before they can be used.
This Addon/Plugin system is controlled by the Plugin Manager

Tiny Tafel - Report Options tab - with custom filter

The Tiny Tafel report (ListeEclair) provides a compact way of listing the main surnames found in a place and showing what years those surnames were found in that place. It helps Genealogists determine if they might have overlapping research materials that could be shared from a family genealogy database.

Usage

Tiny Tafel - Report Options tab - with Custom Place filter

Select Reports > Text Reports > Tiny Tafel... to run the report.

Use Select using filter: to choose Entire Database or an existing Places category custom filter. Place custom filters can be defined in the Place category view's Filter gramplet or from the Place Filter Editor option in the Edit menu.

You can narrow down the geographical locations of the list by using Select places individually:

From the Type of list:

  • Tiny Tafel (default)
Place Name:Surname:Begin Year:End Year
  • CousinGenWeb
Surname:Place Name

You can [x] Include private data by default.

Background

The concept was to catalog areas of interest in genealogical research collections. It was a compromise between rows which can be read by humans and those that can be automatically interpreted by computers using a Tafel Matching System.

This report in Gramps is not in the classic Tiny Tafel format. Rather, it is the same category of encouraging research collaboration. Objectives are collated in a form intended for sharing on the CousinsGenWeb, a French genealogy service circa 2012. The Report output is suitable for pasting into the body of an e-mail or posting to Social Networking Services.

However, the filtering has limited utility. While you could filter to just the Places where a particular group of Ancestor resided, the report still returns rows with ALL surnames logged in those Places, in all eras. You cannot limit to all surnames you've recorded in each place while your Ancestors were also residents. Nor can you limit it to listing just the Surnames in one branch of the Tree.

The defaults (without any filters) generated a report running over 24 pages when using the Example.gramps sample tree. To winnow down to a single page sample report, an arbitrary custom filter was applied. It uses a Places with a reference count of <11> rule. This is a completely useless custom filter for any collaboration goal. But it gave a predictably small report length.


Tango-Dialog-information.png
The English report name uses Loan words from German and French

The term "tafel" is a German word meaning "Table". "Liste Eclair" is a French phrase meaning "Lighting List.


What would comprise an original Tiny Tafel?

The following is summarized from the 2000 article What Is A Tiny Tafel Report? published on RootsWeb.com by Jimmy D. Roberts Sr.:

The Tiny-Tafel for Database Scope Indexing article was printed in the April-May-June 1986 issue (vol.5, no.4) of Genealogical Computing magazine (acquired by Ancestry in July 1886) authored by Paul Arthur Andereck 1928-2007, that magazine's editor. The Tiny Tafel text file specification was developed by Commsoft in 1986. Originally, the .tt text file format had a header with submitter contact identification followed by a simple table of a SoundEx code for the surname, beginning date, end date and the locality.

One of the driving forces in developing the tiny tafel was to implement a very standardized database that could compare tiny tafels and provide a report on matches. The Tafel Matching System was developed to do this. The original tiny tafel text files were intended for sharing with early online services and Bulletin Board Systems (BBSes). The format evolved as the technology changed. There were a number of bulletin boards around the country that had the Tafel Matching System installed.

 	N	John Smith
 	A	123 Any St.
 	A	Anytown, NY 12345
 	T	212-555-1212
 	S	[email protected]
 	S	www.example.com
 	Z	3
 	A160	1813*1850*AVERY\ Hampshire, England/Hampshire, England
 	M635	1810*1850*MARTIN\ Armagh, Ireland/Grey County, Ontario, Canada
 	S530	1920*1948*SMITH\ Brock, Saskatchewan, Canada/San Jose, CA, USA
 	W	24 May 1997

The SoundEx codes above are described: A160 M635 S530

The format began with header lines. Headers contained some basic identification: the researcher's name (N), address (A), and telephone number (T). Following these required lines are optional lines. They can include (S) giving more information about the communication system. For example, it could include an e-mail address and/or Web page address.

The optional lines are followed by a required line (Z), which gives the count of data lines. Those data lines follow (described below), and finally a closing line (W) with the freshness date for the file.

The data lines might contain:

data descriptionformat
Soundex code for surname(4 characters)
Space delimiter(1 space)
Earliest ancestor birth year(4 numbers yyyy)
Ancestor interest level(1 character)
Latest descendant birth year(4 numbers yyyy)
Descendant interest level(1 character)
Surname(variable length)
\ Ancestor birth place(variable length)
/Descendant birth place(variable length)

Release History

See also

Issues

  • Need to swap English to be main translation language
  • help button goes to wrong page
  • Warning messages