Changes

Jump to: navigation, search

Gramps 4.1 Wiki Manual - Categories

10,843 bytes added, 21:51, 5 February 2016
m
Protected "Gramps 4.1 Wiki Manual - Categories": outdated user manual ([Edit=Allow only administrators] (indefinite) [Move=Allow only administrators] (indefinite))
{{#vardefine:chapter|4}}
{{#vardefine:figure|0}}
 
Genealogical information is very broad and can be extremely detailed. Displaying it poses a challenge that Gramps takes on by dividing and organizing the information into a series of Categories, each with their own Views. Each View displays a portion of the total information, selected according to a particular category. This will become clearer as we explore the different Categories.
== People Category ==
The People View lists the people stored in the database(See Fig. People ListView). People are grouped according to their family names. To the left of each family name is typically either an arrow or some other type of indicator (eg: ''+''). Clicking it once will reveal the entire list of people sharing that name. Clicking the indicator again will "roll up" the list and show only the family name.
By default, the People View List, displays several columns of information about each person.
[[Image:GroupPeopleTreeView-40.png|left|thumb|300px400px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Grouped People TreeView (default)]][[Image:PeopleListView-40.png|right|thumb|300px400px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} People ListView]]
{{-}}
== Relationships Category ==
[[ImageFile:RelationshipsViewRelationshipsCategoryView-4041.png|right|450px|thumb|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Relationships Category view]]
The Relationships Category displays all the relationships of the Active Person (the selected person). Specifically, it shows his or her parents, siblings, spouses, and children.
The Relationships Category displays the following sections:
*=== Active Person: === * At the top of the screen, name, ID, birth, and death information, as well as the calculated age of the Active Person is displayed. If  * On the right hand side a photo of the person is if available, it is will be shown . You can click on the right hand sidephoto to open it in the default picture viewer.  * Next to the person's name is a symbol indicating gender, and an {{man button|[[Image:Gramps-notes.png|13px]]Edit}} button. Clicking the {{man button|[[Image:Gramps-notes.png|13px]]Edit}} button will allow you to edit all of the person's individual information in an {{man label|Edit Person}} dialog.
*=== Parents: === The next section, the Parents section, displays the families in which the person is a child. Since it is possible for a person to have multiple sets of parents, it is possible to have several Parents sections.
You can control how much information is displayed by using the {{man menu|View}} menu. The view menu allows you to show or hide details (the birth and death information) and to show or hide siblings. Next to each person listed is an {{man button|[[Image:Gramps-notes.png|13px]]Edit}} button, which will allow you to edit all the details of that particular person.
{{man warn| Warning |If you are not careful, it is possible to create multiple families with the same parents. This is rarely what the user wants to do. If you attempt to add a new family that has the same parents as an existing family, Gramps will issue a warning dialog. If you get this dialog, you should probably Cancel the edit, and then use the {{man button|Select}} button to select the existing family.}}
*=== Family: === Similar to the Parents section is the Family section, which displays families where the Active Person is a parent. Because it is possible to have multiple families, it is possible to have multiple Family sections. Each family section displays the spouse and any children.
{{man note | Spouse |We use the term spouse for sake of simplicity. However, please note that spouse may in fact be a domestic partner, a partner in a civil union, or various other similar relationships between two people. Spouse relationships are not required to be only between a male and female.}}
"Greyed-out" sub-menus indicate the absence of the data in the appropriate category. Similar to the children menu above, Childrens' and Parents' menus distinguish continuing lines from dead ends.
{{man tip|Screencasts|You can see videos for [[Media:Add_family_from_pedigree_view_Gramps_3.2.5.ogg|adding]] or [[Media:Edit family from pedigree view Gramps 3.2.5.ogg|editing]] a family (parents, children, siblings) from Pedigree View. Both videos show Gramps 3.2.5 so the current version of Gramps may be slightly different.}}
{{-}}
=== Fan Chart View ===
[[ImageFile:ChartsViewFanChartChartsView-40fanchart-fullcircle-9gen-default-41.png|thumb|right|400px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Fan Chart View- full circle]]
This view shows the ancestry but as a pie chart. Clicking on a name in the chart will double the section of the pie allocated to that person. A second click brings the chart back to the original form. Right click brings up a context menu like in the pedigree view, allowing to navigate to other people.
=== Descendant Fan View ===
[[ImageFile:ChartsViewDescendantFanChartChartsView-40desendantfan-fullcircle-9gen-default-41.png|thumb|right|400px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Descendant Fan Chart View- full circle]]
* [https://gramps-project.org/2012/09/descendant-fanchart/ Descendant Fan View]
The default view displays the {{man label|Description}} , {{man label|ID}} , {{man label|Type}} , {{man label|Date}} and {{man label|Place}} of the event. The {{man label|Column Editor}} dialog can be used to add, remove and rearrange the displayed columns. This can be accessed from the {{man button|Configure View...}} button on the toolbar.
 
The list of Events can be sorted in the usual manner, by clicking on the column heading. Clicking once sorts in ascending order, clicking again sorts in descending order.
{{-}}
{{man warn| Meaningful event description |Because events can be shared, you should take the extra time to give each event a unique and meaningful description. This will help you find the correct event if you decide to share events.}}
 
The list of Events can be sorted in the usual manner, by clicking on the column heading. Clicking once sorts in ascending order, clicking again sorts in descending order.
== Places Category ==
Clicking once sorts in ascending order, clicking again sorts in descending order. The {{man label|Column Editor}} dialog may be used to add, remove and rearrange the displayed columns.
===Map Service===If a place has been highlighted, you may select the {{man button|Attempt to see selected locations with a Map Service (OpenstreetMap, Google Maps, loading...}} button to attempt to display the place in a web browser.The map service can be chosen from the drop down list under the black triangle to the right of the map button.
From the {{man button|Select a Map Service}} drop down list you can choose the map service you want to use from the following three options:* '''OpenStreetMap'''(default)* GoogleMaps* EniroMaps Your default web browser should open, attempting to use either the longitude and latitude coordinates or the place name to display the location using the Google Maps provider web site. Different map services might have different requirements for the location description.
This feature is limited, and may not always produce the results you desire.
;===Place Tree View and Place List View===
[[Image:PlacesCategory-PlaceTreeView-41.png|right|thumb|400px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Places Tree View]]
[[Image:GeographyView-40.png|right|450px|thumb|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Geographic View]]
This category is for showing data on a map. It contains the Geographic View, which allows you to see the people and their events placed on a map via an internet map provider (OpenStreetMap or , Google maps...).
The Geographic View can:
* show all places in your family tree
* show a filtered selection of places
* show all places connected to the active person
* show all places connected to the active family
* show all places connected to all events
* show all places connected to a filtered selection of events
* Show if two people have been able to meet
* Show if two families have been able to meet
* Show all displacements or moves for one person and their descendants
These options are accessible via the buttons on the toolbar. To filter on places or events, activate the filter sidebar via the menu {{man menu|View->Filter Sidebar}}
FurthermoreTo have these views working correctly, you need to have events related to places.These places must have coordinates : latitude and longitude. If one place has no coordinates, we'll never see it on the Geographic view map. If you have internet active, for all moves on the map, all zoom ... all tiles are saved.When you are without internet, all tiles cached in a previous session can be used.So, the map can be used without internet and all already visited places can be shown again.The only thing to do is for each place or area you want to use without an internet connection is toselect them, zoom into these places. You'll be able to use them again without connection. {{man warn|BE CAREFUL|it can help takes gigabytes. If you add new use several maps, you need to have this same gigabytes size multiply by the number of map used.}} ==== The different views ===={| |-!colspan="3" align="left" |===== All known places for one person =====|- | valign="top" |[[Image:gramps-person-11.png|left|frameless|200px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} The person]] | valign="top" |This view show all places visited by one person during his life. This view is not connected to filters. It only depend on the active person and the history. If you want to use the animate functionality, click on the right button of the mouse. You'll get a popup menu.In this menu popup, you can select 'animate' to your family treesee the life way of the current person : If the active person has several related events, you can see a virtual move between those markers. The move is related to years or add distance and can be modified in the person map preferences. If the distance between to markers is greater than a value in tenth of degree, we show moves depending on distance instead of years. In these case, the number of steps between these two markers can be modified. You can modify the animation speed between steps. The moves start at the first event year until the last event year. In the configuration menu, you can set the following :#The animation speed in milliseconds. #How many steps betwwen two markers for long moves.#The minimum latitude-/longitude coordinates to existing select large move. This value is in tenth of degree. | valign="top" |[[Image:gramps-configuration-2.png|right|thumb|100px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} The animation]] |-!colspan="3" align="left" | ===== All known places for one family =====|-| valign="top" |[[Image:gramps-family-10.png|left|frameless|200px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} The family]]| valign="top" |This view show all placesvisited by all family's members during their life. This view is not connected to filters. It only depend on the active family and the history. You have no extra option in the configuration menu. | |-!colspan="3" align="left" |===== Have they been able to meet ? =====|-| valign="top" |[[Image:gramps-person-meeting-9.png|left|frameless|200px|Fig. {{#var:chapter}}. To activate this{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Persons meeting?]] | valign="top" |This view is used to show if two persons were able to meet during their life. You must select one reference person :#From the menu popup : Choose the reference person#From the toolbar When the reference person is active, you'll see its life way.For each known place with coordinates, use you'll see a circle or an ovale depending on the longitude. The circle radius can be tuned in the configuration view.This value is defined in tenth of degree.| valign="top" |[[Image:gramps-configuration-3.png|right|thumb|100px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} The selection]] |-!colspan="3" align="left" |===== Have these two families been able to meet ? =====|-| valign="top" |[[Image:gramps-family-meeting-8.png|left|frameless|200px|Fig. {{man button#var:chapter}}.{{#vardefineecho:figure|add location{{#expr:{{#var:figure}} button+1}}}} Families meeting?]] | valign="top" |This view is used to show if two families were able to meet during their life. You must select one reference family :#From the menu popup : Choose the reference family#From the toolbar When the reference family is active, you'll see all its members's life way.For each known place with coordinates, you'll see a circle or an ovale depending on the longitude. The circle radius can be tuned in the configuration view.This value is defined in tenth of degree.| valign="top" |[[Image:gramps-configuration-3.png|right|thumb|100px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} The selection]] |-!colspan="3" align="left" |===== All displacements for one person and their descendants =====|-| valign="top" |[[Image:gramps-geomoves-5.png|left|frameless|200px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Moves]] | valign="top" |This view is used to show all descendant's life ways. There are displayed by generation.You can change the delay between the generation display in the view configuration. This view is not connected to filters. It only depend on the active person and the history. In the configuration menu, you can :#Set the maximum generation to show#Set the time in milliseconds between two generation drawing.| valign="top" |[[Image:gramps-configuration-4.png|right|thumb|100px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Parameters for moves]] |-!colspan="3" align="left" |===== All places related to events =====|-| valign="top" |[[Image:gramps-events-7.png|left|frameless|200px|Fig. {{man button#var:chapter}}.{{#vardefineecho:figure|link location{{#expr:{{#var:figure}} button +1}}}} Events]] | valign="top" |This view is used to show all places related to events.It can take some time to show when we have many events. You have no extra option in the toolbarconfiguration menu. ||-!colspan="3" align="left" |===== All known places =====|-| valign="top" |[[Image:gramps-places-6.png|left|frameless|200px|Fig. {{#var:chapter}}. {{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Places]]
The | valign="top of the Geographic View shows two lines " |This view show all places with information, allowing you to change the information shown. The second line always shows coordinates in bold what is shown on the mapdatabase.
The first line has:* {{man button|Place list}} button and selection field.: The button shows how many places are present in the map. The selection fields allows you to jump to one of these places. You can clear the selection field by clicking the places list button. * {{man button|Place page}} buttons: If there are many places, the map is have no longer useful because too much information is shown. Therefore, the places will be divided extra option in pages. You can navigate the pages and see the map change via the Place page buttons: {{man button|<<}} goes back a page, {{man button|>>}} goes forward a page, and the middle button shows how many pages there are and what is shown at the moment.* Places with no latitude-longitude:The Geographic View can only show places with a valid latitude-longitude. A list of all places that satisfy the selection, but cannot be put on the map, is available via the button with a number and the {{man button|?}} sign. You can add latitude-longitude to these places in one of the following ways::* Use the place link button on the Geographic View:* Go to the Place View, and use the {{man button|Go}} button to search the place and it's location:* Download the [[Place completion tool]] via the configuration menu {{man menu|Help->Plugin Manager}}. If you download the data of your country, this tool can add latitude-longitude to all your places.*lock zoom level. :If you zoom the map to a resolution you want to keep, then you can press the lock zoom level button, and every time the Geographic View redraws the map, this zoomlevel will be used.*provider selection change:Gramps uses OpenStreetMap or Google Maps to provide the map that is displayed. With this button you can quickly change from one to the other. The advantage of [http://www.openstreetmap.org/ OpenStreetMap] is that it is a free project, so you can update the maps yourself with missing information via their website.
Via the toolbar {{man button|Configure View...}} button (or via the menu {{man menu|View}}, the following functionality is available:
* Map options===Usage=======The configuration====Via the toolbar {{man button|Configure View...}} button (or via the menu {{man menu|View}}) =====All views=====[[Image:* add crosshair in gramps-configuration-1.png|right|thumb|100px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} The map]] # Where to save the tiles of the map (default is ''$HOME/.gramps/maps''). Be careful, it can take several gigabytes.# The zoom level when we center the map or when we select one marker. Every time the Geographic View redraws the map, this zoomlevel will be used# Use keypad for shortcuts. Either we choose the + and - from the keypad if we select this or we use the characters from the keyboard. =====Specific views=====See the description of the view. ====How to zoom and move around the map ?==== =====Zoom in and Zoom out the map=====To zoom, usefull to add you can use :# The +/- buttons on the top left of the map# The scroll mouse.# The "+" or link places "-" key on the keypad (default). You can replace the numeric keypad by the alpha numeric keyboard in the configuration view. =====Move around the map=====To move around the map, you can :# Clic on the map, then drag it.# Use the arrows. ====The mouse actions on the map==== The right button below is for one right handed person.This will be the left button for one left handed person. =====button 1 ( left button )=====You have two usages for the button 1 :# The marker selection.# Valid the region selection =====button 2 ( middle button )=====The only usage for this button is to select an area on the correct latitude-longitude coordinatesmap.# when pressed :* start the region selection# when released, end the region selection.You must use the button 1 to validate the selected region when finished. =====button 3 ( right button )=====Only one usage for this button.# show coordinates the menu popup. =====The mouse over a marker=====When the mouse is placed over one marker, we display the place name in the statusbarstatus bar. ====The menu popup====From this menu, you have the following functions available for views :#hide or show the crosshair#lock or unlock the zoom#change the default map#add a place and link a place at the mouse position#center the map at the mouse position.#change the map provider ====Click on a marker====We have two cases :# events : For each event, we can edit this event or center the map on this place.* Time period# places : For each place, we can edit this changes how place or center the map on this place.When centering the view divides map, the zoom used is defined in the geography preferences. We may have several markers in the click area depending on the zoom.In this case, We show for each marker all related events and/or places.We obtain a mix between the two cases described above. ====Adding or Linking to a place====For this, click on the right button of the mouse, you'll get a popup menu.In this menu, you can select {{man label|Add place}} or {{man label|Link place}} When you add a place or try to link a place to the position of the mouse, you'll get a place selection in a region.You'll see on the map a circle in groupswhich you may choose markers place names. You can adjust the circle size with the cursor. Depending on the diameter of this circle, a list is created. If the place has already some filled fields, you'll see these values in a green color row. If you agree, you double click on this row. if you don't agree, you can choose another row. Another way to set latitude and longitude :* Network: This view needs an internet connectionDownload the [[Place completion tool]] via the [[4.1_Addons#Installing_Addons_in_Gramps|Addons manager]]. If you download the data of your connection drops away from time country, this tool can add latitude-longitude to all your places. ====How to timechange the map provider ?====We have several available providers in gramps.Click on the right button of the mouse, you'll get a popup menu.In the bottom of this menu, or you can select a new provider.The following providers are avalible :# OpenStreetMap (default) : The advantage of [http://www.openstreetmap.org/ OpenStreetMap] is that it is a free project, so you can update the maps yourself with missing information via their website.# Maps For Free# OpenCycleMap# Public Transport# Google street# Google sat# Google hybrid# Virtualearth street# Virtualearth sat# Virtualearth hybrid{{man tip|Some maps are not always onfree, please read the map provider ''Terms of Service'' :|[https://www.google.com/intl/en_ALL/help/terms_maps.html Google street], [https://www.google.com/intl/en_ALL/help/terms_maps.html Google sat], [https://www.google.com/intl/en_ALL/help/terms_maps.html Google hybrid], [http://www.microsoft.com/maps/product/terms.html Virtualearth street], [http://www.microsoft.com/maps/product/terms.html Virtualearth sat], and [http://www.microsoft.com/maps/product/terms.html Virtualearth hybrid] Remember virtualearth is now bing maps}} ====Can we change the marker's color ?====We can't do that. The marker's colors are hard coded in gramps.The colors are green for the following renderers : openstreetmap, Maps for free, Opencyclemap and Public transport.All others are red. ====How to get/remove the crosshair ?====It can be useful to have the crosshair visible to see the center of the map.This functionality is available with the right button of the mouse. you 'll get a popup menu.Select Add or Remove cross hair.This is usefull to add or link places to the correct latitude-longitude coordinates ====How to lock/unlock the map ?====When we change the map ( person to family, ... ), the zoom is recalculated.It can set here be useful in some case to have keep the same zoom and position when we change the map provider.For this, click on the Geographic view retry right button of the internet connectionmouse, you'll get a popup menu. Like In thismenu, you can select lock or unlock zoom and position. ===Prerequisites to see the Geographic geography view will become active ===For gramps 4.x, you need to install osmgpsmap version 1.0 and above and the moment your associated gir package. For example on ubuntu, you must have : gir1.2-osmgpsmap-1.0 and libosmgpsmap-1.0-0 ===Possible problems===#No view : do you have osmgpsmap installed ? (''gramps -v'' may help you)#No tiles : do you have an internet connection returnsactive ?#No tiles for one provider : if other providers are OK, without file a bug#Missing tiles : you have no internet connection and it's the first time you needing try to take manual actionshow the current place.#Missing tiles : this can be the same as no tiles for one provider if they modify the access rules (i.e user-agent)#Other : file a bug
== Sources Category ==
 
[[Image:SourcesCategoryViewCitationTree-40.png|left|300px|thumb|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Sources (Citation Tree) view]]
[[Image:SourcesCategoryView-40.png|right|400px|thumb|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Sources view]]
Sources View lists the sources of certain information stored in the database.
There are two views in this category. The default (Citation Tree View) shows all the sources, and for each it allows the user to see the Citations associated with that source by clicking on the disclosure triangle. The alternative view only shows the Sources.
 
{{-}}
 
[[Image:SourcesCategoryViewCitationTree-40.png|left|400px|thumb|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Sources (Citation Tree) view]]
[[Image:SourcesCategoryView-40.png|right|400px|thumb|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Sources view]]
 
{{-}}
Sources can include various documents (birth, death, and marriage certificates, etc.), books, films, journals, private diaries, - nearly anything that can provide genealogical evidence. Gramps gives you the option to provide a citation to a source for each event you record (births, deaths, marriages, etc.). The Sources View lists the {{man label|Title}} , {{man label|ID}} , and {{man label|Author}} of the source, as well as any {{man label|Publication}} information that may be associated with it.
Most frequently, these are images, audio files, animation files, etc. The list box on the bottom lists the {{man label|Name}} , {{man label|ID}} , {{man label|Type}} , and {{man label|Path}} of the Media Object.
The {{man label|Column Editor}} dialog may be used to rearrange the displayed columns, which obey usual sorting rules. The top bottom part of the Gramps window shows a preview (if available) in the "Preview" tab and information about the Media Objectis available from the other tabs. In the "Preview" tab you can double click on the media/photo to open it in the default picture viewer.
{{-}}
A Note is pure text, as stored in the other objects.
The functionality of the notes View is similar to the other views. The view lists all {{man label|Notes}} stored in the {{man label|Family Tree}}. Using the menu {{man menu|View ->Configure View...}} you open the {{man label|Column Editor}} and you can change the displayed columns. The possibilities are {{man label|Preview}}, {{man label|ID}}, {{man label| Type}}, {{man label|Private}}, {{man label|Tags}} and {{man label|MarkerLast Changed}}.
The {{man label|Type}} can be (amongst others): ''Event Note'', ''Address Note'',''Source text'', ''Place Note''
Double-clicking on a Note in the list will bring up a window where you can edit the Note. You can change fonts, font color and background color. A spellchecker is available for ''English'' and your local language.
 
By selecting two notes you can use {{man menu|Edit > Merge...}} from the menu to merge them.
{{-}}
== Hidden Web Category == {{man note|Note|By default the '''Web Category''' is normally hidden. The ''Web Category'' is called the '''Html View ''' in the Plugin Manager.}}{{man warn|Warning|From Gramps version 4.2.0 the '''Web Category ==''' was removed as a Gramps core plug and is separately available from the Third-Party Addons as [[Addon:HtmlView|HtmlView]]}}
[[Image:Unhide_Html_View.png|right|thumb|400px|Fig. {{#var:chapter}}.{{#vardefineecho:figure|{{#expr:{{#var:figure}}+1}}}} Unhide Html View]]
In order to make this view avaiablethe ''Web Category/Html View'' available:* You must ensure that the webkit module is available.(???)
* Once you have started Gramps with the webkit module available, you can go into {{man menu|Help ->Plugin Manager}}, find the Html View item,select it and click on {{man button|Hide/Unhide}}.
* You must then quit Gramps and start it up again.

Navigation menu