Changes

Jump to: navigation, search

Addon:Forms Gramplet

1,769 bytes added, 14:56, 2 October 2021
m
Improved 'Adding the gramplet' instructions
{{Third-party plugin}}
{{man tip|Census or Form?|Please note the ''Form Addons'' are an upgrade released in 2015 to expand the flexibility of the orignal Census Addons. The ''Form Addons'' supersede the [[Census_Addons|Census Addons]] from Gramps 4.2.X}}
[[File:Forms Gramplet.png|thumb|right|450px|Forms Gramplet - Shown Undocked from Bottombar Of People Category View]]
The Form gramplet allows users to create and edit structured source data in a single form. It makes the meticulous process of recording all the discrete elements far less fussy and error-prone.
== Forms Gramplet ==
{{man warn|Before using the forms addons|you You need to define the form that describes the information contained within a source.'''<br>See: [[Form_Addons#Configuration|Configuration]]}}
{{-}}
=== Adding the Forms Gramplet ===
{{man menu[[File:AddingFormsGrampletToBottombarOfPeopleCategoryView-51.png|thumb|right|450px|Adding Forms Gramplet to bottombar of People Category (Tree) View]]The '''Forms Gramplet gramplet''' is designed to be added to for the bottombar of a {{icon|peop}}[[Gramps_{{Version manual}}_Wiki_Manual_-_Categories#People_Category|People Category]] (''Grouped'' or ''List'') viewmodes of Gramps. (After [[Third-party_Addons#Installing_Addons_in_Gramps|installation]], this gramplet will be available for addition in all these locations: the [[Gramps_{{man version}}_Wiki_Manual_-_Gramplets#The_split-screen_Sidebar_.26_Bottombar|sidebar/bottombar option]]for the following views: {{icon|peop}}People, {{icon|rela}}Relationships, {{icon|ance}}Charts, and {{icon|geog}}Geography.)
Select the {{man label|Forms}} menu option from the {{man label|Add a gramplet}} submenu of the [[File:AddingFormsGrampletToBottombarOfPeopleCategoryViewGramps_{{man version}}_Wiki_Manual_-51_Main_Window#Gramplet_Bar_Menu|Gramplet selection menus]].pngAccessible by pressing the {{man button|thumb|right|450px|Adding Forms Gramplet To Bottombar Of People Category &or;}} (Tree''Down Arrowhead'' button) View]]in the view's sidebar or bottombar.
The blank '''Forms Gramplet''' will be shown docked as below.
{{-}}
[[File:FormsGrampletShownInBottombarOfPeopleCategoryView-51.png|thumb|rightleft|450px|Forms Gramplet - Shown docked In Bottombar Of People Category View]] 
{{-}}
=== Initial Configuration for each source ===
{{man menu|Before using the forms addons you need to define the form that describes the information contained within a source. See: [[Form_Addons#Configuration|Configuration]]}}
A new event can be created by clicking the {{man button|New}} button at the bottom of the {{man label|Forms Gramplet}} which will show you the {{man label|[[Form_Addons#Form_Selector|Select Form]]}} selector dialog where you can choose the form to use. Once you select a form you will be taken to the {{man label|[[Form_Addons#Form_Editor|Form Editor]]}}.
[[File:Forms Gramplet.png|thumb|right|450px|Forms Gramplet - Shown Undocked from Bottombar Of People Category View]]{{-}}<!-- [[File:Forms Gramplet showing existing event.png|thumb|right|450px|Forms Gramplet - Showing existing event]] --> An existing event can be edited either by highlighting a row and clicking the {{man button|Edit}} button or by double-clicking on a row to bring up the the {{man label|[[Form_Addons#Form_Editor|Form Editor]]}}. 
[[File:If the {{man label|Forms Gramplet}} is undocked you can use the {{man button|Help}} button to see this page.png]]{{-}}
== Form Selector ==
* A place can be selected in the usual Gramps manner.
{{-}}
=== Details tab===
The "{{man label|Details}}" tab provides an area which allows the user to enter data specific to individual people listed in the source. This tab can be divided into sections. Each section consists of people performing the same role in the event.
[[fileFile:Form Editor.png|left]]{{-}}
==== Person Section ====
A person section allows information about a single person to be entered. A new person can be created and selected by clicking the "{{man button|+" }} button. A person already in Gramps can be selected by clicking the second button ("{{man button|share"}}). The user is prevented from entering data until a person is selected. [[file:Form Person Section.png]]
[[File:Form Person Section.png|left]]
{{-}}
==== Family Section ====
A family section allows information about two people belonging to a family to be entered. A new family can be created and selected by clicking the "{{man button|+" }} button. A family already in Gramps can be selected by clicking the second button ("{{man button|share"}}). The user is prevented from entering data until a family is selected. [[file:Form Family Section.png]]
[[File:Form Family Section.png|left]]
{{-}}
==== Multiple Person Section ====
A multiple person section allows information about multiple people to be entered. A new person can be created and then added to the section by clicking the "{{man button|+" }} button. A person already in Gramps can be added to the section by clicking the second button ("{{man button|share"}}). A person can be removed from the section by clicking the "{{man button|-" }} button. The order of people in the section can be changed by highlighting a row and then using the up {{man button|↑}} and down {{man button|↓}} arrow buttons.
[[fileFile:Form Multiple Section.png|left]]{{-}}
===Headings tab===
{{man tip| Translated Gramps |2=If you are using Gramps in a language other than English, enter the translated version of the key (e.g. In French, "<code>Formulaire</code>" instead of "<code>Form</code>").}}
[[ImageFile:Form Source.png|left]]{{-}}
=== Supported form definitions ===
<form id='UK1841' type='Census' title='1841 UK Census' date='6 Jun 1841'>
The form is divided into sections which describe the information that needs to be captured for people performing a given role in the event. Each form element should contain at least one section element. The <code>section</code> start-tag can specify these 3 optional attributes (although none is required if all your fields are "heading"):
* <code>role</code> : The role that people in this section perform in the event. This value will appear in the "<code>Role</code>" column of events ("EventRoleType").
* <code>type</code> : The type of section. This defines how a section is displayed and people are selected. Allowed values are: '<code>person</code>' for a single person, '<code>multi</code>' for one or more people, or '<code>family</code>' for two people selected by a family.
* <code>title</code> : An optional title which This is used when displaying the section on the form and provides the only way to visually tell multiple sections apart. In a marriage you would have a "Husband", a "Wife" and possibly others such as "Witnesses".
<nowiki><section role='Primary' type='person' title='Child'></nowiki>
See existing [[Form Definitions]] for a current list.
 
==Issues==
See issues attached to the ''[https://gramps-project.org/bugs/tag_view_page.php?tag_id=257 Forms]'' tag.
<!--
===Feature Request===
* {{bug|}} :
-->
==See also==
* [https://en.wikipedia.org/wiki/Vital_record Vital records] From Wikipedia, the free encyclopedia
* [https://en.wikipedia.org/wiki/Census Census] From Wikipedia, the free encyclopedia
 
* [[Data Entry Gramplet]] addon that allows an easy method of editing previously added people, and adding new and related people in your family tree.
===Form Tutorials===
* Using the Form Gramplet, By Tim Graham, Photo Restorations by Tim G.** [https://www.youtube.com/watch?v=Y5hijkAF6eE Using the Form Gramplet] - Shows an older version of the Form addon (Published on Aug 4, 2016) <!-- video Note: Video says it can be installed on the Desktop Dashboard and or the Charts page but current version cannot-->.** [https://www.youtube.com/watch?v=NQL5shB9NzQ Defining Custom Forms for the Form Gramplet] - Shows an older version of the Form addon (Published on Aug 1, 2016)
4,529
edits

Navigation menu