4,604
edits
Changes
m
{{stub}}
→Quick View
= What is a Gramplet? =
<span id="definition">
[[File:DashboardCategoryDashboardCategoryView-DashboardView-default-grampletsexample-50.png|right|thumb|400px450px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Dashboard Category (Default View)view]]
A [[Gramps_Glossary#gramplet|Gramplet]] is an expansion to the core Gramps program that '''hopefully''' works seamlessly as a built-in feature. Gramplets provide a supplemental perspective of the Tree data which either: changes dynamically during the navigation of the Gramps Tree, or; provides interactivity to your genealogical data.
Gramplets are the plug-ins (also called [http://wikipedia.org/wiki/Widget_engine widgets], plugins, add-onsaddons, auxiliary components) that become embedded as part of Gramps and can be found in the '''Dashboard Category''' ... or the '''Sidebars''' and '''Bottombars''' in other Navigator Categories. They provide all kinds of functionality that can be useful for the researcher.</span>
{{Man warn|Performance Drain|<i>'''Gramplets slow down Gramps and can use a lot of memory.'''</i><br>Close any docked Gramplets that will not be of immediate use. (It is not necessary to uninstall them with the Plugin Manager.) Closed Gramplets can be re-added as needed.}}
=== The split-screen Sidebar & Bottombar ===
[[File:Bottombar-sidebar-drop-down-menu-50.png|450px|thumb|right|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Gramplet split-screens showing [[Gramps_5.1_Wiki_Manual_-_Main_Window#Gramplet_Bar_Menu|Gramplet Bar Menu]] with the unlabeled ''Down Arrowhead'' {{man button|∨}} pull-down menu button]]
Each of these split screens screen panes is a container of stacked Gramplet tabs. Like Windows with a tabbed section, each can show only a single tab at a time. But tabs can be added, re-ordered, undocked or disabled in a similar fashion to the Dashboard. However, instead of a Contextual Menu, each split-pane {{man menu|[[Gramps_5.1_Wiki_Manual_-_Main_Window#Gramplet_Bar_Menu|Gramplet Bar Menu]]}} has a ''Down Arrowhead'' {{man button|∨}} pull-down menu button to show the same pop-up list of options.
To add a Gramplet to the stacked tabs, select it from the {{man menu|Gramplet Bar Menu {{man button|∨}} Add a gramplet}} submenu.
and many others. See [[Third-party Addons]] for more details.
= Summary of built-in Gramplets =
Summary of all default built-in Gramplets and the view categories in which each gramplet can be used.
''There are no Menu options to add a Gramplet. This is because it would be ambiguous whether the Gramplet was to be added to that view mode's sidebar or bottombar.''
{{-}}
==Built-in Gramplet List==Click a Category header (twice) to sort the list and show that category's menu of available built-in Gramplet choices. (The actual menu will also include installed [[5.1_Addons#Addon_List|3rd-party add-onaddon]] Gramplets.)
{| class="wikitable sortable"
|-
! Gramplet
! [[Image:22x22-gramps-gramplet.png]] <small>Dashboard</small>! [[Image:22x22-gramps-person.png]] <small>People</small>! [[Image:22x22-gramps-relation.png]] <small>Relationships</small>! [[Image:22x22-gramps-family.png]] <small>Families</small>! [[Image:22x22-gramps-pedigree.png]] <small>Charts</small>! [[Image:22x22-gramps-event.png]] <small>Events</small>! [[Image:22x22-gramps-place.png]] <small>Places</small>! [[Image:22x22-gramps-geo.png]] <small>Geography</small>! [[Image:22x22-gramps-source.png]] <small>Sources</small>! [[Image:22x22-gramps-citation.png]] <small>Citations</small>! [[Image:22x22-gramps-repository.png]] <small>Repositories</small>! [[Image:22x22-gramps-media.png]] <small>Media</small>! [[Image:22x22-gramps-notes.png]] <small>Notes</small>
|-
|<!-- Gramplet --> id="0" |{{man label|[[Gramps_5.1_Wiki_Manual_-_Gramplets#2-Way_Fan_Chart|2-Way Fan Chart]]}}
See also:
* [[Addon:NoteGramplet|Note Gramplet]] - Third party Addon
{{-}}
===Person Notes===
The Pedigree Gramplet shows a compressed view of the active person's direct ancestors. It defaults to going back 100 generations. The names can be clicked to change the active person, right-click to edit the person. At the bottom of the Gramplet the number of people per generation is listed. Birth and death dates are shown next to each person's name. Double-click the Generation number to see the matching individuals.
Using the the content of the Pedigree in another program requires a bit of effort Open a contextual pop-up menu by right-clicking anywhere in the gramplet except a hotlink. Or, you can begin a drag selection from the same inert areas. Copy the highlighted text the OS clipboard from that same context menu. (The keybinding for 'Copy' will not work.) When you paste the text into another text editing program, you may need change the font to a non-proportional font to preserve the indentation. Some online services collapse leading spaces when you post a chunk of text. Preserving the indentation for such services may require replacing doubled spaces with doubled placeholder characters... like periods/full stops.
====⚙ Configurable Options====
* Maximum generations: 1 to 100 limit; (default: ''100'')* Show Dates checkbox; (default: ''deselected'')* Line Type menu: <abbr title="Unicode Transformation Format graphical symbols">UTF</abbr>, <abbr title="American Standard Code for Information Interchange text symbols">ASCII</abbr>; (default: ''UTF'')
== Quick View ==
[[File:QuickView-Gramplet-Configuration-tabdetached-50.png|thumb|right|350px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Quick View Gramplet - detached example]]
The Quick View Gramplet allows you Quick View reports to run update dynamically. Instead of a Quick Viewwindow with a static report, it the gramplet updates as you move from person to persondifferent active record is selected within the target Category. (When this Gramplet was introduced, it only supported running offered choosing Quick Views View Reports from the People category. Other A Configuration pop-up menu to select View categories are now supportedhas since been added.)
You can run any of the built-in [[Gramps_5.1_Wiki_Manual_-_Reports_-_part_8#Quick_Views|Quick Views]] for a personor [[5.1_Addons#Addon_List|add-on]] QuickView reports.
{{-}}
[[File:QuickView-Gramplet-detachedConfiguration-tab-50.png|thumb|right|350px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Quick View Gramplet - Configuration tab shown]]
You can change the options by clicking the Option button (top, left hand button of the Gramplet) which will detach the Gramplet and bring it up an a window. Select {{man label|Options}} on the top row, and a list of options will appear. Press {{man button|Save}} to apply the changes to the Quick View. You may then close the window to reattach the Gramplet.
{{-}}
See the following developer information if you are interested in creating your own:
The What's Next Gramplet displays a list of the "most urgent" information gaps in your family tree. It is based on the following assumptions:
* You want The Home Person defines the focus* Searches for gaps begin with the Home Person's descendants and work up the tree * The tree is expected to know first and last contain the given name, surname, birth date and place, and death date and place of each person* You want to know father, motherparents, their marriage date and place, and - if divorced - divorce date and place of each family with married parents
* You want to know at least the mother of each family with unmarried parents
* The closer the relationship to the main personHome Person, the more "urgent" the information gap is.
* The closer the common ancestor is from the main person, the more "urgent" the information is (e.g. nephews are considered more "urgent" than uncles, even though both have a distance of 3 generations, because for nephews the common ancestor is father/mother, while for uncles, the common ancestor is grandfather/grandmother)
* Marriage data and personal data of the spouse is slightly less "urgent" than personal data of the directly related person
* Half -siblings are less "urgent" than siblings
You may copy the text from inside of this Gramplet by selecting it and pasting into an empty document.
