Changes

== Citations (formerly Source References) ==

The principal changes are that:* Storing data from large sources.Citations can be shared; and,See [[GEPS_023:_Storing_data_from_large_sources]]* Citations can have media object attached to them.

* 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. See [[GEPS_023:_Storing_data_from_large_sources]] for an explanation of the rationale behind the new features. If you have an existing Gramps database which you are upgrading to Gramps 3.4, 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 support ...}} tool. 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 sharing feature make in the {{man label|Select Source or Citation}} dialogue, you would select the appropriate source and then citation edition consistent. 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. == Editors == * The citation editor has changed very little from the former Source Reference Editor: [[File: adding citation now needs less dialogsSourceRef-to-CitationEditor.png|700px|center|thumb|Figure 1.1]] 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.

* New 'Default family relationship' option value (Preferences) * Add some accelerator keys on toogle buttons without labels. See also [[#Accessibility]]. == Gedcom data GEDCOM import == '''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]] 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. 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. 

More details and improvements on Gedcom file format importationof the mapping from GEDCOM to Gramps are now provided.See [[Gramps_3.4_Wiki_Manual_-_Manage_Family_Trees#GEDCOM_import|GEDCOM import]].

* Imporvements Improvements on Gedcom file format support

Improvements : RTF, ODTODF, LaTeX, cairo (PDF, Print...) * support image sections on textual reports

* Citation support image sectionsand source review (NarrativeWeb report, etc ...)

* index and TOC features on book reportPaper options

Consistency rules on paper values, orientation and file format (options set by user) === Book === * Improvements * Citation support Alphabetical Index and source review Table Of Contents (NarrativeWeb TOC) features on book report === Detailed reports === * Improvements, bug fix, consistency on age calculation, etc ...) === NarrativeWeb === * Media gallery, thumbnails * hyperlink menu for screen readers and braille writers

* New citation category 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) [[Image:Sources-citationtreeview.png|left|450px|thumb|Fig. 1.3 Sources (Citation Tree) view]][[Image:Sources-sourceview.png|right|450px|thumb|Fig. 1.4 Sources view]]{{-}}

* Add of There is also a citation tree new Citations view into the Source category (like PersonsFig 1.5). [[Image:Citations-citationlistview.png|center|450px|thumb|Fig. 1.5 Citation view]]{{-}}  * Size adjustments on Main, Places categories)Navigation, Bottom and Side bars

* A new tool for merging our citation records: MergeCitations. * Review on some ''Repair Family Tree'' tools

== Accessibility == * Better ATK support * Improve consistency on Editors: [[Accessibility]]. == Addons manager == * Review, improvements == Command Line Interface == * Arguments/flags Improvements, consistency, optional translation == Gramps XML file format and database ==

* Gramps XML is now idempotent[http://en.wikipedia.org/wiki/Idempotence]. * Exporter do does not change records orderany more, making it easier to look at differences between versions/revisions.

Reports and tools have now ''user'' classes.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).