References

From Gramps
Revision as of 05:20, 29 December 2019 by Bamaustin (talk | contribs) (References)
Jump to: navigation, search

References play a key role in how Gramps identifies relationships between records and objects.

Definition

References are the basic a system of linking relationships between objects in Gramps. When when an object is added in the Editor for record, a Reference (link) is created in the object that was added.

The extensive system of linking between objects in Gramps. When objects of Gramps are linked, the References tab lists the objects to link toward it.

Using the References tab

Most important Reference linkages

Viewing References

Gramplets

Fig .1 Person References Gramplet - detached example showing the active person's References

References Gramplet

  • Citation References built-in Gramplet : Gramplet showing the backlink references for a citation
  • Event References built-in Gramplet : Gramplet showing the backlink references for an event
  • Family References built-in Gramplet : Gramplet showing the backlink references for a family
  • Media References built-in Gramplet : Gramplet showing the backlink references for a media object
  • Note References built-in Gramplet : Gramplet showing the backlink references for a note
  • Person References built-in Gramplet : Gramplet showing the backlink references for a person
  • Place References built-in Gramplet : Gramplet showing the backlink references for a place
  • Repository References built-in Gramplet : Gramplet showing the backlink references for a repository
  • Source References built-in Gramplet : Gramplet showing the backlink references for a source


Fig .2 Quick View vs. Gramplet vs. Quick View Gramplet

There are several different methods for viewing the References data outside of the normal References tab interface. Each offers different benefits... and disadvantages if used inappropriately.

The screen capture to the left shows a stack of three views of Repository References layered together.

  • The Quick View (bordered in yellow) is opened from a contextual pop-up menu. The view is a static one. Once the Quick View window is opened for viewing, another record's Quick View can be opened for comparison in juxtaposition. The fact that that these Views are static allows hem to be used as a ToDo list without the confusion of constant context changes causing disorientation.
  • The References gramplet (bordered in red) was added in a Gramplet split screen section (whether sidebar or bottombar) of the Repository category View. And then the title tab is grabbed and dragged off that Gramplets split screen section. The Gramplets dynamically update this list to correspond with References of the active record. Most dramatically different capability is that the editor for these listed items may be opened by double-clicking.
  • The Quick View Gramplet is the third & bottomost layer of the stack of windows. It has been configured to select Repository from the View Type pop-up menu and Repository References from the Quick View pop-up menu to show the Reference. And then the Gramplet has been detached by grabbing the Title tab and dragging off the Gramplet split-screen section.

Note that the columns displayed in the Gramplet versus the Quick View are different. The Category Type and the Gramps ID is visible in the Gramplet but not the Quick View. Meanwhile, the Quick Views show additional detailed attributes.

Also note that detached Gramplets have a Help button linked to the appropriate section of the Gramps wiki. This is not accessible unless a Gramplet has been detached.

Fig .3 Repository References Quick View

Quick Views (called Quick Reports previous to Gramps 3.0 but continue to appear in "Available Gramps Update for Addons" as Quickreports) are reports that are available in the context menus of Primary Objects (person, family, ...) and Secondary Objects.

Quick Views

Gramps-notes.png

This article's content is incomplete or a placeholder stub.
Please update or expand this section.


  • Citation References built-in Quickreport : Display backlink references for a Source or Citation
  • Event References built-in Quick View : Display showing the backlink references for an event
  • Family References built-in Quick View : Display showing the backlink references for a family
  • Media References built-in Quick View : Display showing the backlink references for a media object
  • Note References built-in Quick View : Display showing the backlink references for a note
  • Person References built-in Quick View : Display showing the backlink references for the active person
  • Place References built-in Quick View : Display showing the backlink references for a place
  • Repository References built-in Quick View : Display the repository backlink references for sources related to the active repository
  • Source or Citation References built-in Quick View : Display backlink references for a Source or Citation
  • Source References built-in Quick View : Display backlink references for a Source

See also

External links