Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
how_to:narrative_report_fact_sentence_templates [2020/01/16 14:00]
tatewise
how_to:narrative_report_fact_sentence_templates [2020/05/22 20:24] (current)
tatewise [Introduction]
Line 2: Line 2:
  
 {{entry>​Customisation/​Fact Types;See Index for related topics}} {{entry>​Customisation/​Fact Types;See Index for related topics}}
 +{{entry>​Customisation/​Fact Witnesses;​-*}}
 +{{entry>​Customisation/​Sentence Templates;​-*}}
 +{{entry>​Customisation/​Witness Roles;-*}}
 {{entry>​Fact Types/​Customisation;​-*}} {{entry>​Fact Types/​Customisation;​-*}}
 +{{entry>​Fact Witnesses/​Customisation;​-*}}
 +{{entry>​Narrative Report/​Sentence Templates;​-*}}
 +{{entry>​Report Window/​Narrative Report/​Sentence Templates;​-*}}
 +{{entry>​Sentence Templates/​Customisation;​-*}}
 +{{entry>​Witness Roles/​Customisation;​-*}}
  
 ===== Introduction ===== ===== Introduction =====
Line 12: Line 20:
 If **Custom Facts** are imported from other products there may be no associated **Sentence Template** as there is no **Fact Definition**,​ so follow the advice in [[Glossary:​Work with Fact Sets]] under **Custom Facts from other Products**. If **Custom Facts** are imported from other products there may be no associated **Sentence Template** as there is no **Fact Definition**,​ so follow the advice in [[Glossary:​Work with Fact Sets]] under **Custom Facts from other Products**.
  
