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

From Gramps
Jump to: navigation, search
m (Editors)
 
m (New exporter, help and bug report dialogs)
(43 intermediate revisions by 3 users not shown)
Line 5: Line 5:
 
{{languages|Gramps 4.0 Wiki Manual - What's new?}}
 
{{languages|Gramps 4.0 Wiki Manual - What's new?}}
  
This section gives an overview of changes since Gramps version 3.3. These changes are also detailed later in this manual. Users of Gramps version 3.3 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.4. These changes are also detailed later in this manual. Users of Gramps version 3.4 are encouraged to review this section to be sure to take advantage of these new features.
  
 
= Before you upgrade =  
 
= Before you upgrade =  
Line 12: Line 12:
  
 
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.3
+
# Start Gramps 3.4
 
# 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 {{man menu|Family Trees->Backup...}}.
 
# 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->Backup...}}.
Line 21: Line 21:
  
  
After properly safeguarding your data, proceed to install Gramps 4.0. Use your operating system's regular installation process to do this. It is also best to uninstall Gramps 3.3 before installing Gramps 4.0, or make sure you install Gramps 4.0 in a different location.
+
After properly safeguarding your data, proceed to install Gramps 4.0. Use your operating system's regular installation process to do this. It is also best to uninstall Gramps 3.4 before installing Gramps 4.0, or make sure you install Gramps 4.0 in a different location.
  
 
After you install Gramps 4.0, 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).
 
After you install Gramps 4.0, 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).
Line 29: Line 29:
 
= Visible changes to the core =
 
= Visible changes to the core =
  
Changes visible after the migration: interface, data.
+
The changes from Gramps 3.4 to Gramps 4.0 have been kept to a minimum as Gramps 4.0 is a technology upgrade release, not a user feature upgrade release. Family trees in 3.4 and 4.0 are the same, so (provided the same database software is used) a family tree can be opened in both versions without upgrade or downgrade needed.  
  
== Citations (formerly Source References) ==
+
Nevertheless, some changes are visible after the migration:
  
The principal changes are that:
+
== The Dashboard ==
* Citations can be shared; and,
+
The Gramplet view has been renamed Dashboard. This to avoid an overload of the word Gramplet, and to make it more clear to new users what can be expected in this view
* Citations can have media object attached to them.
+
  
It is possible to use Gramps version 4.0 in the same way as Gramps version 3.3, if you do not want or need to take advantage of the new features:
+
== New Look and Feel ==
* The Sources view looks almost the same as the old Sources view (but with the addition of a disclosure triangle for sources that have citations),
+
* The buttons for [[Gramps_4.0_Wiki_Manual_-_Entering_and_Editing_Data:_Detailed_-_part_2#Editing_information_about_events|adding sources]] to information like events are the same as before,
+
* The selector for choosing an existing source looks the same (although with the addition of disclosure triangles to allow a citation to be chosen),
+
* The new 'Citation' editor looks (and behaves) almost exactly the same as the old 'Source Reference Editor',
+
  
Only if a user particularly wants to share citations between objects do they need to be aware of the change. The change is also intended to be entirely compatible with GEDCOM.
+
Gramps now uses GTK 3 to create the interface, so you need to set a GTK theme with the GTK theme switcher that supports GTK 3. If Gramps looks ugly after installation, this is because you use an old GTK Theme. Try out some GTK 3 themes to see which one gives you a beautifull Gramps experience. See [http://gramps-project.org/2012/08/status-gtk-3-for-gramps-4-0/ status GTK 3 for Gramps 4.0].
  
See [[GEPS_023:_Storing_data_from_large_sources]] for an explanation of the rationale behind the new features.
+
== Data Model ==
 +
There are no changes to the data model. An .gramps xml file generated by Gramps 3.4 is identical to the one of Gramps 4.0
  
If you have an existing Gramps database which you are upgrading to Gramps 4.0, after the upgrade process, Gramps will suggest that you might like to merge citations that are the same and refer to the same source. Unless you have specifically recorded different information (for example different notes) on old Source References that are the same, you should probably use the {{man menu|Tools->Family Tree Processing->Merge Citations...}} tool.
+
==Navigator modes==
  
When you start using Gramps, if you want to share a citation, then you would click on the {{man button|Add an existing citation or source}} and in the {{man label|Select Source or Citation}} dialogue, you would select the appropriate source and then citation. Clicking {{man button|OK}} would take you to the {{man label|Citation}} editor, but you will probably just click {{man button|OK}}, because the citation and source are both shared.
+
[[Image:Viewing_mode_selection.png|left|thumb|300px|Category navigator mode]]
  
== Editors ==
+
[[Image:Drop-Down.png|right|thumb|300px|Drop-Down navigator mode]]
  
* The citation editor has changed very little from the former Source Reference Editor:
+
[[Image:Expander.png|left|thumb|300px|Expander navigator mode]]
  
[[File:SourceRef-to-CitationEditor.png|700px|center|thumb|Figure 1.1]]
+
If there is more than one navigator mode installed, you can choose the navigator mode with the drop down.
 +
The navigator modes are "Category", "Drop-Down" and "Expander".
  
As shown, the main change is that the Citation can have a Gallery of images, Data fields, and also has (back-)references because it is a separate primary object.
+
{{-}}
  
* Improvements on image selection feature.
+
==New wizards, help and bug report dialogs==
  
* New 'Default family relationship' option value (Preferences)
+
[[Image:ExportAssistantStart-40.png|left|thumb|300px|Export Assistant: Start screen]]
  
* Add some accelerator keys on toogle buttons without labels. See also [[#Accessibility]].
+
[[Image:ExportAssistantChoose-40.png|right|thumb|300px|Export Assistant: Choose the output format screen]]
  
== GEDCOM import ==
+
Exporter, Help and Bug report dialogs have been rewritten according to Gtk3 migration.
  
'''GEDCOM import error/warnings report'''. bug tracker: {{bug|5599}} - provide a report of GEDCOM errors and warnings after import to show the user what information has not been imported.
+
{{-}}
  
[[File:GEDCOM-import-report.png|500px|thumb|center|Fig 1.2 Import report]]
+
==Colors dialog==
  
The report (shown above) details most of the lines that were either ignored or could not be understood. The contents of the line (or lines where there are continuation lines) are also shown. In some cases, the lines may not be exactly what is contained in the input GEDCOM file, because the line is reconstructed following some processing.
+
[[File:EditPreferencesColors-40.png|right|thumb|350px|Color Preferences]]
  
In addition to this report, some improvements have been made to GEDCOM import to process more of the input file. Some data has been imported into Gramps data elements even when they are not exactly the same as the GEDCOM data elements. Because the format of GEDCOM, and the format that Gramps uses are different, there are inevitably some pieces of data that cannot be imported.
+
A new section on Preferences dialog, which let you set the colors used for boxes in the graphical views.
  
 
+
{{-}}
More details of the mapping from GEDCOM to Gramps are now provided.
+
See [[Gramps_4.0_Wiki_Manual_-_Manage_Family_Trees#GEDCOM_import|GEDCOM import]].
+
  
 
= Plugins changes =
 
= Plugins changes =
Line 83: Line 78:
 
Everything about the plugins: import/export, gramplets, views, reports, tools.
 
Everything about the plugins: import/export, gramplets, views, reports, tools.
  
== Import/Export ==
+
=== To Do Gramplets ===
  
* Citations support on file formats
+
[[Image:ToDoList-sidebar-gramplet-40.png|right|thumb|200px| To Do Gramplet]]
  
* Improvements on Gedcom file format support
+
Objects and the Dashboard now have a To Do gramplet, listing all the notes which have been indicated as with Note Type To Do. New ''To Do'' notes can be created directly from the gramplet. See [[Gramps_4.0_Wiki_Manual_-_Gramplets#To_Do_Gramplet|ToDo Gramplet]] for more details.
  
== Reports ==
+
{{-}}
  
* output file formats
+
== Views ==
  
Improvements : RTF, ODF, LaTeX, cairo (PDF, Print...)
+
* New columns on views (private records)
  
* support image sections on textual reports
+
=== Fan Charts ===
  
* Citation support and source review (NarrativeWeb report, etc ...)
 
  
* Paper options
+
[[Image:ChartsViewFanChart-40.png|left|thumb|300px| Fan Chart]]
 +
[[Image:ChartsViewDescendantFanChart-40.png|right|thumb|300px| Fan Chart]]
  
Consistency rules on paper values, orientation and file format (options set by user)
+
In the Charts category (Previously called the Ancestry category), you will see two new core Charts: Fan Chart and Descendant Fan. These are two Charts that give you a good overview of a family tree. The Fan charts shows the principal parents of every individual. The Descendant Fan shows you all children, all their families, and then so on to see the ''entire'' descendant tree.
  
=== Book ===
+
The Fan Charts are powerfull, use the {{man button|Configure}} button in the toolbar to investigate some posibilities:
 +
* colored filtering via filter sidebar
 +
* Gradient coloring to give extra information
 +
* Print to output (pdf, printer) from the toolbar
  
* Improvements
+
{{-}}
  
* Alphabetical Index and Table Of Contents (TOC) features on book report
+
== Tools ==
  
=== Detailed reports ===
+
New tool for refreshing given name's statistics according to gender.
  
* Improvements, bug fix, consistency on age calculation, etc ...
+
== Reports ==
  
=== NarrativeWeb ===
+
* More languages switcher into reports (draw, graph and textual reports), enhancements and consistency on this feature, in relation with new [[#Locales handling|locales handling]].
  
* Media gallery, thumbnails
+
===Book ===
  
* hyperlink menu for screen readers and braille writers
+
* More friendly way for accessing to book report via command line.
 +
* Improvements on OpenDocument and PDF file formats support
  
== Views ==
+
=== NarrativeWeb ===
  
The sources view has been enhanced with a new tree view (Fig 1.3) that also shows citations below the source, in addition to the existing flat view (Fig 1.4)
+
A huge restructuring happened for narrative website (these changes might also happen in a point update on 3.4). It should overall be much more stable
  
[[Image:Sources-citationtreeview.png|left|450px|thumb|Fig. 1.3 Sources (Citation Tree) view]]
+
= Under the hood changes =
[[Image:Sources-sourceview.png|right|450px|thumb|Fig. 1.4 Sources view]]
+
{{-}}
+
  
There is also a new Citations view (Fig 1.5).
+
Technical stuff
  
[[Image:Citations-citationlistview.png|center|450px|thumb|Fig. 1.5 Citation view]]
+
== Python 3 support ==
{{-}}
+
  
 +
Gramps supports Python 2.7+ and Python 3.2+ starting from 4.0. We advise to use python 3.2 if possible. To support both versions, some code now runs slower on python 2.x.
  
* Size adjustments on Main, Navigation, Bottom and Side bars
+
== Code reogranization ==
  
== Tools ==
+
Gramps now has completed the code reorganization, making the code structure of Gramps much more cleaner.
  
* A new tool for merging our citation records: MergeCitations.
+
== Python based install ==
  
* Review on some ''Repair Family Tree'' tools
+
Gramps has deprecated the use of autotools for installation, and now uses a python based installation. As a user you are advised to a package installer to install Gramps. Those installing from source code can do some now with the commands :
  
= Under the hood changes =
+
python setup.py build
 +
python setup.py install
  
Technical stuff (gui/gen).
+
See the INSTALL and README file for details. This means that once you installed gramps, you can use the code as a standard python module, eg:
  
== Accessibility ==
+
from gramps.gen.lib.date import Date
  
* Better ATK support
+
to use the date computations as used by Gramps.
  
* Improve consistency on Editors: [[Accessibility]].
+
== Locales handling ==
  
== Addons manager ==
+
See [[Internationalization]].
 
+
* Review, improvements
+
  
 
== Command Line Interface ==
 
== Command Line Interface ==
  
* Arguments/flags
+
See [[#Code reogranization|code reorganization]] and [[#Python based install|python based installation]].
 
+
Improvements, consistency, optional translation
+
 
+
== Gramps XML file format and database ==
+
 
+
* Citations support
+
* Gramps XML is now idempotent[http://en.wikipedia.org/wiki/Idempotence].  
+
* Exporter does not change records order any more, making it easier to look at differences between versions/revisions.
+
 
+
== User classes ==
+
  
Reports and tools have ''user'' classes.
+
* more translated typeout
These classes provide a means to interact with the user in an abstract way. These classes should be overridden by each respective user interface to provide the appropriate interaction (eg. dialogs for GTK, promts for CLI).
+
  
= Further info =
+
= Further information =
  
More informations.
+
More information.
  
 
== Roadmap ==
 
== Roadmap ==
  
* [[Roadmap]]: [http://www.gramps-project.org/bugs/roadmap_page.php?version_id=28 3.3.2], [http://www.gramps-project.org/bugs/roadmap_page.php?version_id=30 4.0.0], [http://www.gramps-project.org/bugs/roadmap_page.php?version_id=25 trunk]
+
* [[Roadmap]]: [http://www.gramps-project.org/bugs/roadmap_page.php?version_id=34 4.0.0], [http://www.gramps-project.org/bugs/roadmap_page.php?version_id=25 trunk]
  
 
== Changelog ==
 
== Changelog ==
  
* [http://www.gramps-project.org/bugs/changelog_page.php?version_id=30 4.0.0], [http://www.gramps-project.org/bugs/changelog_page.php?version_id=25 trunk]  
+
* [http://www.gramps-project.org/bugs/roadmap_page.php?version_id=34 roadmap 4.0.0], [http://www.gramps-project.org/bugs/changelog_page.php?version_id=34 changelog]  
  
  

Revision as of 05:13, 16 May 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: [http://www.gramps-project.org/...]), not via internal links.
Also, only use the known conventions


Previous Index Next


This section gives an overview of changes since Gramps version 3.4. These changes are also detailed later in this manual. Users of Gramps version 3.4 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 4.0 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.4
  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->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 4.0. Use your operating system's regular installation process to do this. It is also best to uninstall Gramps 3.4 before installing Gramps 4.0, or make sure you install Gramps 4.0 in a different location.

After you install Gramps 4.0, 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

The changes from Gramps 3.4 to Gramps 4.0 have been kept to a minimum as Gramps 4.0 is a technology upgrade release, not a user feature upgrade release. Family trees in 3.4 and 4.0 are the same, so (provided the same database software is used) a family tree can be opened in both versions without upgrade or downgrade needed.

Nevertheless, some changes are visible after the migration:

The Dashboard

The Gramplet view has been renamed Dashboard. This to avoid an overload of the word Gramplet, and to make it more clear to new users what can be expected in this view

New Look and Feel

Gramps now uses GTK 3 to create the interface, so you need to set a GTK theme with the GTK theme switcher that supports GTK 3. If Gramps looks ugly after installation, this is because you use an old GTK Theme. Try out some GTK 3 themes to see which one gives you a beautifull Gramps experience. See status GTK 3 for Gramps 4.0.

Data Model

There are no changes to the data model. An .gramps xml file generated by Gramps 3.4 is identical to the one of Gramps 4.0

Navigator modes

Category navigator mode
Drop-Down navigator mode
Expander navigator mode

If there is more than one navigator mode installed, you can choose the navigator mode with the drop down. The navigator modes are "Category", "Drop-Down" and "Expander".


New wizards, help and bug report dialogs

Export Assistant: Start screen
Export Assistant: Choose the output format screen

Exporter, Help and Bug report dialogs have been rewritten according to Gtk3 migration.


Colors dialog

Color Preferences

A new section on Preferences dialog, which let you set the colors used for boxes in the graphical views.


Plugins changes

Everything about the plugins: import/export, gramplets, views, reports, tools.

To Do Gramplets

To Do Gramplet

Objects and the Dashboard now have a To Do gramplet, listing all the notes which have been indicated as with Note Type To Do. New To Do notes can be created directly from the gramplet. See ToDo Gramplet for more details.


Views

  • New columns on views (private records)

Fan Charts

Fan Chart
Fan Chart

In the Charts category (Previously called the Ancestry category), you will see two new core Charts: Fan Chart and Descendant Fan. These are two Charts that give you a good overview of a family tree. The Fan charts shows the principal parents of every individual. The Descendant Fan shows you all children, all their families, and then so on to see the entire descendant tree.

The Fan Charts are powerfull, use the Configure button in the toolbar to investigate some posibilities:

  • colored filtering via filter sidebar
  • Gradient coloring to give extra information
  • Print to output (pdf, printer) from the toolbar


Tools

New tool for refreshing given name's statistics according to gender.

Reports

  • More languages switcher into reports (draw, graph and textual reports), enhancements and consistency on this feature, in relation with new locales handling.

Book

  • More friendly way for accessing to book report via command line.
  • Improvements on OpenDocument and PDF file formats support

NarrativeWeb

A huge restructuring happened for narrative website (these changes might also happen in a point update on 3.4). It should overall be much more stable

Under the hood changes

Technical stuff

Python 3 support

Gramps supports Python 2.7+ and Python 3.2+ starting from 4.0. We advise to use python 3.2 if possible. To support both versions, some code now runs slower on python 2.x.

Code reogranization

Gramps now has completed the code reorganization, making the code structure of Gramps much more cleaner.

Python based install

Gramps has deprecated the use of autotools for installation, and now uses a python based installation. As a user you are advised to a package installer to install Gramps. Those installing from source code can do some now with the commands :

python setup.py build
python setup.py install

See the INSTALL and README file for details. This means that once you installed gramps, you can use the code as a standard python module, eg:

from gramps.gen.lib.date import Date

to use the date computations as used by Gramps.

Locales handling

See Internationalization.

Command Line Interface

See code reorganization and python based installation.

  • more translated typeout

Further information

More information.

Roadmap

Changelog


Previous Index Next