Difference between revisions of "Add Types to the SyncAssociation Gramplet"

From Gramps
Jump to: navigation, search
(Tag: New redirect)
Line 1: Line 1:
{{Third-party plugin}}
+
#REDIRECT [[Addon:SyncAssociation#Add_Types_to_the_Sync_Association_Gramplet]]
{{man note|Support page for [[Addon:SyncAssociation|SyncAssociations]] tool}}
 
How do I add a new relationship Type to the [[Addon:SyncAssociation|SyncAssociations]] tool?
 
== Not for the casual user ==
 
The list of Association Types was not designed to be changed via the interface. (It was intended for a specific Association and does not '''''have''''' any interface.) But you can manually change the Gramplet code as a temporary hack.  Unfortunately, the next time that Gramplet is updated, any temporary hacks will be wiped out.
 
 
 
To add more ‘official’ reciprocal relationship will take time. The quickest turnaround would be for users to manually change the Association Types in the system and, once they have verified the the Types as functioning, then submit the patched line of associations as an Enhancement Request.
 
 
 
== What variations of Syncs can be added? ==
 
Associations can be symmetrical or reciprocal.  That is to say, the relationship is described the same way from either side (co-workers) or inverse/mirror of one another (guardian and ward)
 
 
 
As an example, perhaps you want to log the Association of a [https://wikipedia.org/wiki/Namesake Namesake] to their [https://wikipedia.org/wiki/Eponym Eponym].  The Junior-Senior namesake relationships are implied via the Name Suffix and loosely refined via the Family relationship.  But namesakes that skip a generation (or are honoring a famous person/thing) are more easily tracked via Associations.  It sure would be nice for there to be less work to set the Reciprocal Association.
 
 
 
When considering Associations, note that they do not have a datespan. So logged Associations should probably be limited to those that are expected to be lifelong.
 
== The Hack ==
 
If you go to line 57 of syncAssociations.py you will see:
 
 
 
<pre>
 
ASSOC_LOOKUP = {
 
"cM": "cM",
 
"DNA": "DNA",
 
"Godfather": "Godchild",
 
"Godmother": "Godchild",
 
"Landlord": "Tenant"
 
}
 
</pre>
 
 
 
You need to add lines with a similar format (quoted string then colon then quoted string then comma)
 
 
 
Once the new Associations Types have tested and work as expected, submit an [https://gramps-project.org/bugs/my_view_page.php enhancement request].
 
 
 
== See also ==
 
* Gramps {{man version}} Manual - [[Gramps_{{man version}}_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_1#Associations| Entering and Editing: Associations]]
 
*[[Roles,_Relationships_%26_Associations|Roles, Relationships & Associations]]
 
*[[Addon:DNASegmentMapGramplet|DNA Segment Map Gramplet]]
 
 
 
 
 
{{DEFAULTSORT:How do I...new category location|noreplace}}
 
[[Category:Addons]]
 
[[Category:How do I...]]
 
 
<!--
 
<div style="background:lightcyan">
 
 
 
 
 
Paste the raw '''[[:Category:Tutorials|Tutorials]]''' outline for the '''[[:Category:How_do_I...|How Do I...]]''' article above the '''See also''' section. This might start with pasting in a copy of a useful thread from one of the Gramps maillists.
 
 
 
 
 
Saving this file as a 'work in progress' will insert the code behind this reference template. (Preview only show the results, not the markup formatting control.) You can use the appended special formatting example template to pre-populate a virtual Copy&amp;Paste clipboard.  Snip pieces to paste special formatting to enhance the outline.
 
 
 
----
 
 
 
Adding a ''feature documentation'' link pointing to the introduction of the interface element in the wiki will relieve you of the burden explaining how to find the feature.
 
 
 
Finding a ''[[Gramps_Glossary|Gramps Glossary]] term'' to link may be easier than choosing the best introductory section in the wiki.
 
  <small>&#91;&#91;Gramps_Glossary#active_person|Active Person]]
 
  &#91;&#91;Gramps_Glossary#P|Primary Object]]</small>
 
Glossary terms (like [[Gramps_Glossary#active_person|Active Person]] above) are normally lowercase and use an underscore between words. They have a brief description and may already have the introductory text and practical tutorial linked. You can fall back to the Letter index (like using '[[Gramps_Glossary#P|P]]' with [[Gramps_Glossary#P|Primary Object]] above) if you don't know the exact entry.
 
 
 
Since most of these ''How do I...'' tutorials are likely to have been prompted by a MailList discussion, a set of example 'See also' link are included for reference.
 
 
 
Pointing the ''maillist archived thread'' link to the original message that inspired the tutorial give proper credit for the idea &amp; reveals the background discussion.
 
 
 
Pointing another link to a good search phrase for the archive allows similar discussions to be explored.
 
 
 
----
 
 
 
Once the tutorial Preview is satisfactory, save a revision of the document. Then clean out the virtual Copy&amp;Paste clipboard cluttering up your tutorial and save a final revision.
 
 
 
 
 
To remove the virtual Copy&amp;Paste clipboard, simply delete everything from the beginning of this section to the bottom of the document. It is all disposable.
 
 
 
If the Copy&amp;Paste clipboard is needed again, simply paste the following line at the end of the Edit box, Save a revision, &amp; edit again.(Previewing isn't enough... a revision must be saved.)
 
<pre>  {{subst:Template:How_do_I}}</pre>
 
Other wiki [[:Category:Templates|Templates]] can be used as virtual Copy&amp;Paste clipboards in the same way.
 
 
 
 
 
</div>
 
[[Write_a_%22How_Do_I...%22_Article|Writing a 'How do I...' article.]]
 
<pre>
 
{{subst:Gramps_{{man version}}_Wiki_Manual_-_Preface}}
 
{{subst:WikiContributorRecruiting}
 
</pre>
 
----
 
 
 
== (Section) ==
 
Stub, english (''default'')
 
{{Stub}}
 
 
 
{{Stub|fr}}
 
Stub, french
 
 
 
=== Embeddable Snippets (Subsection) ===
 
Icons
 
: {{icon|gram}} Dashboard
 
: {{icon|peop}} People
 
: {{icon|rela}} Relationships
 
: {{icon|fami}} Family Families
 
: {{icon|ance}} Charts
 
: {{icon|even}} Events
 
: {{icon|plac}} Places
 
: {{icon|geog}} Geography
 
: {{icon|sour34}} Sources
 
: {{icon|cite}} Citations
 
: {{icon|repo}} Repositories
 
: {{icon|medi}} Media
 
: {{icon|note}} Notes
 
:[[Template:Icon/doc|more of the standard icons]]
 
 
 
<small>
 
{|
 
|+ List object tools
 
|-
 
! style="width: 70px"|
 
! style="width: 70px"|
 
! style="width: 70px"|
 
! style="width: 70px"|
 
! style="width: 70px"|
 
! style="width: 70px"|
 
|-
 
!{{icon|stock_add}}
 
!{{icon|share}}
 
!{{icon|stock_edit}}
 
!{{icon|stock_remove}}
 
!{{icon|up}}
 
!{{icon|down}}
 
|-
 
! Add
 
! Share
 
! Edit
 
! Remove
 
! <small>Move<br /></small>Upwards
 
! Move<br />Downwards
 
|}
 
</small>
 
 
 
==== [[Help:Formatting|Text formatting]] (Level 2 Subsection) ====
 
''italic'', '''bold''', '''''bold & italic'''''
 
===== [[Help:Images|Images]] (Level 3 Subsection) =====
 
[[File:ChartsCategory-desendantfan-fullcircle-9gen-default-50.png|thumb|right|450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} A screenshot caption]]
 
[[Image:Gramps-logo.png|Logo]]
 
 
 
*[[Screenshots|Screenshots]]
 
*[[Special:PrefixIndex|Templates]]
 
====== Annotations of User Activities  (Level 4 Subsection) ======
 
 
 
*<pre>Commands you type at the command line</pre>
 
 
 
*''Filenames'' or <code>Filenames</code>
 
 
 
*<tt>''Replaceable text''</tt>
 
 
 
*{{man label|Labels}} for buttons and other portions of the graphical interface
 
 
 
*{{man tooltip|hint text}} for roll-over tooltip hints that identify elements of the graphical interface
 
 
 
*Menu selections look like this: {{Man menu|Menu &#x27a1; Submenu &#x25B6; Menu Item}} (always pad unicode symbols like these arrows with spaces so that robot translators see recognizable words)
 
* Pop-up menu down {{man button|&#x25BC;}} arrowhead, (triangle) button
 
 
 
*{{man button|Buttons}}  you can click
 
 
 
*{{Man key press|CTRL|D}} see [[Gramps_{{man version}}_Wiki_Manual_-_Keybindings|Keybindings]] for a list of keyboard combinations used in Gramps.
 
 
 
*<tt>Anything you type in</tt>
 
 
 
*{{checkbox|1|Checked}} - [[Template:Checkbox|Selected Checkbox]] &#x2611; template
 
*{{checkbox|0|Unchecked}} - Checkbox that is &#x274f; unselected
 
 
 
== Boxed annotations ==
 
{{man tip| 1=Title of Tip |2=Tips text.}}
 
{{man note|Example Note |Notes text.}}
 
{{man warn|1=WarningTitle/Heading |2=warning text }}</onlyinclude>
 
 
 
-->
 

Revision as of 00:52, 25 October 2020