4,216
edits
Changes
m
This can be useful if you want 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 add phonetic in a note find}} button, Gramps will attempt to show how to pronounce a name or if you mix multiple languages like Greek and Russiandetect any suitable unicode text fonts that include gylphs for all the required symbols.
You can only configure the death symbol from this [[File:EditPreferences-GenealogicalSymbols-tab-default-51.png|center|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} "Genealogical Symbols" - initial Preferences tab (Gramps 5.1.x)]]
* Female* Male* Asexuality, sexless, genderless* Lesbianism* Male homosexuality* Heterosexuality* Transgender, hermaphrodite (After clicking the {{man button|Try to find}} button in entomology)* Transgender* Neuterthe {{Man menu|Edit ➡ Preferences ➡ Genealogical Symbols}} tab
* Illegitimate* Birth* Baptism/Christening* Engaged* Marriage* Divorce* Unmarried partnership* Buried* Cremated/Funeral urn* Killed in action* Extinct * Death[[File:EditPreferences-GenealogicalSymbols-> <!FindFont-- Unicode symbols not showing on mediwiki due to ??? add back when worked out51.png|center|thumb|300px|Fig. {{-#var:chapter}}* &.{{#2640; - Female* &vardefineecho:figure|{{#2642; - Male* &expr:{{#26aa; - Asexuality, sexless, genderless* a2; - Lesbianism* a3; - Male homosexuality* a4; - Heterosexuality* a5; - Transgender, hermaphrodite (in entomology)* a6; - Transgender* b2; var:figure}}+1}}}} "Genealogical Symbols" - NeuterFinding fonts]]
* åb; - Illegitimate* a; - Birth* c; - Baptism{{man tip| 1=Fonts must include all gylphs to be recognized.|2=The full set of Genealogical Symbols required by this feature are not defined in every [https://wikipedia.org/wiki/Font_family_(HTML) font family]. Many of the death [https://wikipedia.org/Christening* ac; - Engaged* ad; - Marriage* ae; - Divorce* af; - Unmarried partnership* b0; - Buried* b1; - Crematedwiki/Funeral urn* આ - Killed in action* ߥ - ExtinctGlyph glyphs] are religious representations and were omitted as a form of conflict avoidance.
* ďe; - DeathFor a test Windows 10 computer with 191 font families installed, <i><b>only one</b></i> Unicode font (Segoe UI Symbol) was found that included all the required glyphs.}}
{{<!--}}
===Customizing the date labels===* Female[[File:Relationships-category-view-50.png|right|450px|thumb|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Relationships Category view in Gramps version 5.0]]Prior to the Genealogical Symbols feature being implemented* Male* Asexuality, sexless, genderless* Lesbianism* Male homosexuality* Heterosexuality* Transgender, birth and death data were explicitly labeled hermaphrodite (in English for the Active Person. This data was labeled with a simple abbreviation of label where more compact display was needed for the other relatives. entomology)* Transgender* Neuter
The Relationship category view <!-- Unicode symbols not showing on mediwiki due to the right shows the superseded English label method.??? add back when worked out
[[File:Relationships* ੐ -categoryFemale* ੒ -viewMale* aa; -51.png|right|450px|thumb|Fig. {{Asexuality, sexless, genderless* &#var:chapter}}.{{26a2; - Lesbianism* &#vardefineecho:figure|{{26a3; - Male homosexuality* &#expr:{{26a4; - Heterosexuality* &#var:figure}}+1}}}} Relationships Category view 26a5; - Transgender, hermaphrodite (in Gramps version 5.1]]It was determined that these English labels did not encourage localization. An arbitrary set of symbols had been proposed that was deemed more universal than English terms and abbreviations.entomology)* a6; - Transgender* b2; - Neuter
The Relationship category view to the right shows the language agnostic labeling method created for the 5.1 version of Gramps.* åb; - Illegitimate* a; - Birth* c; - Baptism/Christening* ac; - Engaged* ad; - Marriage* ae; - Divorce* af; - Unmarried partnership* b0; - Buried* b1; - Cremated/Funeral urn* આ - Killed in action* ߥ - Extinct * ďe; - Death-->
[[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 superseded English label 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===[This set of symbols has been [Filehttps:GenealogicalSymbolsRelationshipsView_textSub-51//wikipedia.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} "Genealogical Symbols" - Relationship View org/wiki/Hard_coding hard- text substitutions]coded]{{-}}, following a [Tamura Jones expounds on [Filehttps:GenealogicalSymbolsRelationshipsView_enabled-51//www.png|right|thumb|450px|Figtamurajones. {{#var:chapter}}net/GenealogySymbols.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} "Genealogical Symbols" xhtml 30- Relationship View year old recommendation for genealogical software]. However, these recommendations were based on the very limited options in early personal computers. The symbols used for birth & death are re- enabled defaults]]purposed from mathematical operators. This raises objections about ambiguity. {{-}}[[File:GenealogicalSymbolsRelationshipsView_default_AlphaOmega-51Other than choosing between text & pictographs, the Preferences options are limited. Choosing a font only subtly affects symbol renderings.png|right|thumb|450px|FigBut you can also select from a variety of death symbols. {{#var:chapter}} On the other hand, genealogical charts and books have been being printed for centuries.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} "Genealogical Symbols" It is possible to hack the hard- Relationship View - Alpha & Omega text]]coding to use other standards.
| ! <span style="text-aligncolor:center;red" | >12</span>
[[Category:WikiContributors]][[Category:How do I...]]
{{man tip| 1=Title of Tip |2=Tips text.}}
File:Relationships-category-view-default-52.png
{{#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.}}
=== Genealogical Symbols ===
Allows you to use Genealogical symbols Symbols instead of text abbreviations in reports, charts and the Gramps interface.
This tab gives you the possibility to use one font which is able to show all genealogical symbols. (Once configured see: [[#Prerequisite_to_use_Genealogical_Symbols|Prerequisite to use Genealogical Symbols]])
If you select the "☑{{man label|use symbols" }} checkbox, Gramps will use the selected font if it exists.
[[File:List of EditPreferences-GenealogicalSymbols-tab-default-52.png|center|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} "Genealogical Symbols shown " - initial Preferences tab (listed in order shown at bottom screenshotGramps 5.2.x):<!--]]
When the search has completed select one of the fonts from the {{man label|Choose font}} pop-->up menu list and then select the ☑{{man label|use symbols}} checkbox.
[[File:EditPreferences-GenealogicalSymbols-tab-activated-51.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} "Genealogical Symbols" - Preferences tab - activated defaults]]
:List of Genealogical Symbols shown (listed in order shown in the {{-man label|What you will see:}}=== Where are preview at the Symbols are stored in Gramps === all_symbols = [ # Name UNICODE SUBSTITUTION (_("Female"), '\u2640', ""), (_("Male"), '\u2642', ""), (_("Asexuality, sexless, genderless"), '\u26aa', ""), (_("Lesbianism"), '\u26a2', "oo"), (_("Male homosexuality"), '\u26a3', "oo"), (_("Heterosexuality"), '\u26a4', "oo"), (_("Transgender, hermaphrodite (in entomology)"), '\u26a5', ""), (_("Transgender"), '\u26a6', ""), (_("Neuter"), '\u26b2', ""), (_("Illegitimate"), '\u229b', ""), (_("Birth"), '\u002a', "*"), (_("Baptism/Christening"), '\u007e', "~"), (_("Engaged"), '\u26ac', "o"), (_("Marriage"), '\u26ad', "oo"), (_("Divorce"), '\u26ae', "o|o"), (_("Unmarried partnership"), '\u26af', "o-o"), (_("Buried"), '\u26b0', "d"), (_("Cremated/Funeral urn"), '\u26b1', "d"), (_("Killed in action"), '\u2694', "d"), (_("Extinct"), '\u2021', ""), ] # genealogical death symbols DEATH_SYMBOL_NONE = 0 DEATH_SYMBOL_X = 1 DEATH_SYMBOL_SKULL = 2 DEATH_SYMBOL_ANKH = 3 DEATH_SYMBOL_ORTHODOX_CROSS = 4 DEATH_SYMBOL_CHI_RHO = 5 DEATH_SYMBOL_LORRAINE_CROSS = 6 DEATH_SYMBOL_JERUSALEM_CROSS = 7 DEATH_SYMBOL_STAR_CRESCENT = 8 DEATH_SYMBOL_WEST_SYRIAC_CROSS = 9 DEATH_SYMBOL_EAST_SYRIAC_CROSS = 10 DEATH_SYMBOL_HEAVY_GREEK_CROSS = 11 DEATH_SYMBOL_LATIN_CROSS = 12 DEATH_SYMBOL_SHADOWED_LATIN_CROSS = 13 DEATH_SYMBOL_MALTESE_CROSS = 14 DEATH_SYMBOL_STAR_OF_DAVID = 15 DEATH_SYMBOL_DEAD = 16 # The following is used in the global preferences in bottom of the display tab. # Name # UNICODE SUBSTITUTION death_symbols = [(_("Nothing"), "", ""), ("x", "\u03a9", "x"), (_("Skull and crossbones"), "\u2620", "+"), (_("Ankh"), "\u2625", "+"), (_("Orthodox cross"), "\u2626", "+"), (_("Chi rho"), "\u2627", "+"), (_("Cross of Lorraine"), "\u2628", "+"), (_("Cross of Jerusalem"), "\u2629", "+"), (_("Star and crescent"), "\u262a", "+"), (_("West Syriac cross"), "\u2670", "+"), (_("East Syriac cross"), "\u2671", "+"), (_("Heavy Greek cross"), "\u271a", "+"), (_("Latin cross"), "\u271d", "+"), (_("Shadowed White Latin cross"), "\u271e", "+"), (_("Maltese cross"), "\u2720", "+"), (_("Star of David"), "\u2721", "+"), (_("Dead"), _("Dead"), _("Dead")) ] :
{| class="wikitable"
|-
| Greater-Than Symbol
|}
* Illegitimate
* Birth
* Baptism/Christening
* Engaged
* Marriage
* Divorce
* Unmarried partnership
* Buried
* Cremated/Funeral urn
* Killed in action
* Extinct
* Death
-->
{{-}}
{{-}}
[[File:Relationships-category-view-50.png|right|450px|thumb|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Relationships Category view in Gramps version 5.0]]Prior to the Genealogical Symbols feature being implemented, birth and death data were explicitly labeled in English for the Active Person. This data was labeled with a simple abbreviation of label where more compact display was needed for the other relatives.
{{-}}
[[File:Relationships-category-view-default-52.png|right|450px|thumb|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Relationships Category view in Gramps version 5.1]]It was determined that these English labels did not encourage localization. An arbitrary set of symbols had been proposed that was deemed more universal than English terms and abbreviations.
{{-}}
===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>✝</big>
|-
!
| 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: '''<code>gramps\gen\utils\symbols.py</code>'''
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.
If the file is modified beyond usability, a backup copy of the file is archived on GitHub at :
https://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;">
all_symbols = [
# Name UNICODE SUBSTITUTION
(_("Female"), '\u2640', ""),
(_("Male"), '\u2642', ""),
(_("Asexuality, sexless, genderless"), '\u26aa', ""),
(_("Lesbianism"), '\u26a2', "oo"),
(_("Male homosexuality"), '\u26a3', "oo"),
(_("Heterosexuality"), '\u26a4', "oo"),
(_("Transgender, hermaphrodite (in entomology)"), '\u26a5', ""),
(_("Transgender"), '\u26a6', ""),
(_("Neuter"), '\u26b2', ""),
(_("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"),
(_("Extinct"), '\u2021', ""),
]
# genealogical death symbols
DEATH_SYMBOL_NONE = 0
DEATH_SYMBOL_X = 1
DEATH_SYMBOL_SKULL = 2
DEATH_SYMBOL_ANKH = 3
DEATH_SYMBOL_ORTHODOX_CROSS = 4
DEATH_SYMBOL_CHI_RHO = 5
DEATH_SYMBOL_LORRAINE_CROSS = 6
DEATH_SYMBOL_JERUSALEM_CROSS = 7
DEATH_SYMBOL_STAR_CRESCENT = 8
DEATH_SYMBOL_WEST_SYRIAC_CROSS = 9
DEATH_SYMBOL_EAST_SYRIAC_CROSS = 10
DEATH_SYMBOL_HEAVY_GREEK_CROSS = 11
DEATH_SYMBOL_LATIN_CROSS = 12
DEATH_SYMBOL_SHADOWED_LATIN_CROSS = 13
DEATH_SYMBOL_MALTESE_CROSS = 14
DEATH_SYMBOL_STAR_OF_DAVID = 15
DEATH_SYMBOL_DEAD = 16
# The following is used in the global preferences in the display tab.
# Name
# UNICODE SUBSTITUTION
death_symbols = [(_("Nothing"), "", ""),
("x", "\u03a9", "x"),
(_("Skull and crossbones"), "\u2620", "+"),
(_("Ankh"), "\u2625", "+"),
(_("Orthodox cross"), "\u2626", "+"),
(_("Chi rho"), "\u2627", "+"),
(_("Cross of Lorraine"), "\u2628", "+"),
(_("Cross of Jerusalem"), "\u2629", "+"),
(_("Star and crescent"), "\u262a", "+"),
(_("West Syriac cross"), "\u2670", "+"),
(_("East Syriac cross"), "\u2671", "+"),
(_("Heavy Greek cross"), "\u271a", "+"),
<span style="color:red">(_("Latin cross"), "\u271d", "+"),</span>
(_("Shadowed White Latin cross"), "\u271e", "+"),
(_("Maltese cross"), "\u2720", "+"),
(_("Star of David"), "\u2721", "+"),
(_("Dead"), _("Dead"), _("Dead"))
]
</span>
{{-}}
==== Simulating previous Symbol definitions ====
[[File:GenealogicalSymbolsRelationshipsView_textSub-51.png|right|thumb|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} "Genealogical Symbols" - Relationship View - text substitutions]]
{| class="wikitable"
|-
! Data
! text label
! abbreviated
|-
! birth
| style="text-align:center;" | Birth
| b.
|-
! baptism
| style="text-align:center;" |
| bap.
|-
! christening
| style="text-align:center;" |
| chr.
|-
! death
| style="text-align:center;" | Death
| d.
|-
! burial
| style="text-align:center;" | Burial
| bur.
|-
! married
| style="text-align:center;" | Marriage
| mar.
|-
! divorced
| 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"), <span style="color:red">'\u26b0', "bur."</span>),
# 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="color:red">"\u271d", "d."</span>),
{{-}}
==== Alternative Symbol definitions ====
[[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]]
{| class="wikitable"
|-
! Data
! abbreviated
|-
! birth
| style="text-align:center;" | α
|-
! baptism
| style="text-align:center;" | ≋
|-
! christening
| style="text-align:center;" | ≋
|-
! death
| style="text-align:center;" | Ω
|-
! burial
| style="text-align:center;" | ⚰
|-
! married
| style="text-align:center;" | ⚭
|-
! divorced
| style="text-align:center;" | ⚮
|}
all_symbols = [
# 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">'\u26ae', "div."</span>),
(_("Buried"), <span style="color:red">'\u26b0', "bur."</span>),
# 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="color:red">"\u271d", "d."</span>),
{{-}}
== See also ==
* Feature request: {{bug|9098}} Gramps should be able to use genealogy symbols everywhere.
* [[Customize the Genealogical Symbols lookup table]] located in the Gramps application directory inside: [https://github.com/gramps-project/gramps/blob/maintenance/gramps51/gramps/gen/utils/symbols.py gramps\gen\utils\symbols.py]
* Gramps application directory for:
: Linux
: [[All_In_One_Gramps_Software_Bundle_for_Windows#Installation_folder|Windows]]
: MacOS
* Tamura Jones expounds on [https://www.tamurajones.net/GenealogySymbols.xhtml Genealogical Symbols] ''(the 'Unicode' section is particularly relevant)''
<!--
[[Category:Tutorials]]
<!--
== Boxed annotations ==
{{man note|Example Note |Notes text.}}
-->