Difference between revisions of "Gramps 3.3 Wiki Manual - What's new?"

From Gramps
Jump to: navigation, search
m (Database)
m (remove from cleanup)
 
(50 intermediate revisions by 4 users not shown)
Line 1: Line 1:
 
{{grampsmanualcopyright}}
 
{{grampsmanualcopyright}}
  
{{man index|Gramps 3.3 Wiki Manual - Preface|Gramps 3.3 Wiki Manual - Getting Started|3.3}}
+
{{man index|Gramps 3.3 Wiki Manual - Preface|Gramps 3.3 Wiki Manual - Getting started|3.3}}
  
 
{{languages|Gramps 3.3 Wiki Manual - What's new?}}
 
{{languages|Gramps 3.3 Wiki Manual - What's new?}}
  
This section gives an overview of changes since version 3.2. These changes are also detailed later in this manual. Users of version 3.2 are encouraged to review this section to be sure to take advantage of these new features.
+
This section gives an overview of changes since Gramps version 3.2. These changes are also detailed later in this manual. Users of Gramps version 3.2 are encouraged to review this section to be sure to take advantage of these new features.
  
 
= Before you upgrade =  
 
= Before you upgrade =  
Line 14: Line 14:
 
# Start Gramps 3.2
 
# Start Gramps 3.2
 
# Open your family tree
 
# Open your family tree
# Export the family tree to the ''gramps xml'' format or the ''gramps xml package'' format (which includes your photographs and other media files associated with your family tree data). Export your tree via menu '''Family Trees->Export''', making sure you export all data with no filters applied.
+
# Export the family tree to the ''gramps xml'' format or the ''gramps xml package'' format (which includes your photographs and other media files associated with your family tree data). Export your tree via menu {{man menu|Family Trees->Export}}, making sure you export all data with no filters applied.
 
# Close this family tree and repeat the above steps for any other family trees you have
 
# Close this family tree and repeat the above steps for any other family trees you have
 
# Keep the resulting file(s) in a safe place
 
# Keep the resulting file(s) in a safe place
Line 26: Line 26:
  
 
{{man warn| Warning |Once you open a family tree in a newer version of Gramps '''or''' using a newer operating system, you generally should not try to open that database using an older version again. As always, the ''gramps xml'' format is the format to use for the interchange of your data in such cases. There are tools to repair broken databases, but they are for expert users, so avoid needing them by following the steps above before you upgrade your OS or Gramps.}}
 
{{man warn| Warning |Once you open a family tree in a newer version of Gramps '''or''' using a newer operating system, you generally should not try to open that database using an older version again. As always, the ''gramps xml'' format is the format to use for the interchange of your data in such cases. There are tools to repair broken databases, but they are for expert users, so avoid needing them by following the steps above before you upgrade your OS or Gramps.}}
 
  
 
= Visible changes to the core =
 
= Visible changes to the core =
Line 38: Line 37:
 
* New filter rules
 
* New filter rules
  
== Sidebar and bottombar ==
+
{{man warn|Custom rules migration|For avoiding unwanted effects after major upgrades (eg, from 3.2.x to 3.3.x), if need, we can manually copy our ''custom_filter.xml'' from [[GRAMPS User Directory]] to ''gramps_version_number''.}}
  
* New Gramplets
+
== GrampsBar ==
 +
 
 +
A sidebar and bottombar are available on all views except for the Gramplet View.  They allow gramplets to be displayed alongside a view.
 +
 
 +
See [[Gramps_3.3_Wiki_Manual_-_Gramplets|Gramplets]] for more details.
  
 
== Tags ==
 
== Tags ==
 +
 +
Tags replace Markers.  Tagging is available for Person, Family, Media and Note objects.  Users can tag an object with multiple tags.
  
 
== Merging ==
 
== Merging ==
  
== Pedigree view ==
+
All primary objects could now be merged.
  
More: [[Gramps_3.3_Wiki_Manual_-_Main_Window#Pedigree_View|Pedigree View]]
+
See [[Gramps_3.3_Wiki_Manual_-_Entering_and_Editing_Data:_Detailed_-_part_3#Merging_records|Merging Records]] for more details.
 +
 
 +
== Locality ==
 +
 
 +
A Locality field has been added to Location between the Street and City fields.
 +
 
 +
{{man warn|Custom rules migration|For avoiding unwanted effects after major upgrades (eg, from 3.2.x to 3.3.x), if need, we can manually copy our ''custom_filter.xml'' from [[GRAMPS User Directory]] to ''gramps_version_number''.}}
  
== Better place handling ==
+
== New Selection Dialog in Export ==
  
== New Exporter ==
+
When exporting your data, you now have a fine-grained control over the details of how filters can be applied. You also can now check which records are selected (and which ones are not) through this interface.
  
 
== More tooltips ==
 
== More tooltips ==
  
== Url style on Note ==
+
All fields on Editors have now tooltips.
 +
 
 +
== Linking in Notes ==
 +
 
 +
Notes now support links to other items in Gramps. For example, when writing a note, you can put a link to a person, family, or marriage. When viewing these notes, you can quickly click on the link and bring up the object.
 +
 
 +
Links are also converted to HTML links when, for example, running the Narrative Web report.
  
 
== Backup dialog ==
 
== Backup dialog ==
  
<br clear="all" />
+
Simply select "{{man menu|Make Backup...}}" from the "{{man menu|Family Trees}}" menu item.
 +
 
 +
[[Image:MakeBackup.png]]
 +
 
 +
You can either choose to include the media or not.
 +
 
 +
Note that this is just a regular XML export, except that no data is filtered out. You can import these as usual with any exported file.
 +
 
 +
You can also define the pattern for the backup filename by setting the ''paths.quick-backup-filename'' in the ~/.gramps/gramps33/gramps.ini key file like the following:
 +
 
 +
[paths]
 +
quick-backup-filename='%(filename)s_%(year)d-%(month)02d-%(day)02d.%(extension)s'
 +
 
 +
You can use any of the following keywords in the pattern: year, month, day, hour, minutes, seconds, filename, extension.
 +
 
 +
{{-}}
 +
 
 +
= Plugins changes =
 +
 
 +
== Views ==
 +
 
 +
* Pedigree view
 +
 
 +
[[Image:Pedigree_layout.png]]
 +
 
 +
More: [[Gramps_3.3_Wiki_Manual_-_Main_Window#Pedigree_View|Pedigree View]]
 +
 
 +
* GeoView
 +
 
 +
More: [[Gramps_3.3_Wiki_Manual_-_Main_Window#Geography_Category|GeoView]]
 +
 
 +
== Automatic update for Addons ==
  
= Plugin changes =
+
Gramps now supports a method for automatically checking for updated Addons. You can control what and how often it checks for new and updated addons.
  
== Update Addons ==
+
These settings are controlled in Preferences.
  
* Preferences
+
=== News ===
 +
* "Image Metadata Gramplet" now works with pyexiv2-0.1.3 and above
  
 
== Reports ==
 
== Reports ==
  
* Draw
+
* Draw reports
  
 
* Substitution Keys
 
* Substitution Keys
 +
 +
* Alternate Numbering on Descendant report {{bug|3635}}
  
 
* CLI
 
* CLI
Line 80: Line 131:
 
* Web stuff
 
* Web stuff
  
<br clear="all" />
+
* Improvements on Place report
 +
 
 +
* StringOption separated from GUI widget {{bug|4593}}
 +
 
 +
* Records report and gramplet {{bug|3220}}
 +
 
 +
{{-}}
  
 
= Under the hood changes =
 
= Under the hood changes =
  
 
== Database ==
 
== Database ==
 +
 +
There were three changes to the database file structure:
 +
 +
# Added a new field "locality" to the Place schema
 +
# Added surnames to the Name schema
 +
#* surnames is a list of surnames
 +
#* prefix and patronymic are moved to the surname
 +
# Replaced Markers with Tags
 +
#* marker removed from all
 +
#* tags added to Person, Media, Family, and Notes
  
 
* Transaction
 
* Transaction
Line 94: Line 161:
  
 
* python 2.6 and later
 
* python 2.6 and later
*  
+
*
 +
 
 +
=== Optional ===
 +
* exif
 +
* pyexiv2-0.1.3, pyexiv2-0.2.2, or pyexiv2-0.3.0
 +
*
  
== Performance ==
+
== Performances ==
  
 
* Improvements (memory leaks) [http://gramps-project.org/2010/11/memory-leaks-finally-gone/]
 
* Improvements (memory leaks) [http://gramps-project.org/2010/11/memory-leaks-finally-gone/]
Line 102: Line 174:
 
* Speed up on gramplets (pedigree)
 
* Speed up on gramplets (pedigree)
  
== Cleanup ==
+
== Localisation ==
 +
 
 +
* New translations: Ukrainian, Portuguese from Portugal
 +
* Lang selector on Detailed textual reports
 +
* Holidays on Calendar reports
 +
* Improvements on some Date handlers
 +
* Better translation on some addons
 +
* cleanup (configure, makefiles)
 +
* Better support for win32/64 API
  
<br clear="all" />
+
{{-}}
  
 
= Further info =
 
= Further info =
'''TODO''': need to update above content with:
+
 
  
  
Line 118: Line 198:
 
* Sidebar/bottombar [http://www.gramps-project.org/wiki/index.php?title=GEPS_019:_Improved_Sidebar_and_Split_Views]
 
* Sidebar/bottombar [http://www.gramps-project.org/wiki/index.php?title=GEPS_019:_Improved_Sidebar_and_Split_Views]
 
* New Individual Editor [http://gramps-project.org/2010/10/multiple-surnames/][http://gramps-project.org/2010/11/final-multiple-surnames/]
 
* New Individual Editor [http://gramps-project.org/2010/10/multiple-surnames/][http://gramps-project.org/2010/11/final-multiple-surnames/]
* Enhanced Pedigree View [http://www.gramps-project.org/bugs/view.php?id=2846] and support 'config' on views into ancestry category [http://www.gramps-project.org/bugs/view.php?id=3710].
+
* [[GEPS_025:_Geography|Geography]]
* [[Display_formatting3.3|Substitution Keys]]
+
* Enhanced Pedigree View [http://www.gramps-project.org/bugs/view.php?id=2846] and support 'config' on views into ancestry category {{bug|3710}}.
 +
* [[Gramps_3.3_Wiki_Manual_-_Reports_-_part_2#Substitution_Values|Substitution Keys]]
 
* Draw reports: [[Ancestor3.3]], [[Descendant3.3]], [[Page_size3.3]]
 
* Draw reports: [[Ancestor3.3]], [[Descendant3.3]], [[Page_size3.3]]
 
* Exporter has added control of filters and proxies; also has method for seeing intermediate results along the filtering process   
 
* Exporter has added control of filters and proxies; also has method for seeing intermediate results along the filtering process   
* New simple backup option on menu
+
* New simple [[How_to_make_a_backup#GRAMPS_version_3.3_and_later|backup option on menu]]
 
* New gramplets and performance improvements (Pedigree gramplet)
 
* New gramplets and performance improvements (Pedigree gramplet)
 
* Url style on Note object (internal uri)
 
* Url style on Note object (internal uri)
Line 128: Line 209:
 
* New filter rules
 
* New filter rules
 
* Complete tooltips on editors and manual
 
* Complete tooltips on editors and manual
* Use language selector on detailled reports, enhancement on place report, translated holiday names, numbering system alternatives on descendant report [http://www.gramps-project.org/bugs/view.php?id=3635], better support for win32/mac packages, cleanup, need python 2.6 or later, new translations (Ukrainian, Portuguese from Portugal), etc ...
+
* Use language selector on detailled reports, enhancement on place report, translated holiday names, numbering system alternatives on descendant report {{bug|3635}}, better support for win32/mac packages, cleanup, need python 2.6 or later, new translations (Ukrainian, Portuguese from Portugal), etc ...
  
  
{{man index|Gramps 3.3 Wiki Manual - Preface|Gramps 3.3 Wiki Manual - Getting Started|3.3}}
+
{{man index|Gramps 3.3 Wiki Manual - Preface|Gramps 3.3 Wiki Manual - Getting started|3.3}}
  
  

Latest revision as of 08:37, 23 January 2013

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


Previous Index Next


This section gives an overview of changes since Gramps version 3.2. These changes are also detailed later in this manual. Users of Gramps version 3.2 are encouraged to review this section to be sure to take advantage of these new features.

Before you upgrade

Gnome-important.png
Warning

Creating an archive alone to safeguard your data might not be appropriate before upgrading. In the unlikely event that Gramps 3.3 corrupts your database, it could also corrupt the archive. An export as outlined in this section is recommended.

Before you upgrade, make sure your family tree data is secure. The best way to do this is:

  1. Start Gramps 3.2
  2. Open your family tree
  3. Export the family tree to the gramps xml format or the gramps xml package format (which includes your photographs and other media files associated with your family tree data). Export your tree via menu Family Trees->Export, making sure you export all data with no filters applied.
  4. Close this family tree and repeat the above steps for any other family trees you have
  5. Keep the resulting file(s) in a safe place

For more information, please review Backing up a Family Tree.


After properly safeguarding your data, proceed to install Gramps 3.3. Use your operating system's regular installation process to do this. It is also best to uninstall Gramps 3.2 before installing Gramps 3.3, or make sure you install Gramps 3.3 in a different location.

After you install Gramps 3.3, you can open your existing family trees and continue working. In case of problems (e.g., after a complete system upgrade), use the backup file(s) created above to recreate your family tree(s).

Gnome-important.png
Warning

Once you open a family tree in a newer version of Gramps or using a newer operating system, you generally should not try to open that database using an older version again. As always, the gramps xml format is the format to use for the interchange of your data in such cases. There are tools to repair broken databases, but they are for expert users, so avoid needing them by following the steps above before you upgrade your OS or Gramps.

Visible changes to the core

Names

  • Formats
  • New Editor
  • New filter rules
Gnome-important.png
Custom rules migration

For avoiding unwanted effects after major upgrades (eg, from 3.2.x to 3.3.x), if need, we can manually copy our custom_filter.xml from GRAMPS User Directory to gramps_version_number.

GrampsBar

A sidebar and bottombar are available on all views except for the Gramplet View. They allow gramplets to be displayed alongside a view.

See Gramplets for more details.

Tags

Tags replace Markers. Tagging is available for Person, Family, Media and Note objects. Users can tag an object with multiple tags.

Merging

All primary objects could now be merged.

See Merging Records for more details.

Locality

A Locality field has been added to Location between the Street and City fields.

Gnome-important.png
Custom rules migration

For avoiding unwanted effects after major upgrades (eg, from 3.2.x to 3.3.x), if need, we can manually copy our custom_filter.xml from GRAMPS User Directory to gramps_version_number.

New Selection Dialog in Export

When exporting your data, you now have a fine-grained control over the details of how filters can be applied. You also can now check which records are selected (and which ones are not) through this interface.

More tooltips

All fields on Editors have now tooltips.

Linking in Notes

Notes now support links to other items in Gramps. For example, when writing a note, you can put a link to a person, family, or marriage. When viewing these notes, you can quickly click on the link and bring up the object.

Links are also converted to HTML links when, for example, running the Narrative Web report.

Backup dialog

Simply select "Make Backup..." from the "Family Trees" menu item.

MakeBackup.png

You can either choose to include the media or not.

Note that this is just a regular XML export, except that no data is filtered out. You can import these as usual with any exported file.

You can also define the pattern for the backup filename by setting the paths.quick-backup-filename in the ~/.gramps/gramps33/gramps.ini key file like the following:

[paths]
quick-backup-filename='%(filename)s_%(year)d-%(month)02d-%(day)02d.%(extension)s'

You can use any of the following keywords in the pattern: year, month, day, hour, minutes, seconds, filename, extension.


Plugins changes

Views

  • Pedigree view

Pedigree layout.png

More: Pedigree View

  • GeoView

More: GeoView

Automatic update for Addons

Gramps now supports a method for automatically checking for updated Addons. You can control what and how often it checks for new and updated addons.

These settings are controlled in Preferences.

News

  • "Image Metadata Gramplet" now works with pyexiv2-0.1.3 and above

Reports

  • Draw reports
  • Substitution Keys
  • Alternate Numbering on Descendant report 3635
  • CLI
  • Book
  • Web stuff
  • Improvements on Place report
  • StringOption separated from GUI widget 4593
  • Records report and gramplet 3220


Under the hood changes

Database

There were three changes to the database file structure:

  1. Added a new field "locality" to the Place schema
  2. Added surnames to the Name schema
    • surnames is a list of surnames
    • prefix and patronymic are moved to the surname
  3. Replaced Markers with Tags
    • marker removed from all
    • tags added to Person, Media, Family, and Notes
  • Transaction
  • Merging
  • New DB version; and XML DTD (1.4.0) [1]
  • Improvements on Import/Export file formats (vcard, gedcom, xml)

Dependencies

  • python 2.6 and later

Optional

  • exif
  • pyexiv2-0.1.3, pyexiv2-0.2.2, or pyexiv2-0.3.0

Performances

  • Improvements (memory leaks) [2]
  • time for XML import
  • Speed up on gramplets (pedigree)

Localisation

  • New translations: Ukrainian, Portuguese from Portugal
  • Lang selector on Detailed textual reports
  • Holidays on Calendar reports
  • Improvements on some Date handlers
  • Better translation on some addons
  • cleanup (configure, makefiles)
  • Better support for win32/64 API


Further info

See the 3.3.0 roadmap, the change log and Roadmap.

  • Additional Name Fields [3][4]
  • Tagging
  • Place handling
  • Database (XML /part of GEPS016/, transaction, merging /part of GEPS009/)
  • Sidebar/bottombar [5]
  • New Individual Editor [6][7]
  • Geography
  • Enhanced Pedigree View [8] and support 'config' on views into ancestry category 3710.
  • Substitution Keys
  • Draw reports: Ancestor3.3, Descendant3.3, Page_size3.3
  • Exporter has added control of filters and proxies; also has method for seeing intermediate results along the filtering process
  • New simple backup option on menu
  • New gramplets and performance improvements (Pedigree gramplet)
  • Url style on Note object (internal uri)
  • Automatic check for update (Addons)
  • New filter rules
  • Complete tooltips on editors and manual
  • Use language selector on detailled reports, enhancement on place report, translated holiday names, numbering system alternatives on descendant report 3635, better support for win32/mac packages, cleanup, need python 2.6 or later, new translations (Ukrainian, Portuguese from Portugal), etc ...


Previous Index Next