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

From Gramps
Jump to: navigation, search
m (Before you upgrade: Reworded the "Creating an archive ..." warning and the "After properly safeguarding ..." paragraph to make them more clear.)
m (Protected "Gramps 5.0 Wiki Manual - What's new?": make older user manual read only ([Edit=Allow only administrators] (indefinite) [Move=Allow only administrators] (indefinite)))
 
(32 intermediate revisions by 3 users not shown)
Line 2: Line 2:
 
{{languages|Gramps 5.0 Wiki Manual - What's new?}}
 
{{languages|Gramps 5.0 Wiki Manual - What's new?}}
  
This section gives an overview of changes since Gramps version 3.4. These changes are also detailed later in this manual. Users of Gramps upgrading from version 3.4 or 4.1 are encouraged to review this section to be sure to take advantage of these new features when they start using version 5.0.
+
This section gives an overview of changes since Gramps version 4.2 These changes are also detailed later in this manual. Users of Gramps upgrading from earlier versions are encouraged to review this section in older [[User_manual|user manuals]] to be sure to take advantage of these new features when they start using version 5.0.
  
 
= Before you upgrade =  
 
= Before you upgrade =  
Line 9: Line 9:
  
 
Before you upgrade, make sure your family tree data is secure. The best way to do this is:
 
Before you upgrade, make sure your family tree data is secure. The best way to do this is:
# Start Gramps 3.4 or Gramps 4.1
+
# Start Gramps 3.4 or Gramps 4.2
 
# Open your family tree
 
# Open your family tree
 
# Back up the family tree to the ''gramps xml'' format or the ''gramps xml package'' format (the ''gramps xml package'' includes your photographs and other media files associated with your family tree data). Backup your tree via menu {{man menu|Family Trees->Make Backup...}}.
 
# Back up the family tree to the ''gramps xml'' format or the ''gramps xml package'' format (the ''gramps xml package'' includes your photographs and other media files associated with your family tree data). Backup your tree via menu {{man menu|Family Trees->Make Backup...}}.
Line 15: Line 15:
 
# Keep the resulting file(s) in a safe place
 
# Keep the resulting file(s) in a safe place
  
For more information, please review [[Gramps_4.1_Wiki_Manual_-_Manage_Family_Trees#Backing_up_a_Family_Tree|Backing up a Family Tree]].  
+
For more information, please review [[Gramps_5.0_Wiki_Manual_-_Manage_Family_Trees#Backing_up_a_Family_Tree|Backing up a Family Tree]].  
  
  
Line 30: Line 30:
 
== Data Model ==
 
== Data Model ==
  
There are changes to the data model:
+
Details of changes to the data model (if any):
  
# New date and language fields on place name
+
# No change
 +
<hr>
  
 +
* A Family Tree '''cannot be opened''' in Gramps 3.4/4.0/4.1/4.2 and Gramps 5.0 without upgrade.
  
* A Family Tree '''cannot be opened''' in Gramps 3.4/4.0/4.1 and Gramps 5.0 without upgrade or downgrade.  
+
* A downgrade can only be accomplished by exporting XML and importing to the previous version.  
  
 
* A Gramps XML file generated by Gramps 3.4/4.0/4.1 is '''not identical''' to one generated by Gramps 5.0.
 
* A Gramps XML file generated by Gramps 3.4/4.0/4.1 is '''not identical''' to one generated by Gramps 5.0.
Line 43: Line 45:
 
See [[Database_Formats#Detailed_Changes|detailed changes]] for more details on internal database.
 
See [[Database_Formats#Detailed_Changes|detailed changes]] for more details on internal database.
  
==GUI==
+
==Primary changes==
 +
* You can now choose to use alternative database backends.  BSDDB is still the default, but Sqlite is now available.  For power users, PostgreSql and MongoDB are available as experimental third-party addons.
 +
The developers believe that Sqlite may have fewer database corruptions that prevent easy recovery.
  
* Review on GtkBuilder, fix some Gtk3 warnings and move from deprecated methods
+
* Options for automatic backup periodically and on exit.  The Backup on exit is the default.
* Change icons and buttons handling methods
+
* Config: new database-backup-use-compression option
<hr>
 
* [[Gramps_5.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_2#Place_Editor_dialog|Enhanced Place Editor]]
 
[[Image:Place_editor_42.png|New place Editor with Place name edition]]
 
<hr>
 
{{-}}
 
  
* New widget: ''[[Gramps_5.0_Wiki_Manual_-_Navigation#Finding_records|interactive searchbox]]''. Use our own interactive-search box to get it.
+
==GUI==
[[Image:Interactive_search.png|New interactive search box]]
+
* New color schemes allow a light and dark choice.
{{-}}
+
* Additional color indications in graphs for Home person, Unknown Alive, Family, Family divorced.
# more efficient (binary search on sorted columns).
+
* Add "within <n> km/miles/degree" filter
# customizable (delayed by 150ms launch of search to avoid text scrambling)
+
* Ability to be able to enter comma separated latitude/longitude pairs
  
* Ability to [[Gramps_5.0_Wiki_Manual_-_Categories#Adding_places_from_KML_files|import KML]] data into Geography views
+
* Sidebar resizes better, position is remembered
* Enhancement for removing multiple selected items from Views (action group)
+
* Person SurName editor is more intuitive to use.
[[Image:Action_group_dialog.png|Question dialog for grouped actions]]
+
* View Buttons order no longer changes with different startup.
{{-}}
+
* Better progress indication for long running operations
 +
* Windows remember size/position
 +
* add FanChart2Way
 +
* Add kmls for the geography places view.
  
* Allow to drag a person by dragging the Family label or around Add, Edit, Share buttons.
+
==Place==
Add drag support on more Views, Selectors and Editors.
+
* ability to search alternate place names when selecting place
  
* Add right-click "Copy all" to all [[Gramps_5.0_Wiki_Manual_-_Reports_-_part_8|QuickTables]].
+
== Reports, Tools, Gramplets ==
All data from the TreeView, including non-viewed columns.
+
* new genealogy tree report
* Add right-click API to ListModel
+
* Place format editor and option for many reports
 +
* Date format Editor and option for many reports
 +
* option how to report living people for many reports
  
==Place==
+
* ReorderIDs tool has been upgraded; can now work around customized IDs (like GetGov IDs).
 +
* Narrative web has additional options and appearance changes.
 +
** Allows output in different language
 +
** Date output option
 +
** Statistics page
 +
** Add option to Include all / unreferenced Media objects
 +
** relationship to central person on individual pages
 +
* Add thumbnail size option to family lines graph
 +
* Enhance the Descendant Report and Detailed Descendant Report
 +
* Complete Individual Report add options
 +
** enable to include or exclude Person and Family Notes
 +
** add option to include or exclude census data
 +
** option to include relationship to center person
 +
** options to include GrampsID, Tags, Attributes
 +
* Include all place types in place report
 +
* Relationship, Family Lines,  Hourglass Graphs options how lines are drawn
  
* [[Gramps_5.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_2#Place_Editor_dialog|Enhanced Place Editor]] and new [[Gramps_5.0_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_2#Place_Name_Editor_dialog|Place Name editor]]
+
==Import/Export==
[[Image:Place_name_editor.png|New Place Name editor]]
+
* Gedcom supports more non-standard 'tags' and additional standard tags
<hr>
+
* GEDCOM 5.5.1 Support Custom Event on export
{{-}}
+
* XML export new compression option
* Review Alternate Place handling and edition
 
* New configuration keys set by user (settings) - [[Gramps_5.0_Wiki_Manual_-_Settings#Places|{{man label|Places}}]] tab options in {{man menu|Edit > Preferences}} dialog
 
[[Image:Place_settings_42.png|New Places item into Preferences dialog]]
 
{{-}}
 
* New filter rule: ''is enclosed by''
 
 
 
== Reports, Tools, Gramplets ==
 
  
* Consistency on '''Privacy''' option for reports
+
==New Addons==
[[Image:Include_private.png|Standard ''Privacy'' check box]]
+
* Quilt Chart view: The view shows a quilt chart visualization of a family tree
{{-}}
+
* Plugin Manager Enhanced: An Addon/Plugin Manager with several additional capabilities
* Consistency on "Name-format" options for reports
+
* Sandclock Tree: Sandclock tree using LaTeX genealogytree
* Add DeferredFilter class (a subclass of GenericFilter)
+
* Import and Merge tool: Compares a Gramps XML database with the current one, and allows merging of the differences.
* New textual Report : [[Gramps_5.0_Wiki_Manual_-_Reports_-_part_6#Note_Link_Report|Note Link Report]]: Check Links on Notes are valid
+
* Check Associations data: Will check the data on Association for people.
* Fix alphabetic index and toc bug in books
 
* Enhancements on Style Editor
 
* Enhancements on End Notes into textual reports
 
* Changes on Individuals complete textual report
 
* Changes on Ancestors Tree draw report: Include Siblings and ready to go in multiple directions
 
* Add name-format option, and deferred translation on Records report
 
* Add deferred translation on Timeline draw report
 
* Enable [[Gramps_5.0_Wiki_Manual_-_Gramplets#Attributes_Gramplet|attributes gramplet]] on Source and Citation Views
 
[[Image:Attributes_gramplet_source_citation.png|Enabled Attributes gramplet for Source and Citation objects]]
 
{{-}}
 
* Add new place [[Gramps_5.0_Wiki_Manual_-_Gramplets#Location_Gramplet|locations gramplet]]
 
  
 
= Under the hood changes =
 
= Under the hood changes =
  
Technical stuff
+
Technical changes.
 +
* Numerous changes relating to support for other Database backends (Sqlite, PostgreSQL, MongoDB etc.).
 +
* Certain database corruptions (handles to non-existent objects) that were previously hidden are now regarded as errors.  It may be necessary to run the Check and Repair tool to fix exceptions with a corrupted database.
 +
* Fixes to prevent the user from closing or changing the database during long running operations.
  
 
==Dependencies==
 
==Dependencies==
Line 113: Line 117:
  
 
= Further information =
 
= Further information =
 
More information.
 
  
 
== Miscellaneous ==
 
== Miscellaneous ==
 
* Optimizations around index, Flat and TreeView models
 
* More data into ''example.gramps'': custom parent relationship, notes.
 
* New test file: ''datetest.gramps''
 
* New module: ''[https://github.com/gramps-project/gramps/blob/master/gramps/gen/lib/placename.py gen.lib.placename]''
 
* All importers return now an [https://github.com/gramps-project/gramps/blob/master/gramps/gen/utils/libformatting.py#L201 ImportInfo] object that can hold information about the import.
 
* Experimental gwplus (geneweb) import file format support
 
* libgedcom changes ???
 
* Remove fallback to md5 module, all supported versions now include the hashlib module.
 
* Removed experimental [[Addon:HtmlView|HTML renderer view]]
 
* New test scripts
 
  
 
== Localization ==
 
== Localization ==
 
+
* Update translations: ca, cs, da, de, en_GB, eo, fr, fi, hu, is, it, lt, nb, nl, pt_BR, pt_PT, ru, sk, sl, uk, vi
* Limit usage of markup into messages, better separation of content (str) and style (GUI).
 
* New [[Date Handler]] for [https://github.com/gramps-project/gramps/blob/master/gramps/gen/datehandler/_date_ja.py Japanese]
 
* Review on Slovenian and Czech Date Handlers
 
* New translations and date handlers : implement both "traditional" and "simplified" Chinese
 
* Serbian review
 
 
 
 
== Roadmap ==
 
== Roadmap ==
  
* [[Roadmap]]: [http://www.gramps-project.org/bugs/roadmap_page.php?version_id=53 5.0.0]
+
*See items related to Gramps [https://gramps-project.org/bugs/roadmap_page.php 5.0]
 +
*[[:Category:GEPS|Gramps Enhancement Proposals (GEPS)]] - See '''Released''' column for new items implemented in Gramps 5.0
  
 
== Changelog ==
 
== Changelog ==
  
* [http://www.gramps-project.org/bugs/changelog_page.php?version_id=53 Changelog 5.0.0]
+
* See items related to Gramps [https://gramps-project.org/bugs/changelog_page.php 5.0] on the Gramps issue tracker.
  
 +
* See additional information see the changelogs for the test releases of Gramps:
 +
** Gramps [https://github.com/gramps-project/gramps/releases/tag/v5.0.0-alpha1 5.0.0-alpha1]
 +
** Gramps [https://github.com/gramps-project/gramps/releases/tag/v5.0.0-alpha2 5.0.0-alpha2]
 +
** Gramps [https://github.com/gramps-project/gramps/releases/tag/v5.0.0-alpha3 5.0.0-alpha3]
 +
** Gramps [https://github.com/gramps-project/gramps/releases/tag/v5.0.0-beta1 5.0.0-beta1]
 +
** Gramps [https://github.com/gramps-project/gramps/releases/tag/v5.0.0-rc1 5.0.0-rc1]
 +
** Gramps [https://github.com/gramps-project/gramps/releases/tag/v5.0.0 5.0.0]
 +
** Gramps [https://github.com/gramps-project/gramps/releases/tag/v5.0.1 5.0.1]
 +
{{-}}
 
{{man index|Gramps 5.0 Wiki Manual - Preface|Gramps 5.0 Wiki Manual - Getting started|5.0}}
 
{{man index|Gramps 5.0 Wiki Manual - Preface|Gramps 5.0 Wiki Manual - Getting started|5.0}}
 
 
{{languages|Gramps 5.0 Wiki Manual - What's new?}}
 
{{languages|Gramps 5.0 Wiki Manual - What's new?}}
 
 
{{grampsmanualcopyright}}
 
{{grampsmanualcopyright}}
  
 
[[Category:Documentation]]
 
[[Category:Documentation]]

Latest revision as of 01:03, 1 July 2019

Previous Index Next

This section gives an overview of changes since Gramps version 4.2 These changes are also detailed later in this manual. Users of Gramps upgrading from earlier versions are encouraged to review this section in older user manuals to be sure to take advantage of these new features when they start using version 5.0.

Before you upgrade

Gnome-important.png
Warning

Creating an archive before upgrading might not alone be sufficient to safeguard your data: In the unlikely event that Gramps 5.0 corrupts your database, it could also corrupt the archive. A backup of your data 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.4 or Gramps 4.2
  2. Open your family tree
  3. Back up the family tree to the gramps xml format or the gramps xml package format (the gramps xml package includes your photographs and other media files associated with your family tree data). Backup your tree via menu Family Trees->Make Backup....
  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 5.0 using your operating system's regular installation process. In most cases, this will ensure that the new Gramps 5.0 installation will not clash with your older version of Gramps. However, it may be safer to uninstall Gramps 3.4 before installing Gramps 5.0, or make sure you install Gramps 5.0 in a different location. This is always necessary if you are installing from the source code. For more information on installing Gramps 5.0, please see Downloading the latest Gramps

After you install Gramps 5.0, you can open your existing family trees and continue working. In case of problems (e.g., after a complete system upgrade), import 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

Changes visible after the migration: interface, data.

Data Model

Details of changes to the data model (if any):

  1. No change

  • A Family Tree cannot be opened in Gramps 3.4/4.0/4.1/4.2 and Gramps 5.0 without upgrade.
  • A downgrade can only be accomplished by exporting XML and importing to the previous version.
  • A Gramps XML file generated by Gramps 3.4/4.0/4.1 is not identical to one generated by Gramps 5.0.
  • Gramps 5.0 is now python3 only

See detailed changes for more details on internal database.

Primary changes

  • You can now choose to use alternative database backends. BSDDB is still the default, but Sqlite is now available. For power users, PostgreSql and MongoDB are available as experimental third-party addons.

The developers believe that Sqlite may have fewer database corruptions that prevent easy recovery.

  • Options for automatic backup periodically and on exit. The Backup on exit is the default.
  • Config: new database-backup-use-compression option

GUI

  • New color schemes allow a light and dark choice.
  • Additional color indications in graphs for Home person, Unknown Alive, Family, Family divorced.
  • Add "within <n> km/miles/degree" filter
  • Ability to be able to enter comma separated latitude/longitude pairs
  • Sidebar resizes better, position is remembered
  • Person SurName editor is more intuitive to use.
  • View Buttons order no longer changes with different startup.
  • Better progress indication for long running operations
  • Windows remember size/position
  • add FanChart2Way
  • Add kmls for the geography places view.

Place

  • ability to search alternate place names when selecting place

Reports, Tools, Gramplets

  • new genealogy tree report
  • Place format editor and option for many reports
  • Date format Editor and option for many reports
  • option how to report living people for many reports
  • ReorderIDs tool has been upgraded; can now work around customized IDs (like GetGov IDs).
  • Narrative web has additional options and appearance changes.
    • Allows output in different language
    • Date output option
    • Statistics page
    • Add option to Include all / unreferenced Media objects
    • relationship to central person on individual pages
  • Add thumbnail size option to family lines graph
  • Enhance the Descendant Report and Detailed Descendant Report
  • Complete Individual Report add options
    • enable to include or exclude Person and Family Notes
    • add option to include or exclude census data
    • option to include relationship to center person
    • options to include GrampsID, Tags, Attributes
  • Include all place types in place report
  • Relationship, Family Lines, Hourglass Graphs options how lines are drawn

Import/Export

  • Gedcom supports more non-standard 'tags' and additional standard tags
  • GEDCOM 5.5.1 Support Custom Event on export
  • XML export new compression option

New Addons

  • Quilt Chart view: The view shows a quilt chart visualization of a family tree
  • Plugin Manager Enhanced: An Addon/Plugin Manager with several additional capabilities
  • Sandclock Tree: Sandclock tree using LaTeX genealogytree
  • Import and Merge tool: Compares a Gramps XML database with the current one, and allows merging of the differences.
  • Check Associations data: Will check the data on Association for people.

Under the hood changes

Technical changes.

  • Numerous changes relating to support for other Database backends (Sqlite, PostgreSQL, MongoDB etc.).
  • Certain database corruptions (handles to non-existent objects) that were previously hidden are now regarded as errors. It may be necessary to run the Check and Repair tool to fix exceptions with a corrupted database.
  • Fixes to prevent the user from closing or changing the database during long running operations.

Dependencies

  • Support python3 only. ( python2 support dropped)
  • Need GTK+ 3.10 and pygobject 3.12 or greater versions

Further information

Miscellaneous

Localization

  • Update translations: ca, cs, da, de, en_GB, eo, fr, fi, hu, is, it, lt, nb, nl, pt_BR, pt_PT, ru, sk, sl, uk, vi

Roadmap

Changelog

  • See items related to Gramps 5.0 on the Gramps issue tracker.


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