Difference between revisions of "Gramps 4.2 Wiki Manual - Entering and editing data: detailed - part 2"

From Gramps
Jump to: navigation, search
(Editing source citations)
m (Protected "Gramps 4.2 Wiki Manual - Entering and editing data: detailed - part 2": fix protection (lost after migration!) ([Edit=Allow only administrators] (indefinite) [Move=Allow only administrators] (indefinite)))
 
(107 intermediate revisions by 5 users not shown)
Line 1: Line 1:
{{grampsmanualcopyright}}
 
 
 
{{man index|Gramps 4.2 Wiki Manual - Entering and editing data: detailed - part 1|Gramps 4.2 Wiki Manual - Entering and editing data: detailed - part 3|4.2}}
 
{{man index|Gramps 4.2 Wiki Manual - Entering and editing data: detailed - part 1|Gramps 4.2 Wiki Manual - Entering and editing data: detailed - part 3|4.2}}
 
 
{{languages|Gramps_4.2_Wiki_Manual_-_Entering_and_Editing_Data:_Detailed_-_part_2}}
 
{{languages|Gramps_4.2_Wiki_Manual_-_Entering_and_Editing_Data:_Detailed_-_part_2}}
 
 
{{#vardefine:chapter|7.2}}
 
{{#vardefine:chapter|7.2}}
 
{{#vardefine:figure|0}}
 
{{#vardefine:figure|0}}
{{out of date}}
+
 
 
The previous section offered you a detailed overview of how to enter and edit data for people, relationships and dates. This section continues with other objects you encounter in Gramps.
 
The previous section offered you a detailed overview of how to enter and edit data for people, relationships and dates. This section continues with other objects you encounter in Gramps.
  
 
== Editing information about events ==
 
== Editing information about events ==
  
[[Image:EditEvent-Window-40.png|thumb|right|400px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Event editor]]
+
Adding an Event to a person allow you to provide information.
  
Events are edited through the {{man label|Event Editor}} dialog. This dialog can be accessed from either the {{man label|Edit Person}} dialog or the {{man label|Marriage/Relationship}} dialog.
+
When adding an event to the {{man label|Events}} Category, the {{man label|New Event}} dialog appears.
  
You can type this information directly into the adjacent fields.
+
{{-}}
 +
===New Event dialog===
  
The top part lets you view and edit basic information about the event:  
+
[[file:EditEvent-Window-40.png|thumb|right|400px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Event editor]]
# The {{man label|Type}} can be selected from the available types listed in the Event type drop-down menu. E.g., ''Burial'', ''Graduation'', etc.
 
# The {{man label|Date}} of the event can be an exact date, a range (''from ... to ..., between ...''), or an inexact date (''about ...'').
 
# The {{man label|Description}} field gives you the opportunity to give a longer description what this event is.
 
# The {{man label|ID}} is a unique identifier for the event. Leave this field blank to allow Gramps to generate this value automatically for new events.
 
# The {{man label|Place}} can be selected from a list of previously entered place or entered anew using the selection and add buttons. Additionally, you can drag and drop a place entry into this field.
 
  
Checking the Private record box marks the event record as private and allows it to be omitted from reports.
+
Events are edited through the {{man label|Event Editor}} dialog. This dialog can be accessed from either the {{man label|[[Gramps_4.2_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_1#Edit_Person_dialog|Edit Person]]}} dialog or the {{man label|Marriage/Relationship}} dialog.
  
The central part of the window displays five notebook tabs containing different categories of information. Click on a tab to view or edit its contents.  
+
The top part lets you view and edit basic information about the event:
 +
* The {{man label|Event type:}} can be selected from the available types listed in the Event type drop-down menu. E.g., '''Birth'''(default), Baptism, Death, Burial, etc. You can enter you own custom event type by typing directly into the this entry field.
 +
* The {{man label|Date:}} of the event can be an exact date, a range (''from ... to ..., between ...''), or an inexact date (''about ...'').
 +
** {{man button|Invoke date editor}} button starts the {{man label|Date selection}} dialog.
 +
* The {{man label|Description:}} field gives you the opportunity to give a longer description what this event is.
 +
** {{man button|Record is Public}} - Toggle the Privacy lock to mark the event record as private which allows it to be omitted from reports.
 +
* The {{man label|Place:}} can be selected from a list of previously entered place using the {{man button|Select an existing place}} button or entered anew using the {{man button|Add a new place}} button. Additionally, you can drag and drop a place entry into this field.
 +
* The {{man label|ID:}} is a unique identifier for the event. Leave this field blank to allow Gramps to generate this value automatically for new events.
 +
* The {{man label|Tags:}} allow you to select an existing tag using the {{man button|Edit the tag list}} button.
  
The tabs provide the following information categories of the event data:
+
===New Event tab pages===
 +
The central part of the window displays tabs containing different categories of information. Click on a tab to view or edit its contents. The tabs provide the following information categories of the event data:
  
*Source Citations
+
====Source Citations====
  
 
:The {{man label|Sources Citations}} tab lets you view and edit sources relevant to an event. The central part of the window lists all such source references stored in the database. The buttons {{man button|+ , Edit , and -}} let you add, modify, and remove a source reference associated with an event. Note that the {{man button|Edit}} and {{man button|-}} buttons become available only when a source reference is selected from the list.
 
:The {{man label|Sources Citations}} tab lets you view and edit sources relevant to an event. The central part of the window lists all such source references stored in the database. The buttons {{man button|+ , Edit , and -}} let you add, modify, and remove a source reference associated with an event. Note that the {{man button|Edit}} and {{man button|-}} buttons become available only when a source reference is selected from the list.
  
*Notes
+
====Notes====
  
 
:The {{man label|Notes}} tab provides a place to record notes or comments about the event. To add a note or modify existing notes simply edit the text in the text entry field.
 
:The {{man label|Notes}} tab provides a place to record notes or comments about the event. To add a note or modify existing notes simply edit the text in the text entry field.
  
*Gallery
+
====Gallery====
  
 
:The {{man label|Gallery}} tab
 
:The {{man label|Gallery}} tab
  
*Attributes
+
====Attributes====
  
 
:The {{man label|Attributes}} tab
 
:The {{man label|Attributes}} tab
  
*References
+
====References====
  
 
:The {{man label|References}} tab
 
:The {{man label|References}} tab
Line 57: Line 58:
  
 
{{-}}
 
{{-}}
 +
== Editing event references ==
 +
 +
Event references connect a Event to a person and allow you to provide additional information about the event.
  
== Editing event references ==
+
When adding event reference to a {{man label|[[Gramps_4.2_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_1#Events|Edit Person]]'s Events}} tab, the {{man label|Event Reference Editor}} dialog appears.
  
[[Image:PersonEventTab-EventReferenceEditor-40.png|right|thumb|400px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Event information]]
+
{{-}}
 +
===Event Reference Editor dialog===
  
Event references connect a Event to a person and allow you to provide additional information about the event.
+
{{man tip| Tip |Information in this dialog is specific to the particular reference. A single event can be referenced many times, and all such references will have in common the overall event information. This dialog lets you provide reference-specific data, such as relevant role, attribute to further specify and document the reference.}}
  
When adding event reference to a {{man label|Person}}s event tab, the following dialog appears:
+
[[Image:PersonEventTab-EventReferenceEditor-40.png|right|thumb|400px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Event information]]
  
The dialog includes two main headings, {{man label|Reference Information}} and {{man label|Shared Information}}.
+
The {{man label|New Citation}} dialog includes two sections, {{man label|Reference Information}} and {{man label|Shared Information}}.
 
* The {{man label|Reference Information}} section indicates the details associated with the particular reference to this Event: {{man label|General}}, {{man label|Notes}}, {{man label|Attributes}}.
 
* The {{man label|Reference Information}} section indicates the details associated with the particular reference to this Event: {{man label|General}}, {{man label|Notes}}, {{man label|Attributes}}.
 
* The {{man label|Shared Information}} displays : {{man label|General}}, {{man label|Source Citations}}, {{man label|Attributes}}, {{man label|Notes}}, {{man label|Gallery}}, {{man label|References}}.
 
* The {{man label|Shared Information}} displays : {{man label|General}}, {{man label|Source Citations}}, {{man label|Attributes}}, {{man label|Notes}}, {{man label|Gallery}}, {{man label|References}}.
  
For the role of the person in this event, use ''Primary'' for the main beneficiary, use a descriptive role otherwise (Eg., Witness, Celebrant, ...).
+
{{-}}
 +
====Reference Information ====
 +
 
 +
=====Reference Information tab pages =====
 +
 
 +
======General======
 +
For the {{man label|Role:}} of the person in this event, use '''Primary'''(default) for the main beneficiary, use a descriptive role otherwise (Eg., Witness, Celebrant, ...).
 +
{{-}}
 +
======Notes======
 +
 
 +
{{-}}
 +
======Attributes======
 +
 
 +
{{-}}
 +
====Shared Information ====
  
{{man tip| Tip |Information in this dialog is specific to the particular reference. A single event can be referenced many times, and all such references will have in common the overall event information. This dialog lets you provide reference-specific data, such as relevant role, attribute to further specify and document the reference.}}
+
{{-}}
 +
======General======
 +
{{man note|Note|Any changes in the shared event information will be reflected in the event itself, for all participants in the event.}}
 +
{{-}}
  
 +
======Source Citations======
 +
{{-}}
 +
======Attributes======
 +
{{-}}
 +
======Notes======
 +
{{-}}
 +
======Gallery======
 +
{{-}}
 +
======References======
 
{{-}}
 
{{-}}
  
 
== Editing information about media objects ==
 
== Editing information about media objects ==
  
 +
To add or edit media data, switch to the {{man label|Media}} Category View and select the desired entry in the list of media. Double-click on that entry or click {{man button|Edit}} on the toolbar to invoke the following {{man label|Media Properties Editor}} dialog.
 +
 +
===New Media dialog===
 
[[Image:EditMedia-MediaPropertiesEditorWindow-40.png|right|thumb|400px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Media properties editor]]
 
[[Image:EditMedia-MediaPropertiesEditorWindow-40.png|right|thumb|400px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Media properties editor]]
  
To edit media data, switch to the Media View and select the desired entry in the list of sources. Double-click on that entry or click {{man button|Edit}} on the toolbar to invoke the following {{man label|Media Properties Editor}} dialog:
+
The top section presents a thumbnail preview of the media object if available, along with a summary of its properties (ID, Date, Path and object type) that you can view and edit. You can type this information directly into the corresponding fields. For the Date, you can also enter information by clicking the {{man button|Invoke date editor}} button to invoke the '''{{man label|Date selection}}''' dialog.
  
A thumbnail preview of the object is presented, along with a summary of its properties (ID, path, date and object type).  
+
* A descriptive {{man label|Title:}} for this media object.
 +
* The {{man label|ID:}} is an unique record to identify the media object, leave blank to have it generated by Gramps.
 +
** Privacy toggle for this media object {{man label|Record is public}}(default) or {{man label|Record is private}}
 +
* {{man label|Date:}} a date associated with the media object eg: for a picture it could be the date it was taken.
 +
** {{man button|Invoke date editor}} button to invoke the '''{{man label|Date selection}}''' dialog.
 +
* {{man label|Path:}} of the media object on your computer. Gramps does not store the media internally, it only stores the path! Set the [[Gramps_4.2_Wiki_Manual_-_Settings#Preferences|Relative Path]] in the Preferences > General tab's {{man label|Base path for relative media paths:}} entry to avoid retyping the common base directory where all your media is stored. The [[Gramps_4.2_Wiki_Manual_-_Tools#Media_Manager|Media Manager]] tool can help managing paths of a collection of media objects.
 +
** {{man button|Open File Browser to select a media file on your computer.}} button.
 +
* {{man button|Edit the Tag list}} button.
  
# A descriptive {{man label|Title}} for this media object.
+
The bottom section of the window displays four notebook tabs containing different categories of information. Click a tab to view or edit its contents. The bottom part of the window has {{man button|Help}}, {{man button|Cancel}} and  {{man button|OK}} buttons. Clicking {{man button|OK}} will apply all the changes made in all tabs and close the dialog window. Clicking the {{man button|Cancel}} button will close the window without applying any changes. Pressing the {{man button|Help}} button will bring you here.
# The {{man label|ID}} is an unique record to identify the media object, leave generated by Gramps.
 
# {{man label|Date}} could be for a picture the date it is taken.  
 
# {{man label|Path}} of the media object on your computer. Gramps does not store the media internally, it only stores the path! Set the [[Gramps_4.2_Wiki_Manual_-_Settings#Preferences|Relative Path]] in the Preferences to avoid retyping the common base directory where all your media is stored. The [[Gramps_4.2_Wiki_Manual_-_Tools#Media_Manager...|Media Manager]] tool can help managing paths of a collection of media objects.
 
# {{man label|Mime}} value is the extension of the media object.
 
  
The central part of the window displays five notebook tabs containing different categories of information. Click a tab to view or edit its contents. The bottom part of the window has {{man button|OK}} and {{man button|Cancel}} buttons. Clicking {{man button|OK}} will apply all the changes made in all tabs and close the dialog window. Clicking the {{man button|Cancel}} button will close the window without applying any changes.
+
{{man note|Note|Every media object is referred to by its Path. The user is responsible for keeping track of the object files. Gramps will only reference and display the contents, not manage the files themselves.}}
  
 
{{man note|1=Note|2=Clicking {{man button|OK}} will immediately save changes to the database (write on disk). All changes are immediate.}}
 
{{man note|1=Note|2=Clicking {{man button|OK}} will immediately save changes to the database (write on disk). All changes are immediate.}}
  
{{man tip|Tip|If a tab label is in boldface type, this means it contains data. If not, it has no data.}}
+
===New Media tab pages ===
 +
{{man tip|Tip|If a tab label is in '''boldface''' type, this means it contains data. If not, it has no data.}}
  
 
The tabs represent the following categories of media data:
 
The tabs represent the following categories of media data:
  
*General
+
====Source Citations====
  
The {{man label|General}} tab lets you view and edit the object's Title and Date. You can type this information directly into the corresponding fields. For the Date, you can also enter information by clicking the LED button and invoking the '''Date selection''' dialog.
 
  
{{man note|Note|Every media object is referred to by its Path. The user is responsible for keeping track of the object files. Gramps will only reference and display the contents, not manage the files themselves.}}
+
====Attributes====
 
 
 
 
*Attributes
 
  
 
The {{man label|Attributes}} tab lets you view and edit particular information about the media object that can be expressed as Attributes. The bottom part displays the list of all such attributes stored in the database. The top part shows the details of the currently selected attribute in the list (if any). The buttons {{man button|+}} , {{man button|Edit}} , and {{man button|-}} let you add, modify, or remove an attribute. Note that the {{man button|Edit}} and {{man button|-}} buttons become available only when an attribute is selected from the list.
 
The {{man label|Attributes}} tab lets you view and edit particular information about the media object that can be expressed as Attributes. The bottom part displays the list of all such attributes stored in the database. The top part shows the details of the currently selected attribute in the list (if any). The buttons {{man button|+}} , {{man button|Edit}} , and {{man button|-}} let you add, modify, or remove an attribute. Note that the {{man button|Edit}} and {{man button|-}} buttons become available only when an attribute is selected from the list.
  
*Notes
+
====Notes====
  
 
The {{man label|Note}} tab provides a place to record various information about the source that does not fit neatly into other categories. This area is particularly useful for recording information that does not naturally fit into the "Parameter/Value" pairs available to Attributes. To add a note or modify existing notes simply edit the text in the text entry field.
 
The {{man label|Note}} tab provides a place to record various information about the source that does not fit neatly into other categories. This area is particularly useful for recording information that does not naturally fit into the "Parameter/Value" pairs available to Attributes. To add a note or modify existing notes simply edit the text in the text entry field.
  
*References
+
====References====
  
 
The {{man label|References}} tab indicates any database records that refer to a given media object. The list can be ordered according to any of its column headings: {{man label|Type}} , {{man label|ID}} , or {{man label|Name}}. Double-clicking an entry allows you to view and edit the corresponding record.
 
The {{man label|References}} tab indicates any database records that refer to a given media object. The list can be ordered according to any of its column headings: {{man label|Type}} , {{man label|ID}} , or {{man label|Name}}. Double-clicking an entry allows you to view and edit the corresponding record.
Line 123: Line 157:
 
== Editing media object references ==
 
== Editing media object references ==
  
[[Image:Mediaobj_ref_41.png|thumb|right|400px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Media Object references]]
+
When Media Object references connect a Media Object to an other object on a {{man label|[[Gramps_4.2_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_1#Gallery|Edit Person]]'s Gallery}} tab, the {{man label|Select a media object}} file selector from the {{man label|Media Reference Editor}} dialog appears so you can select the media object.
 +
{{-}}
 +
===Select a media object selector===
 +
 
 +
[[File:Select-a-media-object-file-selector-example-42.png|thumb|right|400px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Select a media object (File) selector - example]]
 +
 
 +
The {{man label|Select a media object}} file selector allow you to preview and select a media file you want to attach, and at the same time you may edit the shown {{man label|Title:}} (Defaults to the filename without the file extension).
 +
*{{checkbox|0}}{{man label|Convert to a relative path}} (checkbox unchecked by default until checked for the first time and remembered for each subsequent image selection.)
 +
{{-}}
 +
===Media Reference Editor dialog===
 +
 
 +
[[File:Media-reference-editor-default-42.png|thumb|right|400px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Media Reference Editor - (default)]]
 +
 
 +
The {{man label|Media Reference Editor}} dialog.
  
When Media Object references connect a Media Object to an other object, the following dialog appears:
+
{{-}}
 +
[[File:Media-reference-editor-shared-information-expanded-42.png|thumb|right|400px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Media Reference Editor - (Shared Information section expanded)]]
 +
 
 +
You may also expand the '''Shared Information''' section.
 +
{{-}}
 +
====Top section ====
 +
 
 +
=====Top section tab pages =====
 +
 
 +
======General======
  
 
* Region corners : x1, x2, y1, y2.
 
* Region corners : x1, x2, y1, y2.
Line 138: Line 194:
  
 
{{-}}
 
{{-}}
 +
======Source Citations======
 +
 +
{{-}}
 +
======Attributes======
 +
 +
{{-}}
 +
======Notes======
 +
 +
{{-}}
 +
====Shared Information ====
  
== Editing information about places ==
+
=====Shared Information tab pages =====
  
[[Image:EditPlaces-PlaceEditorWindow-41.png|right|thumb|right|400px| Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Place editor]]
+
======General======
  
To edit information about places, switch to the Places Category and select the desired entry from the list of places. Double-click that entry or click the {{man button|Edit}} button on the toolbar to bring up the following {{man label|Place Editor}} dialog:
+
{{-}}
 +
======References======
  
The following fields are available:
+
{{-}}
*{{man label|Title}}: the description of this place used in reports. Gramps will construct this for you.
+
======Source Citations======
*{{man label|Name}}: the name of this place.
 
*{{man label|Type}}: the place type.
 
*{{man label|Latitude}}: the position above equation of the place in decimal or degree notation. Eg, valid values are 12.0154, 50°52'21.92\"N, N50º52'21.92\" or 50:52:21.92. You can set these values via the Geography View by searching the place, or via a map service in the Place view.
 
*{{man label|Longitude}}: the position relative to the Prime, or Greenwich, Meridian of the place in decimal or degree notation. Eg, valid values are -124.3647, 124°52'21.92\"E, E124º52'21.92\" or 124:52:21.92. You can set these values via the Geography View by searching the place, or via a map service in the Place view.
 
*{{man label|ID}}: an unique record to identify the place. Leave generated by Gramps.
 
*{{man label|Code}}: a code for this place.  For example, an area code or postal code.
 
  
 
{{-}}
 
{{-}}
 +
======Attributes======
  
=== Supported longitude/latitude formats ===
+
{{-}}
 +
======Notes======
  
When you create/modify a place, the possible formats used for longitude/latitude are :
+
{{-}}
  
        'D.D4'    : degree notation, 4 decimals
+
== Editing information about places ==
                    eg +12.0154 , -124.3647
 
        'D.D8'    : degree notation, 8 decimals (precision like ISO-DMS)
 
                    eg +12.01543265 , -124.36473268
 
        'DEG'    : degree, minutes, seconds notation
 
                    eg 50°52'21.92"N , 124°52'21.92"E ° has UTF-8 code c2b00a
 
                    or N50º52'21.92" , E124º52'21.92" º has UTF-8 code c2ba0a
 
                    The character for seconds can be either one double quote "
 
                    or two single quote '
 
                    The letters N/S/W/E can be placed before or after the digits.
 
        'DEG-:'  : degree, minutes, seconds notation with :
 
                    eg -50:52:21.92 , 124:52:21.92
 
        'ISO-D'  : ISO 6709 degree notation i.e. ±DD.DDDD±DDD.DDDD
 
        'ISO-DM'  : ISO 6709 degree, minutes notation
 
                    i.e. ±DDMM.MMM±DDDMM.MMM
 
        'ISO-DMS' : ISO 6709 degree, minutes, seconds notation
 
                    i.e. ±DDMMSS.SS±DDDMMSS.SS
 
  
The second part of the window displays seven notebook tabs containing different categories of information. Click a tab to view or edit its contents. The bottom part of the window has {{man button|OK}} and {{man button|Cancel}} buttons. Clicking {{man button|OK}} will apply all the changes made in all tabs and close the dialog window. Clicking the {{man button|Cancel}} button will close the window without applying any changes.
+
To edit information about places, switch to the {{man label|Places}} Category and select the desired entry from the list of places. Double-click that entry or click the {{man button|Edit}} button on the toolbar to bring up the {{man label|[[Gramps_4.2_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_2#Place_Editor_dialog|Place Editor]]}} dialog:
  
 
{{-}}
 
{{-}}
 +
===Place Editor dialog===
  
{{man note|1=Note|2=Clicking {{man button|OK}} will immediately save changes to the database. All changes are immediate.}}
+
{{man note|Enhanced Place Editor in Gramps 4.2.0|See [[Gramps_4.2_Wiki_Manual_-_What's_new%3F#GUI|What's new?]]}}
 +
[[File:Place editor 42.png|right|thumb|right|400px| Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Place editor]]
 +
[[Image:EditPlaces-PlaceEditorWindow-41.png|right|thumb|right|400px| Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Place editor(old gramps 4.1]]
 +
 
 +
To edit information about places, switch to the Places Category and select the desired entry from the list of places. Double-click that entry or click the {{man button|Edit}} button on the toolbar to bring up the following {{man label|Place Editor}} dialog:
 +
 
 +
The following fields are available:
 +
*{{man label|Title}}: the description of this place used in reports. Gramps will construct this for you. See [[Gramps_4.2_Wiki_Manual_-_Settings#Places|Preferences > Places > Enable automatic place title generation]]
 +
*{{man label|Name:}} the name of this place.
 +
** {{man button|Invoke place name editor}} button opens the {{man label|Place Name Editor}} dialog where you can add/edit additional information.
 +
*{{man label|Type:}} the place type. All '''Custom''' entered '''Type'''s are shown at the bottom of the list. Choose from the following default available '''Types''':
 +
** Building
 +
** Borough
 +
** Country
 +
** County
 +
** City
 +
** Department
 +
** District
 +
** Farm
 +
** Hamlet
 +
** Locality
 +
** Municipality
 +
** Neighborhood
 +
** Number - See [[Gramps_4.2_Wiki_Manual_-_Settings#Places|Suppress comma after house number]]
 +
** Parish
 +
** Province
 +
** Region
 +
** State
 +
** Street
 +
** Town
 +
** '''Unknown'''(default)
 +
** Village
 +
*{{man label|Latitude:}} the position above equation of the place in decimal or degree notation. Eg, valid values are 12.0154, 50°52'21.92\"N, N50º52'21.92\" or 50:52:21.92. You can set these values via the Geography View by searching the place, or via a map service in the Place view.
 +
*{{man label|Longitude:}} the position relative to the Prime, or Greenwich, Meridian of the place in decimal or degree notation. Eg, valid values are -124.3647, 124°52'21.92\"E, E124º52'21.92\" or 124:52:21.92. You can set these values via the Geography View by searching the place, or via a map service in the Place view.
 +
** {{man button|Record is public/private}}
 +
*{{man label|ID:}} an unique record to identify the place. Leave generated by Gramps.
 +
*{{man label|Code:}} a code for this place.  For example, an area code or postal code.
 +
*{{man label|Tags:}}
 +
** {{man button|Edit the tag list}}
 +
{{-}}
  
 
===Place editor tab pages===
 
===Place editor tab pages===
 +
 +
{{man tip|Tip|If a tab label is in boldface type and displays an icon, this means it contains data. If not, it has no data.}}
  
 
The tabs represent the following categories of place data:
 
The tabs represent the following categories of place data:
  
{{man tip|Tip|If a tab label is in boldface type and displays an icon, this means it contains data. If not, it has no data.}}
+
====Enclosed By====
  
*Enclosed By
+
<!--[[File:xxxx.png|thumb|right|400px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} xxxx]]-->
  
 
:Places in Gramps are stored in a hierarchy. The {{man label|Enclosed By}} tab allows you to link this place to other places, higher in the hierarchy, which enclose it.  Each link consists of a place and an optional date range. The buttons {{man button|+}} , {{man button|Edit}} , and {{man button|-}} let you add, modify, and remove a link. Note that the {{man button|Edit}} and {{man button|-}} buttons become available only when a link is selected from the list. In general, a country will be a top level place, and will not be linked to any other place.
 
:Places in Gramps are stored in a hierarchy. The {{man label|Enclosed By}} tab allows you to link this place to other places, higher in the hierarchy, which enclose it.  Each link consists of a place and an optional date range. The buttons {{man button|+}} , {{man button|Edit}} , and {{man button|-}} let you add, modify, and remove a link. Note that the {{man button|Edit}} and {{man button|-}} buttons become available only when a link is selected from the list. In general, a country will be a top level place, and will not be linked to any other place.
 +
{{-}}
 +
=====Select Place selector=====
 +
 +
<!--[[File:xxxx.png|thumb|right|400px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Select Place - selector]]-->
 +
 +
The {{man label|Select Place}} selector dialog allows you to link to an already existing place and once selected it will be opened in the {{man label|Place Reference Editor}}
 +
 +
You may use the {{man button|Find}} button to filter the list based on one of the options from the drop down list:
 +
* '''Name contains''' (default)
 +
{{-}}
 +
=====Place Reference Editor=====
 +
 +
<!--[[File:xxxx.png|thumb|right|400px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Place Reference Editor - dialog]]-->
 +
 +
{{man label|Place Reference Editor}}
 +
{{-}}
  
*Alternative Names
+
====Alternative Names====
  
 
:The {{man label|Alternative Names}} tab lets you view and edit other names by which the place might be known. The tab lists all other names of the place stored in the database. The buttons {{man button|+}} , {{man button|Edit}} , and {{man button|-}} let you add, modify, and remove a name record. Note that the {{man button|Edit}} and {{man button|-}} buttons become available only when a name is selected from the list.
 
:The {{man label|Alternative Names}} tab lets you view and edit other names by which the place might be known. The tab lists all other names of the place stored in the database. The buttons {{man button|+}} , {{man button|Edit}} , and {{man button|-}} let you add, modify, and remove a name record. Note that the {{man button|Edit}} and {{man button|-}} buttons become available only when a name is selected from the list.
  
*Source Citations
+
{{man note|Note|Seeing a question <code>?</code> mark means that you may have a problem in the naming variants of that place. There may be some places which have different names for the same date range and language. Overlapping date ranges are valid. The place displayer will use the first matching name.}}
 +
 
 +
====Source Citations====
  
 
:The {{man label|Source Citations}} tab lets you view and edit sources relevant to a place. The central part of the window lists all such source references stored in the database. The buttons {{man button|+}} , {{man button|Edit}} , and {{man button|-}} let you add, modify, and remove a source reference associated with a place. Note that the {{man button|Edit}} and {{man button|-}} buttons become available only when a source reference is selected from the list.
 
:The {{man label|Source Citations}} tab lets you view and edit sources relevant to a place. The central part of the window lists all such source references stored in the database. The buttons {{man button|+}} , {{man button|Edit}} , and {{man button|-}} let you add, modify, and remove a source reference associated with a place. Note that the {{man button|Edit}} and {{man button|-}} buttons become available only when a source reference is selected from the list.
  
*Notes
+
====Notes====
  
 
:The {{man label|Notes}} tab displays any comments or notes concerning the place. To add a note or modify existing notes simply edit the text in the text entry field.
 
:The {{man label|Notes}} tab displays any comments or notes concerning the place. To add a note or modify existing notes simply edit the text in the text entry field.
  
*Gallery
+
====Gallery====
  
 
:The {{man label|Gallery}} tab lets you store and display photos and other media objects associated with a given place. The central part of the window lists all such media objects and gives you a thumbnail preview of image files. Other objects such as audio files, movie files, etc., are represented by a generic Gramps icon. The buttons {{man button|+}} , {{man button|Select}} , {{man button|Edit}} , and {{man button|-}} let you add a new image, add a reference to an existing image, modify an existing image, and remove a media object's link to the place. Note that the {{man button|Edit}} and {{man button|-}} buttons become available only when a media object is selected from the list.
 
:The {{man label|Gallery}} tab lets you store and display photos and other media objects associated with a given place. The central part of the window lists all such media objects and gives you a thumbnail preview of image files. Other objects such as audio files, movie files, etc., are represented by a generic Gramps icon. The buttons {{man button|+}} , {{man button|Select}} , {{man button|Edit}} , and {{man button|-}} let you add a new image, add a reference to an existing image, modify an existing image, and remove a media object's link to the place. Note that the {{man button|Edit}} and {{man button|-}} buttons become available only when a media object is selected from the list.
  
*Internet
+
====Internet====
  
 
:The {{man label|Internet}} tab contains Internet addresses relevant to the place. The bottom part of the window lists all such Internet addresses stored in the database. The top part shows the details of the currently selected address in the list (if any). The buttons {{man button|+}} , {{man button|Edit}} , and {{man button|-}} let you add, modify, and remove an Internet address. The {{man button|Go}} button (represented by an icon with a green arrow and yellow circle) opens your browser and takes you to the web page corresponding to the highlighted Internet address. Note that the {{man button|Edit}} , {{man button|-}} , and {{man button|Go}} buttons become available only when an address is selected from the list.
 
:The {{man label|Internet}} tab contains Internet addresses relevant to the place. The bottom part of the window lists all such Internet addresses stored in the database. The top part shows the details of the currently selected address in the list (if any). The buttons {{man button|+}} , {{man button|Edit}} , and {{man button|-}} let you add, modify, and remove an Internet address. The {{man button|Go}} button (represented by an icon with a green arrow and yellow circle) opens your browser and takes you to the web page corresponding to the highlighted Internet address. Note that the {{man button|Edit}} , {{man button|-}} , and {{man button|Go}} buttons become available only when an address is selected from the list.
  
*References
+
====References====
  
 
:The {{man label|References}} tab indicates any database records (events or LDS ordinances) that refer to a place. This information cannot be modified from the {{man label|Place Editor}} dialog. Instead, the corresponding database record (e.g., a birth event) has to be brought up and its place reference edited.
 
:The {{man label|References}} tab indicates any database records (events or LDS ordinances) that refer to a place. This information cannot be modified from the {{man label|Place Editor}} dialog. Instead, the corresponding database record (e.g., a birth event) has to be brought up and its place reference edited.
  
 
{{-}}
 
{{-}}
 +
=== Place Name Editor dialog ===
 +
 +
{{man note|New Feature added in Gramps 4.2.0|New Place Name editor. See [[Gramps_4.2_Wiki_Manual_-_What's_new%3F#Place|What's new?]]}}
 +
[[File:Place name editor.png|right|thumb|right|400px| Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Place Name Editor]]
 +
 +
You can access the {{man label|Place Name Editor}} dialog from the {{man label|[[Gramps_4.2_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_2#Place_Editor_dialog|Place Editor]]}} dialogs {{man button|Invoke place name editor}} button.
 +
 +
The {{man label|Place Name Editor}} dialog allows you to add/edit the following information:
 +
* {{man label|Name:}} the name of the place
 +
* {{man label|Date:}} Date range in which the place is valid
 +
** {{man button|Invoke the date editor}} button
 +
* {{man label|Language:}} Language in which the name is written. Valid values are two character ISO codes for example: en,fr, de, nl.  See Wikipedia for the full list of valid [https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes  ISO 639-1] codes.
 +
{{-}}
 +
 +
=== Supported longitude/latitude formats ===
 +
 +
When you create/modify a place, the possible formats used for longitude/latitude are :
 +
 +
        'D.D4'    : degree notation, 4 decimals
 +
                    eg +12.0154 , -124.3647
 +
        'D.D8'    : degree notation, 8 decimals (precision like ISO-DMS)
 +
                    eg +12.01543265 , -124.36473268
 +
        'DEG'    : degree, minutes, seconds notation
 +
                    eg 50°52'21.92"N , 124°52'21.92"E ° has UTF-8 code c2b00a
 +
                    or N50º52'21.92" , E124º52'21.92" º has UTF-8 code c2ba0a
 +
                    The character for seconds can be either one double quote "
 +
                    or two single quote '
 +
                    The letters N/S/W/E can be placed before or after the digits.
 +
        'DEG-:'  : degree, minutes, seconds notation with :
 +
                    eg -50:52:21.92 , 124:52:21.92
 +
        'ISO-D'  : ISO 6709 degree notation i.e. ±DD.DDDD±DDD.DDDD
 +
        'ISO-DM'  : ISO 6709 degree, minutes notation
 +
                    i.e. ±DDMM.MMM±DDDMM.MMM
 +
        'ISO-DMS' : ISO 6709 degree, minutes, seconds notation
 +
                    i.e. ±DDMMSS.SS±DDDMMSS.SS
  
 +
The second part of the window displays seven notebook tabs containing different categories of information. Click a tab to view or edit its contents. The bottom part of the window has {{man button|OK}} and {{man button|Cancel}} buttons. Clicking {{man button|OK}} will apply all the changes made in all tabs and close the dialog window. Clicking the {{man button|Cancel}} button will close the window without applying any changes.
 +
 +
{{man note|1=Note|2=Clicking {{man button|OK}} will immediately save changes to the database. All changes are immediate.}}
 +
{{-}}
 
== Editing information about sources ==
 
== Editing information about sources ==
  
[[Image:EditSource-SourceEditorWindow-40.png|thumb|right|400px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Source editor]]
+
Once you have selected a source, or if you had chosen the {{icon|stock_add}} {{man button|+}} or {{icon|stock_edit}} {{man button|Edit}} buttons, then the {{man label|New Source}} dialog appears.
  
The general information at the top of the window lets you define basic information about the source: its {{man label|Title}} , {{man label|Author}} , {{man label|Abbreviation}} , and {{man label|Publication information}} . You can type this information directly into the adjacent fields.
+
===New Source dialog===
  
#{{man label|Title}}: Title of the source.
+
[[File:EditSource-SourceEditorWindow-42-en.png|thumb|right|400px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Source editor]]
#{{man label|Authors}}: Authors of the source.
 
#{{man label|ID}}: an unique record to identify the source. Leave generated by Gramps.
 
#{{man label|Abbreviations}}: Provide a short title used for sorting, filing, and retrieving source records.
 
#{{man label|Publication information}}: Publication Information, such as city and year of publication, name of publisher, ...
 
  
 +
For the {{man label|New Source}} dialog the general information at the top of the window lets you define basic information about the source: its {{man label|Title}} , {{man label|Author}} , {{man label|Abbreviation}} , and {{man label|Publication information}} . You can type this information directly into the adjacent fields.
 +
 +
*{{man label|Title:}} Title of the source.
 +
*{{man label|Authors:}} Authors of the source.
 +
*{{man label|Pub. info.:}} Publication Information, such as city and year of publication, name of publisher, ...
 +
*{{man label|Abbreviation:}} Provide a short title used for sorting, filing, and retrieving source records.
 +
** {{man button|Record is public/private}} Lock icon toggle.
 +
*{{man label|ID:}} an unique record to identify the source. Leave generated by Gramps.
 +
*{{man label|Tags:}}
 +
** {{man button|Edit the tag list}}
 +
{{-}}
 +
 +
===New Source tab pages===
 
The tabs provide the following information categories of source data:
 
The tabs provide the following information categories of source data:
  
*Notes
+
====Notes====
  
 
:The {{man label|Notes}} tab provides a place to record notes or comments about the source. To add a note or modify existing notes simply edit the text in the text entry field. Only primary objects can be shown in the {{man label|References}} tab: Person, Family, Event, Place, or Media object. Secondary objects such as Names and Attributes can only be accessed through the primary objects to which they belong.
 
:The {{man label|Notes}} tab provides a place to record notes or comments about the source. To add a note or modify existing notes simply edit the text in the text entry field. Only primary objects can be shown in the {{man label|References}} tab: Person, Family, Event, Place, or Media object. Secondary objects such as Names and Attributes can only be accessed through the primary objects to which they belong.
  
*Gallery
+
====Gallery====
  
 
:The {{man label|Gallery}} tab lets you store and display photos and other media objects associated with a given source (for example, a photo of a birth certificate). The central part of the window lists all such objects and gives you a thumbnail preview of image files. Other objects such as audio files, movie files, etc., are represented by a generic Gramps icon. The buttons {{man button|+}} , {{man button|Select}} , {{man button|Edit}} , and {{man button|-}} let you add a new image, add a reference to an existing image, modify an existing image, and remove a media object's link to the relationship. Note that the {{man button|Edit}} and {{man button|-}} buttons become available only when a media object is selected from the list.
 
:The {{man label|Gallery}} tab lets you store and display photos and other media objects associated with a given source (for example, a photo of a birth certificate). The central part of the window lists all such objects and gives you a thumbnail preview of image files. Other objects such as audio files, movie files, etc., are represented by a generic Gramps icon. The buttons {{man button|+}} , {{man button|Select}} , {{man button|Edit}} , and {{man button|-}} let you add a new image, add a reference to an existing image, modify an existing image, and remove a media object's link to the relationship. Note that the {{man button|Edit}} and {{man button|-}} buttons become available only when a media object is selected from the list.
  
*Data
+
====Attributes====
  
:The {{man label|Data}} tab displays "Key/Value" pairs that may be associated with the source. These are similar to the "Attributes" used for other types of Gramps records. The difference between these Key/Value pairs and Attributes is that Attributes may have source references and notes, while Key/Value data may not.
+
:The {{man label|Attributes}} tab displays "Key/Value" pairs that may be associated with the source. These are similar to the "Attributes" used for other types of Gramps records. The difference between these Key/Value pairs and Attributes is that Attributes may have source references and notes, while Key/Value data may not.
  
 
:The central part of the window lists all existing Key/Value pairs. The buttons {{man button|+}} and {{man button|-}} let you add and remove pairs. To modify the text of Key or Value, first select the desired entry. Then click in either the Key or Value cell of that entry and type your text. When you are done, click outside the cell to exit editing mode.
 
:The central part of the window lists all existing Key/Value pairs. The buttons {{man button|+}} and {{man button|-}} let you add and remove pairs. To modify the text of Key or Value, first select the desired entry. Then click in either the Key or Value cell of that entry and type your text. When you are done, click outside the cell to exit editing mode.
  
*Repositories
+
====Repositories====
 +
 
 +
<!--[[File:xxxx.png|thumb|right|400px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} xxx]]-->
  
 
:The {{man label|Repositories}} tab displays the references to the repositories in which the source is contained. The list can be ordered by any of its column headings: {{man label|ID}} , {{man label|Title}}, {{man label|Call Number}},and {{man label|Type}}. Double-clicking an entry allows you to view and edit the record. You may also edit the reference. The buttons on the side of the tab allow you add a new repository, link to (or share) an existing repository, edit the reference to the repository, or remove the reference.
 
:The {{man label|Repositories}} tab displays the references to the repositories in which the source is contained. The list can be ordered by any of its column headings: {{man label|ID}} , {{man label|Title}}, {{man label|Call Number}},and {{man label|Type}}. Double-clicking an entry allows you to view and edit the record. You may also edit the reference. The buttons on the side of the tab allow you add a new repository, link to (or share) an existing repository, edit the reference to the repository, or remove the reference.
 +
{{-}}
 +
=====Select Repository selector=====
 +
 +
<!--[[File:xxxx.png|thumb|right|400px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Select Event - selector]]-->
 +
 +
The {{man label|Select Repository}} selector dialog allows you to link to an already existing repositories and once selected it will be opened in the {{man label|Repository Reference Editor}}
 +
 +
You may use the {{man button|Find}} button to filter the list based on one of the options from the drop down list:
 +
* '''Title contains''' (default)
 +
{{-}}
  
*References
+
====References====
  
 
:The {{man label|References}} tab lists all the database records that refer to this source, if any. The list can be ordered by any of its column headings: {{man label|Type}} , {{man label|ID}} , or {{man label|Name}}. Double-clicking an entry allows you to view and edit the record.
 
:The {{man label|References}} tab lists all the database records that refer to this source, if any. The list can be ordered by any of its column headings: {{man label|Type}} , {{man label|ID}} , or {{man label|Name}}. Double-clicking an entry allows you to view and edit the record.
  
 
{{-}}
 
{{-}}
 
 
== Editing source citations ==
 
== Editing source citations ==
  
Line 279: Line 445:
 
=== Select Source or Citation selector===
 
=== Select Source or Citation selector===
  
[[Image:Source_or_citation_selector_34.png|thumb|400px|right|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Source or citation selector]]
+
[[File:Select-source-or-citation-selector-42.png|thumb|400px|right|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Select Source or Citation - selector]]
  
 
When {{icon|stock_add}} {{man button|Add}} adding an existing citation or source, the {{man label|Select Source or Citation}} dialog appears
 
When {{icon|stock_add}} {{man button|Add}} adding an existing citation or source, the {{man label|Select Source or Citation}} dialog appears
Line 285: Line 451:
 
This allows either an existing source or an existing citation (along with its associated source) to be selected. Click on the disclosure triangle alongside a source to see the citations associated with that source. For example, if one of your sources were a book, then the citations would normally refer to a page (or pages) within the book. If you already have a citation that refer to the particular page of the book, then you could select that citation which would then be shared. On the other hand, if this object needs to refer to a new page, then you would select the source and in the subsequent dialog enter the new page.
 
This allows either an existing source or an existing citation (along with its associated source) to be selected. Click on the disclosure triangle alongside a source to see the citations associated with that source. For example, if one of your sources were a book, then the citations would normally refer to a page (or pages) within the book. If you already have a citation that refer to the particular page of the book, then you could select that citation which would then be shared. On the other hand, if this object needs to refer to a new page, then you would select the source and in the subsequent dialog enter the new page.
  
 +
Use the search field to {{man button|Find}} a source or citation based on one of the following:
 +
* '''Source: Title or Citation: Volume/Page contains'''(default)
 +
* Source: Title or Citation: Volume/Page does not contain
 +
* ID contains
 +
* ID does not contain
 +
* Last Change contains
 +
* Last Change does not contain
 
{{-}}
 
{{-}}
 
===New Citation dialog===
 
===New Citation dialog===
Line 292: Line 465:
 
Once you have selected a citation or a source, or if you had chosen the {{icon|stock_add}} {{man button|+}} or {{icon|stock_edit}} {{man button|Edit}} buttons, then the {{man label|New Citation}} dialog appears.
 
Once you have selected a citation or a source, or if you had chosen the {{icon|stock_add}} {{man button|+}} or {{icon|stock_edit}} {{man button|Edit}} buttons, then the {{man label|New Citation}} dialog appears.
  
The {{man label|New Citation}} dialog includes two main headings, {{man label|Citation information}} and {{man label|Shared source information}}.
+
The {{man label|New Citation}} dialog includes two sections, {{man label|Citation information}} and {{man label|Shared source information}}.
 
+
{{-}}
 +
====Citation information====
 
The {{man label|Citation information}} section indicates the details associated with the particular reference to this Source: {{man label|Confidence}}, {{man label|Volume/Page}}, {{man label|Date}}, and {{man label|Notes}}. You can choose the Confidence level from the {{man label|Confidence}} drop-down menu. The remaining details can be typed in the corresponding text entry fields.
 
The {{man label|Citation information}} section indicates the details associated with the particular reference to this Source: {{man label|Confidence}}, {{man label|Volume/Page}}, {{man label|Date}}, and {{man label|Notes}}. You can choose the Confidence level from the {{man label|Confidence}} drop-down menu. The remaining details can be typed in the corresponding text entry fields.
  
Line 311: Line 485:
 
[[Image:EditCitation-NewCitationWindow-40_2.png|thumb|400px|right|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} New Citation editor since version ''4.2.4'']]
 
[[Image:EditCitation-NewCitationWindow-40_2.png|thumb|400px|right|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} New Citation editor since version ''4.2.4'']]
  
===New Citation tab pages===
+
=====Citation information section tab pages=====
 
The tabs provide the following information categories of citation data:
 
The tabs provide the following information categories of citation data:
  
Line 332: Line 506:
 
The {{man label|References}} tab lists all the database records that refer to this source, if any. The list can be ordered by any of its column headings: {{man label|Type}} , {{man label|ID}} , or {{man label|Name}}. Double-clicking an entry allows you to view and edit the record.
 
The {{man label|References}} tab lists all the database records that refer to this source, if any. The list can be ordered by any of its column headings: {{man label|Type}} , {{man label|ID}} , or {{man label|Name}}. Double-clicking an entry allows you to view and edit the record.
  
=== Shared source information ===
+
{{-}}
 +
==== Shared source information ====
  
{{man label|Shared Source Information}} displays the {{man label|Title}} of the Source, its {{man label|Author}} , {{man label|Abbreviation}} and {{man label|Publication information}} . A warning icon {{icon|stock_warn}} is displayed if the source is shared. Editing the source information in this dialog is just the same as [[Gramps_4.2_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_2#Editing_information_about_sources|editing infomation about sources]] (q.v.).
+
{{man label|Shared Source Information}} displays the {{man label|Title}} of the Source, its {{man label|Author}} , {{man label|Abbreviation}} and {{man label|Publication information}} .  
  
 +
'''A warning icon {{icon|stock_warn}} is displayed if the source is shared.'''
 +
 +
Editing the source information in this dialog is just the same as [[Gramps_4.2_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_2#Editing_information_about_sources|editing information about sources]]
 +
 +
{{-}}
 
== Editing information about repositories ==
 
== Editing information about repositories ==
  
The fields shown at the top are:
+
Once you have selected a source, or if you had chosen the {{icon|stock_add}} {{man button|+}} or {{icon|stock_edit}} {{man button|Edit}} buttons, then the {{man label|New Repositories}} dialog appears.
* The {{man label|Name}} of the repository (where sources are stored).
+
 
* {{man label|ID}}: an unique record to identify the repository. Leave generated by Gramps.
+
=== New Repositories dialog ===
* The {{man label|Type}} of repository, eg., Library, Album, ...
 
  
 
[[Image:EditRepository-AddRepositoryWindow-40.png|thumb|right|400px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Repository editor]]
 
[[Image:EditRepository-AddRepositoryWindow-40.png|thumb|right|400px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Repository editor]]
  
The four tabs represent the following categories of repository data:  
+
The following fields are shown:
 +
* {{man label|Name:}} of the repository (where sources are stored).
 +
* {{man label|Type:}} of repository, eg., '''Library'''(default), Album, ...
 +
* {{man label|ID}}: an unique record to identify the repository. Leave generated by Gramps.
 +
** {{man button|Record is public/private}} Lock icon toggle.
 +
*{{man label|Tags:}}
 +
** {{man button|Edit the tag list}}
 +
{{-}}
 +
=== New Repositories tab pages ===
 +
The tabs represent the following categories of repository data:  
  
*Addresses:
+
====Addresses====
 
:The {{man label|Addresses}} tab lets you view and record the various addresses of the repository.  
 
:The {{man label|Addresses}} tab lets you view and record the various addresses of the repository.  
  
 
:The bottom part of the window lists all addresses stored in the database. The top part shows the details of the currently selected address in the list (if any). The buttons {{man button|+}} , {{man button|Edit}} , and {{man button|-}} allow you to correspondingly add, modify, and remove an address record from the database. Note that the {{man button|Edit}} and {{man button|-}} buttons become available only when an address is selected from the list.
 
:The bottom part of the window lists all addresses stored in the database. The top part shows the details of the currently selected address in the list (if any). The buttons {{man button|+}} , {{man button|Edit}} , and {{man button|-}} allow you to correspondingly add, modify, and remove an address record from the database. Note that the {{man button|Edit}} and {{man button|-}} buttons become available only when an address is selected from the list.
  
*Internet:
+
====Internet====
 
:The {{man label|Internet}} tab displays Internet addresses relevant to the repository. The bottom part lists all such Internet addresses and accompanying descriptions. The top part shows the details of the currently selected addresses in the list (if any). The buttons {{man button|+}} , {{man button|Edit}} , and {{man button|-}} let you add, modify, and remove an Internet address. The "Go" button (represented by an icon having a green arrow and yellow circle) opens your web browser and takes you directly to the highlighted page. Note that the {{man button|Edit}} , and {{man button|-}}buttons become available only when an address is selected from the list.
 
:The {{man label|Internet}} tab displays Internet addresses relevant to the repository. The bottom part lists all such Internet addresses and accompanying descriptions. The top part shows the details of the currently selected addresses in the list (if any). The buttons {{man button|+}} , {{man button|Edit}} , and {{man button|-}} let you add, modify, and remove an Internet address. The "Go" button (represented by an icon having a green arrow and yellow circle) opens your web browser and takes you directly to the highlighted page. Note that the {{man button|Edit}} , and {{man button|-}}buttons become available only when an address is selected from the list.
  
*Notes
+
====Notes====
 
 
 
:The {{man label|Notes}} tab provides a place to record notes or comments about the repository. To add a note or modify existing notes simply edit the text in the text entry field.
 
:The {{man label|Notes}} tab provides a place to record notes or comments about the repository. To add a note or modify existing notes simply edit the text in the text entry field.
  
*References
+
====References====
 
 
 
:The {{man label|References}} tab indicates any database records that refer to a given repository. The list can be ordered according to any of its column headings: {{man label|Type}} , {{man label|ID}} , or {{man label|Name}} . Double-clicking an entry allows you to view and edit the corresponding record.
 
:The {{man label|References}} tab indicates any database records that refer to a given repository. The list can be ordered according to any of its column headings: {{man label|Type}} , {{man label|ID}} , or {{man label|Name}} . Double-clicking an entry allows you to view and edit the corresponding record.
  
 
{{-}}
 
{{-}}
 +
== Editing information about notes ==
  
== Editing information about notes ==
+
Once you have selected a source, or if you had chosen the {{icon|stock_add}} {{man button|+}} or {{icon|stock_edit}} {{man button|Edit}} buttons, then the {{man label|New Note}} dialog appears.
  
 
=== Note tab ===
 
=== Note tab ===
Line 373: Line 560:
 
=== Note editor ===
 
=== Note editor ===
  
[[Image:EditNotes-NoteEditorWindow-40.png|thumb|right|400px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Note editor]]
+
[[File:EditNotes-NoteEditorWindow-42.png|thumb|right|400px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Note editor]]
  
When creating a new note, or when editing an existing note, the note editor comes up. There are two tabs, the 'Note' tab, and the 'References' tab.  
+
When creating a new note, or when editing an existing note, the note editor appears. There are two tabs, the '''Note''' tab, and the '''References''' tab.  
  
* Note tab
+
==== Note tab ====
  
 
The Note tab has the following elements
 
The Note tab has the following elements
 
:* A toolbar to apply styles to your notes. You can select and apply one of the toolbuttons, or set the values as you want and start typing.
 
:* A toolbar to apply styles to your notes. You can select and apply one of the toolbuttons, or set the values as you want and start typing.
::* Undo, Redo:
+
::* Italic : common function known from text editors
::* italic, bold, underline: common functions known from text editors
+
::* Bold : common function known from text editors
::* Font selection: a basic font selector showing all fonts on your system.  
+
::* Underline : common function known from text editors
::* Font size: the size of the font you type
+
::* Undo : Undoes last action.
::* Font color: write the font in a certain color
+
::* Redo : Re-applies last action.
::* Background color: add a background color to the text you write
+
::* Font selection drop down list: a basic font selector showing all fonts installed on your operating system.
::* Clear markup: This will remove all markup you have placed on the note
+
::* Font size: select the size of the font to use for your text.
::* Link: This will allow you to create a link to an item in Gramps, such as a Person, Family, Event, Note, etc.
+
::* Font color: select the color of your font.
 
+
::* Background color: adds a background color to the text you enter.
{{-}}
+
::* Link: Opens the {{man label|[[Gramps_4.2_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_2#Link_Editor|Link Editor]]}} allowing you to create an internal link to an item in Gramps, such as a Person, Family, Event, Note, etc.
 +
::* Clear Markup: Highlight the text to remove markup you have placed on the note.
  
 
{{man tip|Important|If you want to revert to a previous version of a note after you save it, there is an Undo/Redo feature for notes (just like other items). Go to {{man menu|menu -> Redo, Undo, or Undo History}}.}}
 
{{man tip|Important|If you want to revert to a previous version of a note after you save it, there is an Undo/Redo feature for notes (just like other items). Go to {{man menu|menu -> Redo, Undo, or Undo History}}.}}
Line 400: Line 588:
  
 
:* Some properties of your note
 
:* Some properties of your note
::* {{man label|ID}}: a unique id for the note. If left blank an automatic id will be chosen according to the settings in the preferences
+
::* {{man label|Preformatted}} checkbox: Notes in Gramps are considered flowed for beautiful presentation in the reports. In this setting, newlines and white spaces will be automatically ignored so as to form complete paragraphs, which are defined by an empty line between two textblocks. When {{man label|Preformatted}} is checked, Gramps will assume the whitespace and enters you used in the notes are important. Use this for tables, literal transcripts, ... . Use monospace font to keep preformatting. Try not to use preformatted if you do not need it, the reports you create will be more beautiful.
 +
::* {{man button|Make public/private}} Privacy on the other objects, you can indicate a note as private so as to make sure you can remove this note from all output Gramps creates with one easy click.
 +
::* {{man label|ID:}} a unique id for the note. If left blank an automatic id will be chosen according to the settings in the preferences
 +
::* {{man label|Type:}} (<code>General</code> default) The note type. You can add your own value by typing it
 
::* {{man label|Tags:}} Select a Tag for the note: Complete, Todo etc... You can add your own Tags by typing it
 
::* {{man label|Tags:}} Select a Tag for the note: Complete, Todo etc... You can add your own Tags by typing it
::* {{man label|Type}}: a note type. You can add your own value by typing it
+
{{-}}
::* {{man label|Preformatted}} checkbox: Notes in Gramps are considered flowed for beautiful presentation in the reports. In this setting, newlines and white spaces will be automatically ignored so as to form complete paragraphs, which are defined by an empty line between two textblocks. When {{man label|Preformatted}} is checked, Gramps will assume the whitespace and enters you used in the notes are important. Use this for tables, literal transcripts, ... . Use monospace font to keep preformatting. Try not to use preformatted if you do not need it, the reports you create will be more beautifull.
 
::* {{man label|Privacy}}: as on the other objects, you can indicate a note as private so as to make sure you can remove this note from all output Gramps creates with one easy click.
 
  
* References
+
==== References tab ====
  
 
The {{man label|References}} tab indicates any objects that refer to a given note. The list can be ordered according to any of its column headings: {{man label|Type}}, {{man label|ID}}, or {{man label|Name}}. Double-clicking an entry allows you to view and edit the corresponding record.
 
The {{man label|References}} tab indicates any objects that refer to a given note. The list can be ordered according to any of its column headings: {{man label|Type}}, {{man label|ID}}, or {{man label|Name}}. Double-clicking an entry allows you to view and edit the corresponding record.
  
 
{{man tip|HTML links|If you add links to webpages with the full address in a note, the link will turn blue and underlined when you hover your mouse over the text. Clicking the link opens the webpage in your default browser.}}
 
{{man tip|HTML links|If you add links to webpages with the full address in a note, the link will turn blue and underlined when you hover your mouse over the text. Clicking the link opens the webpage in your default browser.}}
 +
 +
===== Link Editor =====
 +
 +
[[File:Link-editor-dialog-42.png|thumb|right|400px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Link Editor - dialog]]
 +
 +
The {{man label|Link_Editor}} has the following options:
 +
 +
*{{man label|Link Type:}} allows you to create an internal link to an item in Gramps, such as a Person, Family, Event, Place, Note, Repository, Source, and Media as well as an external Internet Address.
 +
**{{man button|Select Event}} button
 +
**{{man button|New}} button
 +
*{{man label|Gramps item:}}
 +
**{{man button|Edit}} button
 +
*{{man label|Internet Address:}}
 +
 +
See also [[Gramps_4.2_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_1#Internet_Address_Editor|Internet Address Editor]]
 +
{{-}}
  
 
=== Note markup and preformat in reports ===  
 
=== Note markup and preformat in reports ===  
Line 416: Line 621:
 
Markup like '''bold''', color, <u>underline</u>, ... can be added to notes. A note can be preformatted or not. It depends on the output type how this markup will appear. Here an overview is given of what you can expect.   
 
Markup like '''bold''', color, <u>underline</u>, ... can be added to notes. A note can be preformatted or not. It depends on the output type how this markup will appear. Here an overview is given of what you can expect.   
  
# '''Pdf''' and '''direct print''' (to printer or to file) fully support the markup and the preformatted setting
+
* '''Pdf''' and '''direct print''' (to printer or to file) fully support the markup and the preformatted setting
# '''ascii''' print removes all markup from the notes for obvious reasons
+
* '''ascii''' print removes all markup from the notes for obvious reasons
# '''LaTeX''' output interprets the markup to its best of possibilities. LaTeX is not well suited as a typesetting language to add custom style. That would break the benefits LaTex offers. Hence, the following is done:
+
* '''LaTeX''' output interprets the markup to its best of possibilities. LaTeX is not well suited as a typesetting language to add custom style. That would break the benefits LaTex offers. Hence, the following is done:
 
:* '''bold''', <u>underline</u> and ''italic'' is supported
 
:* '''bold''', <u>underline</u> and ''italic'' is supported
 
:* fontsize is mapped to the size indicators of LaTeX in a fuzzy manner
 
:* fontsize is mapped to the size indicators of LaTeX in a fuzzy manner
Line 424: Line 629:
 
:* color and font is not supported
 
:* color and font is not supported
 
:* preformatted is handled correctly
 
:* preformatted is handled correctly
# '''Narrative Web'''. Many people use the Narrative Web report as an easy way to work with their data. This report is trying to respect markup in the notes. This is an interpreted translation, it is not one-to-one.
+
* '''Narrative Web'''. Many people use the Narrative Web report as an easy way to work with their data. This report is trying to respect markup in the notes. This is an interpreted translation, it is not one-to-one.
# '''ODF''' output does not support markup at the moment. This will be added in the future
+
* '''ODF''' output does not support markup at the moment.
# '''RTF''' output does not support markup at the moment
+
* '''RTF''' output does not support markup at the moment.
# '''html''' output does not support markup at the moment
+
* '''html''' output does not support markup at the moment.
  
The conclusion of the above should be to use markup in notes only in those cases it adds to the information stored. '''Gramps is not a text editor.'''
+
{{man tip|Note markup and preformat in reports|Use markup in notes only in those cases it adds to the information stored. '''Gramps is not a text editor.'''}}
  
 
{{-}}
 
{{-}}
Line 436: Line 641:
  
 
{{languages|Gramps_4.2_Wiki_Manual_-_Entering_and_Editing_Data:_Detailed_-_part_2}}
 
{{languages|Gramps_4.2_Wiki_Manual_-_Entering_and_Editing_Data:_Detailed_-_part_2}}
 +
 +
{{grampsmanualcopyright}}
  
 
[[Category:Documentation]]
 
[[Category:Documentation]]

Latest revision as of 01:29, 23 February 2020

Previous Index Next


The previous section offered you a detailed overview of how to enter and edit data for people, relationships and dates. This section continues with other objects you encounter in Gramps.

Contents

Editing information about events

Adding an Event to a person allow you to provide information.

When adding an event to the Events Category, the New Event dialog appears.


New Event dialog

Fig. 7.2.1 Event editor

Events are edited through the Event Editor dialog. This dialog can be accessed from either the Edit Person dialog or the Marriage/Relationship dialog.

The top part lets you view and edit basic information about the event:

  • The Event type: can be selected from the available types listed in the Event type drop-down menu. E.g., Birth(default), Baptism, Death, Burial, etc. You can enter you own custom event type by typing directly into the this entry field.
  • The Date: of the event can be an exact date, a range (from ... to ..., between ...), or an inexact date (about ...).
    • Invoke date editor button starts the Date selection dialog.
  • The Description: field gives you the opportunity to give a longer description what this event is.
    • Record is Public - Toggle the Privacy lock to mark the event record as private which allows it to be omitted from reports.
  • The Place: can be selected from a list of previously entered place using the Select an existing place button or entered anew using the Add a new place button. Additionally, you can drag and drop a place entry into this field.
  • The ID: is a unique identifier for the event. Leave this field blank to allow Gramps to generate this value automatically for new events.
  • The Tags: allow you to select an existing tag using the Edit the tag list button.

New Event tab pages

The central part of the window displays tabs containing different categories of information. Click on a tab to view or edit its contents. The tabs provide the following information categories of the event data:

Source Citations

The Sources Citations tab lets you view and edit sources relevant to an event. The central part of the window lists all such source references stored in the database. The buttons + , Edit , and - let you add, modify, and remove a source reference associated with an event. Note that the Edit and - buttons become available only when a source reference is selected from the list.

Notes

The Notes tab provides a place to record notes or comments about the event. To add a note or modify existing notes simply edit the text in the text entry field.

Gallery

The Gallery tab

Attributes

The Attributes tab

References

The References tab


The bottom part of the window has OK and Cancel buttons. Clicking OK will apply all the changes made in all tabs and close the dialog window. Clicking the Cancel button will close the window without applying any changes. Pressing Help will provide help if available.

Tango-Dialog-information.png
Tip

If a tab label is in boldface type, this means it contains data. If not, it has no data.



Editing event references

Event references connect a Event to a person and allow you to provide additional information about the event.

When adding event reference to a Edit Person's Events tab, the Event Reference Editor dialog appears.


Event Reference Editor dialog

Tango-Dialog-information.png
Tip

Information in this dialog is specific to the particular reference. A single event can be referenced many times, and all such references will have in common the overall event information. This dialog lets you provide reference-specific data, such as relevant role, attribute to further specify and document the reference.


Fig. 7.2.2 Event information

The New Citation dialog includes two sections, Reference Information and Shared Information.

  • The Reference Information section indicates the details associated with the particular reference to this Event: General, Notes, Attributes.
  • The Shared Information displays : General, Source Citations, Attributes, Notes, Gallery, References.


Reference Information

Reference Information tab pages
General

For the Role: of the person in this event, use Primary(default) for the main beneficiary, use a descriptive role otherwise (Eg., Witness, Celebrant, ...).

Notes


Attributes


Shared Information


General
Gramps-notes.png
Note

Any changes in the shared event information will be reflected in the event itself, for all participants in the event.


Source Citations


Attributes


Notes


Gallery


References


Editing information about media objects

To add or edit media data, switch to the Media Category View and select the desired entry in the list of media. Double-click on that entry or click Edit on the toolbar to invoke the following Media Properties Editor dialog.

New Media dialog

Fig. 7.2.3 Media properties editor

The top section presents a thumbnail preview of the media object if available, along with a summary of its properties (ID, Date, Path and object type) that you can view and edit. You can type this information directly into the corresponding fields. For the Date, you can also enter information by clicking the Invoke date editor button to invoke the Date selection dialog.

  • A descriptive Title: for this media object.
  • The ID: is an unique record to identify the media object, leave blank to have it generated by Gramps.
    • Privacy toggle for this media object Record is public(default) or Record is private
  • Date: a date associated with the media object eg: for a picture it could be the date it was taken.
    • Invoke date editor button to invoke the Date selection dialog.
  • Path: of the media object on your computer. Gramps does not store the media internally, it only stores the path! Set the Relative Path in the Preferences > General tab's Base path for relative media paths: entry to avoid retyping the common base directory where all your media is stored. The Media Manager tool can help managing paths of a collection of media objects.
    • Open File Browser to select a media file on your computer. button.
  • Edit the Tag list button.

The bottom section of the window displays four notebook tabs containing different categories of information. Click a tab to view or edit its contents. The bottom part of the window has Help, Cancel and OK buttons. Clicking OK will apply all the changes made in all tabs and close the dialog window. Clicking the Cancel button will close the window without applying any changes. Pressing the Help button will bring you here.

Gramps-notes.png
Note

Every media object is referred to by its Path. The user is responsible for keeping track of the object files. Gramps will only reference and display the contents, not manage the files themselves.

Gramps-notes.png
Note

Clicking OK will immediately save changes to the database (write on disk). All changes are immediate.

New Media tab pages

Tango-Dialog-information.png
Tip

If a tab label is in boldface type, this means it contains data. If not, it has no data.


The tabs represent the following categories of media data:

Source Citations

Attributes

The Attributes tab lets you view and edit particular information about the media object that can be expressed as Attributes. The bottom part displays the list of all such attributes stored in the database. The top part shows the details of the currently selected attribute in the list (if any). The buttons + , Edit , and - let you add, modify, or remove an attribute. Note that the Edit and - buttons become available only when an attribute is selected from the list.

Notes

The Note tab provides a place to record various information about the source that does not fit neatly into other categories. This area is particularly useful for recording information that does not naturally fit into the "Parameter/Value" pairs available to Attributes. To add a note or modify existing notes simply edit the text in the text entry field.

References

The References tab indicates any database records that refer to a given media object. The list can be ordered according to any of its column headings: Type , ID , or Name. Double-clicking an entry allows you to view and edit the corresponding record.

Gramps-notes.png
Note

Only primary objects can be shown in the References tab: Person, Family, Event, Source, or Place. The secondary objects such as Names and Attributes, although able to refer the media object, will only show up through their primary objects to which they belong.


Editing media object references

When Media Object references connect a Media Object to an other object on a Edit Person's Gallery tab, the Select a media object file selector from the Media Reference Editor dialog appears so you can select the media object.

Select a media object selector

Fig. 7.2.4 Select a media object (File) selector - example

The Select a media object file selector allow you to preview and select a media file you want to attach, and at the same time you may edit the shown Title: (Defaults to the filename without the file extension).

  • Convert to a relative path (checkbox unchecked by default until checked for the first time and remembered for each subsequent image selection.)


Media Reference Editor dialog

Fig. 7.2.5 Media Reference Editor - (default)

The Media Reference Editor dialog.


Fig. 7.2.6 Media Reference Editor - (Shared Information section expanded)

You may also expand the Shared Information section.

Top section

Top section tab pages
General
  • Region corners : x1, x2, y1, y2.

The region part allows to select a specific region on the Media Object. You can use the mouse cursor on the picture to select a region, or use these spinbuttons to set the top left, and bottom right corner of the referenced region. Point (0,0) is the top left corner of the picture, and (100,100) the bottom right corner.

  • Privacy

The Privacy button lets you mark whether or not the record is considered private. Check the Private record box to mark this record as private.

See also the Narrated Web Site Gallery tab supports output of these referenced regions.


Source Citations


Attributes


Notes


Shared Information

Shared Information tab pages
General


References


Source Citations


Attributes


Notes


Editing information about places

To edit information about places, switch to the Places Category and select the desired entry from the list of places. Double-click that entry or click the Edit button on the toolbar to bring up the Place Editor dialog:


Place Editor dialog

Gramps-notes.png
Enhanced Place Editor in Gramps 4.2.0

See What's new?

Fig. 7.2.7 Place editor
Fig. 7.2.8 Place editor(old gramps 4.1

To edit information about places, switch to the Places Category and select the desired entry from the list of places. Double-click that entry or click the Edit button on the toolbar to bring up the following Place Editor dialog:

The following fields are available:

  • Title: the description of this place used in reports. Gramps will construct this for you. See Preferences > Places > Enable automatic place title generation
  • Name: the name of this place.
    • Invoke place name editor button opens the Place Name Editor dialog where you can add/edit additional information.
  • Type: the place type. All Custom entered Types are shown at the bottom of the list. Choose from the following default available Types:
    • Building
    • Borough
    • Country
    • County
    • City
    • Department
    • District
    • Farm
    • Hamlet
    • Locality
    • Municipality
    • Neighborhood
    • Number - See Suppress comma after house number
    • Parish
    • Province
    • Region
    • State
    • Street
    • Town
    • Unknown(default)
    • Village
  • Latitude: the position above equation of the place in decimal or degree notation. Eg, valid values are 12.0154, 50°52'21.92\"N, N50º52'21.92\" or 50:52:21.92. You can set these values via the Geography View by searching the place, or via a map service in the Place view.
  • Longitude: the position relative to the Prime, or Greenwich, Meridian of the place in decimal or degree notation. Eg, valid values are -124.3647, 124°52'21.92\"E, E124º52'21.92\" or 124:52:21.92. You can set these values via the Geography View by searching the place, or via a map service in the Place view.
    • Record is public/private
  • ID: an unique record to identify the place. Leave generated by Gramps.
  • Code: a code for this place. For example, an area code or postal code.
  • Tags:
    • Edit the tag list


Place editor tab pages

Tango-Dialog-information.png
Tip

If a tab label is in boldface type and displays an icon, this means it contains data. If not, it has no data.


The tabs represent the following categories of place data:

Enclosed By

Places in Gramps are stored in a hierarchy. The Enclosed By tab allows you to link this place to other places, higher in the hierarchy, which enclose it. Each link consists of a place and an optional date range. The buttons + , Edit , and - let you add, modify, and remove a link. Note that the Edit and - buttons become available only when a link is selected from the list. In general, a country will be a top level place, and will not be linked to any other place.


Select Place selector

The Select Place selector dialog allows you to link to an already existing place and once selected it will be opened in the Place Reference Editor

You may use the Find button to filter the list based on one of the options from the drop down list:

  • Name contains (default)


Place Reference Editor

Place Reference Editor

Alternative Names

The Alternative Names tab lets you view and edit other names by which the place might be known. The tab lists all other names of the place stored in the database. The buttons + , Edit , and - let you add, modify, and remove a name record. Note that the Edit and - buttons become available only when a name is selected from the list.
Gramps-notes.png
Note

Seeing a question ? mark means that you may have a problem in the naming variants of that place. There may be some places which have different names for the same date range and language. Overlapping date ranges are valid. The place displayer will use the first matching name.

Source Citations

The Source Citations tab lets you view and edit sources relevant to a place. The central part of the window lists all such source references stored in the database. The buttons + , Edit , and - let you add, modify, and remove a source reference associated with a place. Note that the Edit and - buttons become available only when a source reference is selected from the list.

Notes

The Notes tab displays any comments or notes concerning the place. To add a note or modify existing notes simply edit the text in the text entry field.

Gallery

The Gallery tab lets you store and display photos and other media objects associated with a given place. The central part of the window lists all such media objects and gives you a thumbnail preview of image files. Other objects such as audio files, movie files, etc., are represented by a generic Gramps icon. The buttons + , Select , Edit , and - let you add a new image, add a reference to an existing image, modify an existing image, and remove a media object's link to the place. Note that the Edit and - buttons become available only when a media object is selected from the list.

Internet

The Internet tab contains Internet addresses relevant to the place. The bottom part of the window lists all such Internet addresses stored in the database. The top part shows the details of the currently selected address in the list (if any). The buttons + , Edit , and - let you add, modify, and remove an Internet address. The Go button (represented by an icon with a green arrow and yellow circle) opens your browser and takes you to the web page corresponding to the highlighted Internet address. Note that the Edit , - , and Go buttons become available only when an address is selected from the list.

References

The References tab indicates any database records (events or LDS ordinances) that refer to a place. This information cannot be modified from the Place Editor dialog. Instead, the corresponding database record (e.g., a birth event) has to be brought up and its place reference edited.


Place Name Editor dialog

Gramps-notes.png
New Feature added in Gramps 4.2.0

New Place Name editor. See What's new?

Fig. 7.2.9 Place Name Editor

You can access the Place Name Editor dialog from the Place Editor dialogs Invoke place name editor button.

The Place Name Editor dialog allows you to add/edit the following information:

  • Name: the name of the place
  • Date: Date range in which the place is valid
    • Invoke the date editor button
  • Language: Language in which the name is written. Valid values are two character ISO codes for example: en,fr, de, nl. See Wikipedia for the full list of valid ISO 639-1 codes.


Supported longitude/latitude formats

When you create/modify a place, the possible formats used for longitude/latitude are :

       'D.D4'    : degree notation, 4 decimals 
                   eg +12.0154 , -124.3647
       'D.D8'    : degree notation, 8 decimals (precision like ISO-DMS) 
                   eg +12.01543265 , -124.36473268
       'DEG'     : degree, minutes, seconds notation
                   eg 50°52'21.92"N , 124°52'21.92"E ° has UTF-8 code c2b00a
                   or N50º52'21.92" , E124º52'21.92" º has UTF-8 code c2ba0a
                   The character for seconds can be either one double quote "
                   or two single quote '
                   The letters N/S/W/E can be placed before or after the digits.
       'DEG-:'   : degree, minutes, seconds notation with :
                   eg -50:52:21.92 , 124:52:21.92
       'ISO-D'   : ISO 6709 degree notation i.e. ±DD.DDDD±DDD.DDDD
       'ISO-DM'  : ISO 6709 degree, minutes notation 
                   i.e. ±DDMM.MMM±DDDMM.MMM
       'ISO-DMS' : ISO 6709 degree, minutes, seconds notation 
                   i.e. ±DDMMSS.SS±DDDMMSS.SS

The second part of the window displays seven notebook tabs containing different categories of information. Click a tab to view or edit its contents. The bottom part of the window has OK and Cancel buttons. Clicking OK will apply all the changes made in all tabs and close the dialog window. Clicking the Cancel button will close the window without applying any changes.

Gramps-notes.png
Note

Clicking OK will immediately save changes to the database. All changes are immediate.


Editing information about sources

Once you have selected a source, or if you had chosen the STOCK_ADD + or STOCK_EDIT Edit buttons, then the New Source dialog appears.

New Source dialog

Fig. 7.2.10 Source editor

For the New Source dialog the general information at the top of the window lets you define basic information about the source: its Title , Author , Abbreviation , and Publication information . You can type this information directly into the adjacent fields.

  • Title: Title of the source.
  • Authors: Authors of the source.
  • Pub. info.: Publication Information, such as city and year of publication, name of publisher, ...
  • Abbreviation: Provide a short title used for sorting, filing, and retrieving source records.
    • Record is public/private Lock icon toggle.
  • ID: an unique record to identify the source. Leave generated by Gramps.
  • Tags:
    • Edit the tag list


New Source tab pages

The tabs provide the following information categories of source data:

Notes

The Notes tab provides a place to record notes or comments about the source. To add a note or modify existing notes simply edit the text in the text entry field. Only primary objects can be shown in the References tab: Person, Family, Event, Place, or Media object. Secondary objects such as Names and Attributes can only be accessed through the primary objects to which they belong.

Gallery

The Gallery tab lets you store and display photos and other media objects associated with a given source (for example, a photo of a birth certificate). The central part of the window lists all such objects and gives you a thumbnail preview of image files. Other objects such as audio files, movie files, etc., are represented by a generic Gramps icon. The buttons + , Select , Edit , and - let you add a new image, add a reference to an existing image, modify an existing image, and remove a media object's link to the relationship. Note that the Edit and - buttons become available only when a media object is selected from the list.

Attributes

The Attributes tab displays "Key/Value" pairs that may be associated with the source. These are similar to the "Attributes" used for other types of Gramps records. The difference between these Key/Value pairs and Attributes is that Attributes may have source references and notes, while Key/Value data may not.
The central part of the window lists all existing Key/Value pairs. The buttons + and - let you add and remove pairs. To modify the text of Key or Value, first select the desired entry. Then click in either the Key or Value cell of that entry and type your text. When you are done, click outside the cell to exit editing mode.

Repositories

The Repositories tab displays the references to the repositories in which the source is contained. The list can be ordered by any of its column headings: ID , Title, Call Number,and Type. Double-clicking an entry allows you to view and edit the record. You may also edit the reference. The buttons on the side of the tab allow you add a new repository, link to (or share) an existing repository, edit the reference to the repository, or remove the reference.


Select Repository selector

The Select Repository selector dialog allows you to link to an already existing repositories and once selected it will be opened in the Repository Reference Editor

You may use the Find button to filter the list based on one of the options from the drop down list:

  • Title contains (default)


References

The References tab lists all the database records that refer to this source, if any. The list can be ordered by any of its column headings: Type , ID , or Name. Double-clicking an entry allows you to view and edit the record.


Editing source citations

Citations connect a Source to another object and allow you to provide additional information about the source. Citations can be attached to a large number of objects,

For each object, a common set of buttons are provided:

  • STOCK_ADD + (Create and add a new citation and a new source). This brings up an empty Citation dialog.
  • STOCK_INDEX (used for share) Add (Add an existing citation or source). This brings up the Source or Citation selection dialog box.
  • STOCK_EDIT Edit (Edit the selected citation). This brings up the Citation dialog pre-populated with the Citation and source information.
  • STOCK_REMOVE - (Remove the existing citation). This removes the citation from the object. It does not delete the citation itself, which could then be connected to another object.

Note that the STOCK_EDIT Edit and STOCK_REMOVE - buttons become available only when a citation has been selected.


Select Source or Citation selector

Fig. 7.2.11 Select Source or Citation - selector

When STOCK_ADD Add adding an existing citation or source, the Select Source or Citation dialog appears

This allows either an existing source or an existing citation (along with its associated source) to be selected. Click on the disclosure triangle alongside a source to see the citations associated with that source. For example, if one of your sources were a book, then the citations would normally refer to a page (or pages) within the book. If you already have a citation that refer to the particular page of the book, then you could select that citation which would then be shared. On the other hand, if this object needs to refer to a new page, then you would select the source and in the subsequent dialog enter the new page.

Use the search field to Find a source or citation based on one of the following:

  • Source: Title or Citation: Volume/Page contains(default)
  • Source: Title or Citation: Volume/Page does not contain
  • ID contains
  • ID does not contain
  • Last Change contains
  • Last Change does not contain


New Citation dialog

Fig. 7.2.12 Citation editor

Once you have selected a citation or a source, or if you had chosen the STOCK_ADD + or STOCK_EDIT Edit buttons, then the New Citation dialog appears.

The New Citation dialog includes two sections, Citation information and Shared source information.

Citation information

The Citation information section indicates the details associated with the particular reference to this Source: Confidence, Volume/Page, Date, and Notes. You can choose the Confidence level from the Confidence drop-down menu. The remaining details can be typed in the corresponding text entry fields.

  • Date: Date associated with this source reference. Typically used to store the date that the data was entered into the original source document (not the date when the event occurred).
  • ID:
  • Volume/Page: Specific location with in the information referenced. For a published work, this could include the volume of a multi-volume work and the page number(s). For a periodical, it could include volume, issue, and page numbers. For a newspaper, it could include a column number and page number. For an unpublished source, this could be a sheet number, page number, frame number, etc. A census record might have a line number or dwelling and family numbers in addition to the page number.
  • Confidence: Conveys the submitter's quantitative evaluation of the credibility of a piece of information, based upon its supporting evidence. It is not intended to eliminate the receiver's need to evaluate the evidence for themselves.
    • Very Low = Unreliable evidence or estimated data.
    • Low = Questionable reliability of evidence (interviews, census, oral genealogies, or potential for bias for example, an autobiography).
    • High = Secondary evidence, data officially recorded sometime after event.
    • Very High = Direct and primary evidence used, or by dominance of the evidence.
A warning icon STOCK_DIALOG_WARNING is displayed if the citation is shared.
Tango-Dialog-information.png
Tip

Information in a citation may be shared. A single citation can be referenced many times and all such references will have in common the overall citation information. Changing the citation information will change it for all of the shared uses


Fig. 7.2.13 New Citation editor since version 4.2.4
Citation information section tab pages

The tabs provide the following information categories of citation data:

  • Note

The Note tab provides a place to record notes or comments about the citation. The central part of the window lists all notes for this citation, and gives you a preview of the beginning of the note. The buttons STOCK_ADD +, STOCK_INDEX (used for share) Add, STOCK_EDIT Edit, STOCK_REMOVE -, STOCK_GO_UP Up and STOCK_GO_DOWN Down let you add a new note, share the selected note, edit the selected note, remove the selected note and move the selected note up or down the list of notes. Note that the STOCK_INDEX (used for share) Add, STOCK_EDIT Edit, STOCK_REMOVE -, STOCK_GO_UP Up and STOCK_GO_DOWN Down buttons become available only when a media object is selected from the list. Removing a note only removes the note from this citation, it does not delete the note itself. Please refer to details on editing notes.

  • Gallery

The Gallery tab lets you store and display photos and other media objects associated with a given citation (for example, a photo of a page of a book or a page of a census). The central part of the window lists all such objects and gives you a thumbnail preview of image files. Other objects such as audio files, movie files, etc., are represented by a generic Gramps icon. The buttons STOCK_ADD +, STOCK_INDEX (used for share) Add, STOCK_EDIT Edit and STOCK_REMOVE - let you add a new image, add a reference to an existing image, modify an existing image, and remove a media object's link to the citation. Note that the Edit and - buttons become available only when a media object is selected from the list. Please refer to details on editing media references.

  • Data

The Data tab displays "Key/Value" pairs that may be associated with the citation. These are similar to the "Attributes" used for other types of Gramps records. The difference between these Key/Value pairs and Attributes is that Attributes may have source citations and notes, while Key/Value data may not.

The central part of the window lists all existing Key/Value pairs. The buttons STOCK_ADD + and STOCK_REMOVE - let you add and remove pairs. To modify the text of Key or Value, first select the desired entry. Then press the STOCK_EDIT Edit button to select the Key, or click in either the Key or Value cell of that entry and type your text. When you are done, click outside the cell to exit editing mode.

  • References

The References tab lists all the database records that refer to this source, if any. The list can be ordered by any of its column headings: Type , ID , or Name. Double-clicking an entry allows you to view and edit the record.


Shared source information

Shared Source Information displays the Title of the Source, its Author , Abbreviation and Publication information .

A warning icon STOCK_DIALOG_WARNING is displayed if the source is shared.

Editing the source information in this dialog is just the same as editing information about sources


Editing information about repositories

Once you have selected a source, or if you had chosen the STOCK_ADD + or STOCK_EDIT Edit buttons, then the New Repositories dialog appears.

New Repositories dialog

Fig. 7.2.14 Repository editor

The following fields are shown:

  • Name: of the repository (where sources are stored).
  • Type: of repository, eg., Library(default), Album, ...
  • ID: an unique record to identify the repository. Leave generated by Gramps.
    • Record is public/private Lock icon toggle.
  • Tags:
    • Edit the tag list


New Repositories tab pages

The tabs represent the following categories of repository data:

Addresses

The Addresses tab lets you view and record the various addresses of the repository.
The bottom part of the window lists all addresses stored in the database. The top part shows the details of the currently selected address in the list (if any). The buttons + , Edit , and - allow you to correspondingly add, modify, and remove an address record from the database. Note that the Edit and - buttons become available only when an address is selected from the list.

Internet

The Internet tab displays Internet addresses relevant to the repository. The bottom part lists all such Internet addresses and accompanying descriptions. The top part shows the details of the currently selected addresses in the list (if any). The buttons + , Edit , and - let you add, modify, and remove an Internet address. The "Go" button (represented by an icon having a green arrow and yellow circle) opens your web browser and takes you directly to the highlighted page. Note that the Edit , and -buttons become available only when an address is selected from the list.

Notes

The Notes tab provides a place to record notes or comments about the repository. To add a note or modify existing notes simply edit the text in the text entry field.

References

The References tab indicates any database records that refer to a given repository. The list can be ordered according to any of its column headings: Type , ID , or Name . Double-clicking an entry allows you to view and edit the corresponding record.


Editing information about notes

Once you have selected a source, or if you had chosen the STOCK_ADD + or STOCK_EDIT Edit buttons, then the New Note dialog appears.

Note tab

The Note tab is the place for adding notes to one of your people, sources, etc. The tab allows you to order your notes in the order you want to see them. As on the other tabs, you can add new notes, share existing notes with the object you are working on and remove notes from this object (this does not remove the note from the family tree. It is present in the note view afterward).

Note editor

Fig. 7.2.15 Note editor

When creating a new note, or when editing an existing note, the note editor appears. There are two tabs, the Note tab, and the References tab.

Note tab

The Note tab has the following elements

  • A toolbar to apply styles to your notes. You can select and apply one of the toolbuttons, or set the values as you want and start typing.
  • Italic : common function known from text editors
  • Bold : common function known from text editors
  • Underline : common function known from text editors
  • Undo : Undoes last action.
  • Redo : Re-applies last action.
  • Font selection drop down list: a basic font selector showing all fonts installed on your operating system.
  • Font size: select the size of the font to use for your text.
  • Font color: select the color of your font.
  • Background color: adds a background color to the text you enter.
  • Link: Opens the Link Editor allowing you to create an internal link to an item in Gramps, such as a Person, Family, Event, Note, etc.
  • Clear Markup: Highlight the text to remove markup you have placed on the note.
Tango-Dialog-information.png
Important

If you want to revert to a previous version of a note after you save it, there is an Undo/Redo feature for notes (just like other items). Go to menu -> Redo, Undo, or Undo History.


  • A context menu on the textview.
The most important entry in this context menu is the spell selection. You are offered a selection of installed languages on your system with spell checking enabled.
  • The text view where you can write your note
  • Some properties of your note
  • Preformatted checkbox: Notes in Gramps are considered flowed for beautiful presentation in the reports. In this setting, newlines and white spaces will be automatically ignored so as to form complete paragraphs, which are defined by an empty line between two textblocks. When Preformatted is checked, Gramps will assume the whitespace and enters you used in the notes are important. Use this for tables, literal transcripts, ... . Use monospace font to keep preformatting. Try not to use preformatted if you do not need it, the reports you create will be more beautiful.
  • Make public/private Privacy on the other objects, you can indicate a note as private so as to make sure you can remove this note from all output Gramps creates with one easy click.
  • ID: a unique id for the note. If left blank an automatic id will be chosen according to the settings in the preferences
  • Type: (General default) The note type. You can add your own value by typing it
  • Tags: Select a Tag for the note: Complete, Todo etc... You can add your own Tags by typing it


References tab

The References tab indicates any objects that refer to a given note. The list can be ordered according to any of its column headings: Type, ID, or Name. Double-clicking an entry allows you to view and edit the corresponding record.

Tango-Dialog-information.png
HTML links

If you add links to webpages with the full address in a note, the link will turn blue and underlined when you hover your mouse over the text. Clicking the link opens the webpage in your default browser.


Link Editor
Fig. 7.2.16 Link Editor - dialog

The Link_Editor has the following options:

  • Link Type: allows you to create an internal link to an item in Gramps, such as a Person, Family, Event, Place, Note, Repository, Source, and Media as well as an external Internet Address.
    • Select Event button
    • New button
  • Gramps item:
    • Edit button
  • Internet Address:

See also Internet Address Editor

Note markup and preformat in reports

Markup like bold, color, underline, ... can be added to notes. A note can be preformatted or not. It depends on the output type how this markup will appear. Here an overview is given of what you can expect.

  • Pdf and direct print (to printer or to file) fully support the markup and the preformatted setting
  • ascii print removes all markup from the notes for obvious reasons
  • LaTeX output interprets the markup to its best of possibilities. LaTeX is not well suited as a typesetting language to add custom style. That would break the benefits LaTex offers. Hence, the following is done:
  • bold, underline and italic is supported
  • fontsize is mapped to the size indicators of LaTeX in a fuzzy manner
  • mono fonts are shown as a mono spaced font
  • color and font is not supported
  • preformatted is handled correctly
  • Narrative Web. Many people use the Narrative Web report as an easy way to work with their data. This report is trying to respect markup in the notes. This is an interpreted translation, it is not one-to-one.
  • ODF output does not support markup at the moment.
  • RTF output does not support markup at the moment.
  • html output does not support markup at the moment.
Tango-Dialog-information.png
Note markup and preformat in reports

Use markup in notes only in those cases it adds to the information stored. Gramps is not a text editor.



Previous Index Next


Gnome-important.png Special copyright notice: All edits to this page need to be under two different copyright licenses:

These licenses allow the Gramps project to maximally use this wiki manual as free content in future Gramps versions. If you do not agree with this dual license, then do not edit this page. You may only link to other pages within the wiki which fall only under the GFDL license via external links (using the syntax: [https://www.gramps-project.org/...]), not via internal links.
Also, only use the known Typographical conventions