-[[Glossary:​Family Historian]] ({{fh}}) **V6** added a special custom **Fact Set** primarily for **FTM** migrants, but it can be used by anyone. Select the **Extended Set** from the **Fact Set** drop list, and follow the popup instructions ​to reveal its details.+[[Glossary:​Family Historian]] ({{fh}}) **V6** added a special custom **Fact Set** primarily for **FTM** migrants, but it can be used by anyone. Select the [[Glossary:​Work with Fact Sets#Custom Facts from other Products|Extended Set]] from the **Fact Set** drop list, and tick **Show Hidden** ​to reveal its details.
  
 ===== Finding Sentence Templates ===== ===== Finding Sentence Templates =====
Line 36: Line 44:
 {{ narrative_report_sentence_defaults.png?​700 |Default Sentence Templates}} {{ narrative_report_sentence_defaults.png?​700 |Default Sentence Templates}}
  
-**Tip:** If you intend to extensively modify the default **Sentence Template** definitions for many **Facts**, ​then it is advisable to use the **Fact Sets** button and **Clone** the appropriate ​fact set, especially the **Standard** set. That allows ​the two alternative definition styles to be easily swapped via the **Fact Set** priority order. ​Such scenarios could include creating a fact list style or a foreign language style.+**Tip:​** ​Such fact definition scenarios could include creating a fact list style or a foreign language style as alternatives to the default style. ​If you intend to extensively modify the default **Sentence Template** definitions for many **Facts**, it is advisable to use the **Fact Sets** button and **Clone** the chosen ​fact set, especially the **Standard** set. That allows ​any alternative definition styles to be easily swapped via the **Fact Set** priority order. ​Only the highest priority **Fact Set** will list its definitions,​ and its clones will appear to have **No Events ​or Attributes** unless **Show Hidden** is ticked to reveal their **<​eclipsed>​ <​disabled>​** definitions.
  
 ==== Specific Fact Sentences ==== ==== Specific Fact Sentences ====
Line 103: Line 111:
  
 This mimics the [[Glossary:​Individual Summary Report]] tabulated style, and can be applied to most fact and witness templates. Explicit tab & space characters can follow the colon ('':''​) on each new line, such that the text is neatly tabulated in the report. The number of tab characters may need adjusting for each line, or could be omitted altogether. The new paragraph ''<​para>''​ code is best located at the end of every template.\\ This mimics the [[Glossary:​Individual Summary Report]] tabulated style, and can be applied to most fact and witness templates. Explicit tab & space characters can follow the colon ('':''​) on each new line, such that the text is neatly tabulated in the report. The number of tab characters may need adjusting for each line, or could be omitted altogether. The new paragraph ''<​para>''​ code is best located at the end of every template.\\
-//​Template://​ ''​{label}:​ {date:​Compact} {age} {value} {place}.%%<<​br>​%%Address:​ {address}.>​%%<<​br>​%%Notes:​ {note}><​para>''​\\ +//​Template://​\\ 
-//​Sentence://​ {{liststylesentence.png?​350|Sentence}}+''​{label}:​ {date:​Compact} {age} {value} {place}.%%<<​br>​%%Address:​ {address}.>​%%<<​br>​%%Notes:​ {note}><​para>''​\\ 
 +//​Sentence://​\\ 
 +{{liststylesentence.png?​350|Sentence}}
  
 //Tip:// To enter a tab character into a **Sentence Template** box use the **Ctrl+Tab** keys. //Tip:// To enter a tab character into a **Sentence Template** box use the **Ctrl+Tab** keys.
Line 120: Line 130:
 This style caters for the **1939 National Register** and relies on the full address being in the **Place** field. This style caters for the **1939 National Register** and relies on the full address being in the **Place** field.
  
-//​Template://​ ''​{individual} appeared in the {=TextIf(GetDisplayText(%FACT.DATE%,​min) = "29 September 1939","​National Register","​Census"​)} {date} residing at {_place} {age}<​br>''​\\ +//​Template://​\\ 
-//​Sentence://​ ''​He appeared in the Census on 31 March 1901 residing at 48, Springfield, Oxford, England aged 48.''​\\ +''​{individual} appeared in the\\ 
-//​Sentence://​ ''​He appeared in the National Register on 29 September 1939 residing at 5, High Rd, Oxford, England.''​+ {=TextIf(GetDisplayText(%FACT.DATE%,​min) = "29 September 1939","​National Register","​Census"​)}\\ 
 + {date} residing at {_place} {age}<​br>''​\\ 
 +//​Sentence://​\\ 
 +''​He appeared in the Census on 31 March 1901 residing at 8 Main St, Oxford, England aged 48.''​\\ 
 +//​Sentence://​\\ 
 +''​He appeared in the National Register on 29 September 1939 residing at 5, High Rd, Oxford, England.''​
  
 Similarly for the **Census (family) Event**: Similarly for the **Census (family) Event**:
  
-//​Template://​ ''​{couple} appeared in the {=TextIf(GetDisplayText(%FACT.DATE%,​min) = "29 September 1939","​National Register","​Census"​)} {date} residing at {_place} {their ages}<​br>''​\\ +//​Template://​\\ 
-//​Sentence://​ ''​They appeared in the Census on 31 March 1901 residing at 48, Springfield, Oxford, England when he was 34 and she was 31.''​+''​{couple} appeared in the\\ 
 + {=TextIf(GetDisplayText(%FACT.DATE%,​min) = "29 September 1939","​National Register","​Census"​)}\\ 
 + {date} residing at {_place} {their ages}<​br>''​\\ 
 +//​Sentence://​\\ 
 +''​They appeared in the Census on 31 March 1901 residing at 8 Main St, Oxford, England when he was 34 and she was 31.''​
  
 ==== Birth & Baptism Events ==== ==== Birth & Baptism Events ====
Line 135: Line 154:
 The relationship is excluded if the person is the **File Root**, and also if a child of the **File Root** as those sentences already mention their son/​daughter relationship by default. The relationship is excluded if the person is the **File Root**, and also if a child of the **File Root** as those sentences already mention their son/​daughter relationship by default.
  
-//​Template://​ ''​{individual} was born< {date}><​ {place}><​ ({age})>​{=CombineText( Text( " and is " . FileRoot() . "'​s "), TextIf(IsSameItem(FileRoot(),​%CUR_PRIN%) or IsSameItem(FileRoot(),​%CUR_PRIN.~FATH>​%) or IsSameItem(FileRoot(),​%CUR_PRIN.~MOTH>​%),​ "",​ Relationship(FileRoot(),​%CUR_PRIN%,​TEXT,​1) ) )}''​\\ +//​Template://​\\ 
-//​Sentence://​ ''​He was born on 1 May 1900 in London and is John Smith'​s grandfather.''​+''​{individual} was born< {date}><​ {place}><​ ({age})>​{=CombineText( Text( " and is " . FileRoot() . "'​s "),\\ 
 + TextIf(IsSameItem(FileRoot(),​%CUR_PRIN%) or IsSameItem(FileRoot(),​%CUR_PRIN.~FATH>​%) or\\ 
 + IsSameItem(FileRoot(),​%CUR_PRIN.~MOTH>​%),​ "",​ Relationship(FileRoot(),​%CUR_PRIN%,​TEXT,​1) ) )}''​\\ 
 +//​Sentence://​\\ 
 +''​He was born on 1 May 1900 in London and is John Smith'​s grandfather.''​
  
 This **Baptism Event** template adds the relationship when no **Birth Event**. This **Baptism Event** template adds the relationship when no **Birth Event**.
  
