Changes

Jump to: navigation, search

Customize the Genealogical Symbols lookup table

1,728 bytes added, 19:00, 20 March 2021
m
See also
{{#vardefine:chapter|Symbols}}
{{stub}}
{{man warn|1=temporary Workaround |2=This article is not intended for casual use. The '''Genealogical Symbols''' feature was a [[GEPS_039:_Genealogical_symbols_in_gramps|recent addition]] in the Gramps 5.1 version. Some function are not yet configurable through the interface.}}
If you select the ☑{{man label|use symbols}} checkbox, Gramps will use the selected font if it exists.
 
This can be useful if you want to add phonetic in a note to show how to pronounce a name or if you mix multiple languages like Greek and Russian.
 
You can only configure the death symbol from this tab.
If the [https://www.freedesktop.org/wiki/Software/fontconfig/ fontconfig] [[Gramps_5.1_Wiki_Manual_-_Settings#Prerequisite|prerequisite has been installed]], then on the {{Man menu|Edit ➡ Preferences ➡ Genealogical Symbols}} select the {{man button|Try to find}} button, Gramps will attempt to detect any suitable unicode text fonts that include gylphs for all the required symbols.
On the other hand, genealogical charts and books have been being printed for centuries. It is possible to hack the hard-coding to use other standards.
{{-}}
 
===Genealogy symbols preferences===
[[Gramps_{{Version manual}}_Wiki_Manual_-_Settings#Advanced_manipulation_of_settings|Advanced Manipulation of Settings]] - you can manually editing the <code>gramps.ini</code> preferences configuration [https://en.wikipedia.org/wiki/INI_file ini file ] stored in the Gramps version sub-folder of the [[Gramps_{{Version manual}}_Wiki_Manual_-_User_Directory|user directory]].
However, this section store a negligible amount of information. Rather being Advanced manipulation, hacking this configuration file offers little value. The most common hack will be to delete the subsection entirely and allow Gramps to re-create it with default settings. The files in the user directory do not need SuperUser privileges to modify. However, restrictions related to multi-user permissions will apply.  Initially, the preferences section related to Genealogical symbols might be are in a section labeled '''[utf8]''' (which stands for 8-bit Unicode Transformation Format) and it is created with commented out lines:
[utf8]
;;selected-font=''
[[File:EditPreferences-GenealogicalSymbols-Select-51.png|thumb|right|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Selecting a Symbol]]
{| class="wikitable"
|-
|DEATH_SYMBOL_LATIN_CROSS
| style="text-align:center;" | <big>&#x271d;</big>
| ! <span style="text-aligncolor:center;red" | >12</span>
|-
!
| style="text-align:center;" | 16
|}
 
The selection of the Death symbol seems to default to '12' or 'Latin Cross'. So, we'll keep in mind that the hacking row 12 on the preset table of alternate Death symbols is the most likely target. After selecting a font and enabling the Genealogical Symbols sets the configuration section to:
[utf8]
in-use=1
selected-font='Segoe UI Symbol'
{{-}}
===Built-in date label options===
The Relationship category view to the right shows the symbolic (language agnostic) labeling method created for the 5.1 version of Gramps.
{{-}}
[[File:GenealogicalSymbolsRelationshipsView_default-51.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} "Genealogical Symbols" - Relationship View - default display for version 5.1]]The Relationship category view to the right also shows the language agnostic labeling method created for the 5.1 version of Gramps. (The Gramplet bars have been turned off to reduce distracting clutter.) ''The data for Sibling 2 has been changed to display the baptismal and burial date text styling variants.'' These are only shown in this view when an explicit date for birth (or death) is missing. These dates are italicized to indicate that they are inferred by other events, not the actual birth or death dates. {{-}}[[File:GenealogicalSymbolsRelationshipsView_enabled-51.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} "Genealogical Symbols" - Relationship View - enabled defaults]]{{-}}===Hacking the date labels======= Where are the Symbol definitions are stored in Gramps ====The definitions for Genealogical Symbols for Gramps labels are located in the Gramps application directory. The relative file subpath is: https&#58;&#x2f;&#x2f;github.com/gramps-project/gramps/blob/maintenance/gramps51/[https://github.com/gramps-project/gramps/blob/maintenance/gramps51/gramps/gen/utils/symbols.py '''<code>gramps\gen\utils\symbols.py] </code>'''
Application files & sub-directories within are often hidden and write-protected. The exact Gramps application directory path varies by OS:
: Linux
: [[All_In_One_Gramps_Software_Bundle_for_Windows#Installation_folder|Windows]]
: MacOS
Application files & sub-directories often have hidden, write-restricted and/or write-protected [https://wikipedia.org/wiki/File_system_permissions file permissions]. To hack the Genealogical Symbol set, you may need to [https://www.howtogeek.com/194671/how-to-hide-files-and-folders-on-every-operating-system/ un-hide the folder] and open the file for editing using Administrator ([https://wikipedia.org/wiki/Superuser Superuser]) privileges.
A If the file is modified beyond usability, a backup copy of the file is archived on GitHub at :
https&#58;&#x2f;&#x2f;github.com/gramps-project/gramps/blob/maintenance/gramps51/[https://github.com/gramps-project/gramps/blob/maintenance/gramps51/gramps/gen/utils/symbols.py gramps/gen/utils/symbols.py]
The pertinent (unmodified) sections of the '''<code>symbols.py</code>''' file are:
<span style="white-space:nowrap; display:inline;">
(_("Illegitimate"), '\u229b', ""),
<span style="color:red">(_("Birth"), '\u002a', "*"),</span> <span style="color:red">(_("Baptism/Christening"), '\u007e', "~"),</span>
(_("Engaged"), '\u26ac', "o"),
<span style="color:red">(_("Marriage"), '\u26ad', "oo"),</span> <span style="color:red">(_("Divorce"), '\u26ae', "o|o"),</span>
(_("Unmarried partnership"), '\u26af', "o-o"),
<span style="color:red">(_("Buried"), '\u26b0', "d"),</span>
(_("Cremated/Funeral urn"), '\u26b1', "d"),
(_("Killed in action"), '\u2694', "d"),
# UNICODE SUBSTITUTION
death_symbols = [(_("Nothing"), "", ""),
("x", "\u03a9", "x"),
(_("Skull and crossbones"), "\u2620", "+"),
(_("Ankh"), "\u2625", "+"),
(_("East Syriac cross"), "\u2671", "+"),
(_("Heavy Greek cross"), "\u271a", "+"),
<span style="color:red">(_("Latin cross"), "\u271d", "+"),</span>
(_("Shadowed White Latin cross"), "\u271e", "+"),
(_("Maltese cross"), "\u2720", "+"),
]
</span>
 
{{-}}
 ===Customizing the date labels=Simulating previous Symbol definitions ==The Relationship category view to the right shows the language agnostic labeling method created for the 5.1 version of Gramps.{{-}} [[File:GenealogicalSymbolsRelationshipsView_default-51.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} "Genealogical Symbols" - Relationship View - default display for version 5.1]]The Relationship category view to the right also shows the language agnostic labeling method created for the 5.1 version of Gramps. (The Gramplet bars have been turned off to reduce distracting clutter.) The data for Sibling 2 has been changed to display the baptismal and burial date text styling variants. These are only shown in this view when an explicit date for birth (or death) is missing. Note that these dates are italicized to highlight that they are not actual birth or death dates. {{-}} ===Next Section===
[[File:GenealogicalSymbolsRelationshipsView_textSub-51.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} "Genealogical Symbols" - Relationship View - text substitutions]]
{{-}}
[[File:GenealogicalSymbolsRelationshipsView_enabled-51.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} "Genealogical Symbols" - Relationship View - enabled defaults]]
{{-}}
[[File:GenealogicalSymbolsRelationshipsView_default_AlphaOmega-51.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} "Genealogical Symbols" - Relationship View - Alpha & Omega text]]
{{-}}
===Genealogy symbols preferences===
[[Gramps_{{Version manual}}_Wiki_Manual_-_Settings#Advanced_manipulation_of_settings|Advanced Manipulation of Settings]] - manually editing the <code>gramps.ini</code> preferences file stored in the Gramps version sub-folder of the [[Gramps_{{Version manual}}_Wiki_Manual_-_User_Directory|user directory]]
 
Initially, the preferences section related to Genealogical symbols might be created with commented out lines:
 
[utf8]
;;available-fonts=[]
;;death-symbol=13
;;in-use=0
;;selected-font=''
 
{| class="wikitable"
|-
!Name Data!symbol<br />identifiertext label!Displays!Gramps<br />codeabbreviated
|-
!|DEATH_SYMBOL_NONE | birth | style="text-align:center;" | 0Birth | b.
|-
!|DEATH_SYMBOL_Xbaptism| style="text-align:center;" | x | style="text-align:center;" | 1bap.
|-
!|DEATH_SYMBOL_SKULLchristening | style="text-align:center;" | <big>&#x2620;</big> | style="text-align:center;" | 2chr.
|-
!|DEATH_SYMBOL_ANKHdeath | style="text-align:center;" | <big>&#x2625;</big>Death | style="text-align:center;" | 3d.
|-
!|DEATH_SYMBOL_ORTHODOX_CROSSburial | style="text-align:center;" | <big>&#x2626;</big>Burial | style="text-align:center;" | 4bur.
|-
!|DEATH_SYMBOL_CHI_RHOmarried | style="text-align:center;" | <big>&#x2627;</big>Marriage | style="text-align:center;" | 5mar.
|-
!|DEATH_SYMBOL_LORRAINE_CROSSdivorced | style="text-align:center;" | Divorce| div.|}  all_symbols = [ # Name UNICODE SUBSTITUTION (_("Birth"), <span style="color:red">'\u03b1', "b."</span>), (_("Baptism/Christening"), <span style="color:red">'\u224b', "bap."</span>), (_("Marriage"), <span style="color:red">'\u26ad', "mar."</span>), (_("Divorce"), <span style="color:red">'\u26ae', "div."</span>), (_("Buried"), <bigspan style="color:red">&#x2628;'\u26b0', "bur."</bigspan>),  # The following is used in the global preferences in the display tab. # Name # UNICODE SUBSTITUTION death_symbols = [(_("Nothing"), "", ""), ("x", "\u03a9", "d."),| (_("Latin cross"), <span style="textcolor:red">"\u271d", "d."</span>),{{-}}==== Alternative Symbol definitions ====[[File:GenealogicalSymbolsRelationshipsView_default_AlphaOmega-align51.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:center;figure}}+1}}}} "Genealogical Symbols" - Relationship View - Alpha & Omega text]]{| 6class="wikitable"
|-
!Data|DEATH_SYMBOL_JERUSALEM_CROSS| style="text-align:center;" | <big>&#x2629;</big>| style="text-align:center;" | 7! abbreviated
|-
!|DEATH_SYMBOL_STAR_CRESCENTbirth | style="text-align:center;" | <big>&#x262ax03b1;</big>| style="text-align:center;" | 8
|-
!|DEATH_SYMBOL_WEST_SYRIAC_CROSS| style="text-align:center;" | <big>&#x2670;</big>baptism| style="text-align:center;" | 9
|-
!|DEATH_SYMBOL_EAST_SYRIAC_CROSS| style="text-align:center;" | <big>&#x2671;</big>christening | style="text-align:center;" | 10
|-
!|DEATH_SYMBOL_HEAVY_GREEK_CROSSdeath | style="text-align:center;" | <big>&#x271ax03a9;</big>| style="text-align:center;" | 11
|-
!|DEATH_SYMBOL_LATIN_CROSSburial | style="text-align:center;" | <big>&#x271dx26b0;</big>| style="text-align:center;" | 12
|-
!|DEATH_SYMBOL_SHADOWED_LATIN_CROSS| style="text-align:center;" | <big>&#x271e;</big>married | style="text-align:center;" | 13
|-
!|DEATH_SYMBOL_MALTESE_CROSS| style="text-align:center;" |<big>&#x2720;</big>| style="text-align:center;" | 14|-!|DEATH_SYMBOL_STAR_OF_DAVID| style="text-align:center;" | <big>&#x2721;</big>| style="text-align:center;" | 15|-!|DEATH_SYMBOL_DEAD| style="text-align:center;" | Deaddivorced | style="text-align:center;" | 16
|}
all_symbols = [utf8] available-fonts # Name UNICODE SUBSTITUTION (_("Birth"), <span style="color:red">'\u03b1', "b."</span>), (_("Baptism/Christening"), <span style="color:red">'\u224b', "≋"</span>), (_("Marriage"), <span style="color:red">'\u26ad', "mar."</span>), (_("Divorce"), <span style=["color:red">'Segoe UI Symbol\u26ae'], "div."</span>), death-symbol (_("Buried"), <span style=12"color:red">'\u26b0', "bur."</span>), # The following is used in the global preferences in-usethe display tab. # Name # UNICODE SUBSTITUTION death_symbols =1[(_("Nothing"), "", ""), ("x", "\u03a9", selected"d."), (_("Latin cross"), <span style="color:red">"\u271d", "d."</span>),{{-font='Segoe UI Symbol'}}
== See also ==
[[Category:Tutorials]]
[[Category:WikiContributors]][[Category:How do I...]]
<!--
4,599
edits

Navigation menu