-//​Template://​ ''​{individual} was baptised<​ {date}><​ {place}><​ {age}>​{=CombineText( Text( " and is " . FileRoot() . "'​s "), TextIf(IsSameItem(FileRoot(),​%CUR_PRIN%) or IsSameItem(FileRoot(),​%CUR_PRIN.~FATH>​%) or IsSameItem(FileRoot(),​%CUR_PRIN.~MOTH>​%) or Exists(%CUR_PRIN.BIRT%),​ "",​ Relationship(FileRoot(),​%CUR_PRIN%,​TEXT,​1) ) )}.< The godparents were {role(plural)=godparent}.><​ The godparent was {role(single)=godparent}.><​ The ceremony was conducted by {role=minister}.><​ The ceremony was conducted by {role=priest}.>​}''​\\ +//​Template://​\\ 
-//​Sentence://​ ''​He was baptised on 3 June 1900 in London and is John Smith'​s grandfather.''​+''​{individual} was baptised<​ {date}><​ {place}><​ {age}>​{=CombineText( Text( " and is " . FileRoot() . "'​s "),\\ 
 + TextIf(IsSameItem(FileRoot(),​%CUR_PRIN%) or IsSameItem(FileRoot(),​%CUR_PRIN.~FATH>​%) or\\ 
 + IsSameItem(FileRoot(),​%CUR_PRIN.~MOTH>​%) or Exists(%CUR_PRIN.BIRT%),​ "",​ Relationship(FileRoot(),​%CUR_PRIN%,​TEXT,​1) ) )}.\\ 
 + < The godparents were {role(plural)=godparent}.><​ The godparent was {role(single)=godparent}.>​\\ 
 + < The ceremony was conducted by {role=minister}.><​ The ceremony was conducted by {role=priest}.>​}''​\\ 
 +//​Sentence://​\\ 
 +''​He was baptised on 3 June 1900 in London and is John Smith'​s grandfather.''​
  
 ==== Burial Event ==== ==== Burial Event ====
Line 147: Line 176:
 This is a variant style of sentence to add interest. This is a variant style of sentence to add interest.
  
-//​Template://​ ''​Following {his/her} death, {individual} was buried {date} {place} {age}<​br>''​\\ +//​Template://​\\ 
-//​Sentence://​ ''​Following his death, he was buried on 23 March 1900 in Bristol, England aged 96.''​+''​Following {his/her} death, {individual} was buried {date} {place} {age}<​br>''​\\ 
 +//​Sentence://​\\ 
 +''​Following his death, he was buried on 23 March 1900 in Bristol, England aged 96.''​
  
 //Tip:// Note that ''​{date} {place} {age}''​ does not need to use ''<​ {date}><​ {place}><​ {age}>''​ because adjacent or trailing spaces resulting from empty fields are automatically pruned. //Tip:// Note that ''​{date} {place} {age}''​ does not need to use ''<​ {date}><​ {place}><​ {age}>''​ because adjacent or trailing spaces resulting from empty fields are automatically pruned.