Difference between revisions of "Addon:GEDCOM Extensions"

From Gramps
(update usage info)
m (→‎Usage)
 
(48 intermediate revisions by 7 users not shown)
Line 1: Line 1:
−
{{Third-party plugin}}
+
{{languages|Addon:GEDCOM Extensions}}
 +
{{Third-party addon}}
 +
[[File:GEDCOMExtensions-GED2-ChooseTheOutputFormat-tab-ExportAssistant-52.png|right|450px|"GEDCOM Extensions (GED2)" option selected in Export_Assistant]]
  
−
[[File:GEDCOM Extensions GED2 Export Assistant gramps.png|right|400px|"GEDCOM Extensions (GED2)" option selected in Export_Assistant (Gramps 4.1.3, Ubuntu 14.04.2)]]
+
This Addon has a collection of unofficial GEDCOM extensions which extend [https://github.com/gramps-project/gramps/blob/458989f47aed00ed33331c8760f8049266f3495a/gramps/plugins/export/exportgedcom.py#L202 Gramps GedcomWriter] to include common non-compliant GEDCOM additions.  
  
−
This Addon (available for Gramps 4.0 and higher) has a collection of unofficial GEDCOM extensions which extend Gramps GedcomWriter to include common non-compliant GEDCOM additions. If the feature you want is not listed below, then you can either add it yourself, or ask a developer to help you.
+
If the feature you want is not listed below, then you can either add it yourself, or ask a developer to help you.
 +
{{-}}
 +
== Export GEDCOM Extensions ==
  
−
The code is in the Addon [https://github.com/gramps-project/addons-source/blob/master/GedcomExtensions/GedcomExtensions.py addons-source/blob/master/GedcomExtensions/GedcomExtensions.py].
+
The following GEDCOM Extensions are supported:
 +
 
 +
* Include witnesses - Exports witnesses associated with a family event
 +
* [https://github.com/gramps-project/addons-source/commit/813292310739252458de8d7d136649b8603facf4 Include media]
 +
* [https://github.com/gramps-project/addons-source/pull/630 Patronymic names]
 +
 
 +
=== Installation ===
 +
To install the addon ensure "Expert" or "All Audiences" is selected in the Addon Manager.
 +
 
 +
=== Usage ===
  
−
= Export GEDCOM Extensions =
+
[[File:GEDCOMExtensions-GED2-ExportOptions-tab-ExportAssistant-defaults-60.png|right|450px|Defaults shown in Export Assistant's - Export options - tab]]
  
−
The following GEDCOM Extensions are supported:
+
To run the exporter, select {{man menu|Family Trees > Export..}}, press {{man button|Next}}, on the {{man label|Choose the output format}} dialog select {{man label|"GEDCOM Extensions (GED2)"}}, press {{man button|Next}}. On the {{man label|Export options}} dialog select the relevant GEDCOM extension option:
 +
* {{checkbox|0}} {{man label|Include witnesses}} - (unchecked by default) Exports witnesses associated with a family event
 +
* {{checkbox|0}} {{man label|Include media}} - (unchecked by default)
 +
* {{man label|Patronymic names:}}
 +
** '''Don't change''' - (default) - Don't change Gramps export
 +
** ''Add Patronymic name after Given name'' - Export Patronymic after given name, instead of adding it to the list of surnames
 +
** ''Ignore Patronymic name'' - Ignore Patronymic names on export
 +
* {{man label|Type of surname:}}
 +
** '''Don't change''' - (default) - Don't change Gramps export
 +
** select from the different options...
  
−
* Exports witnesses associated with a family event
 
  
−
== Usage ==
+
Then press {{man button|Next}}, and after selecting the save location and applying the export the data should be exported to a file with the extension ".ged2".
  
−
To run the exporter, select {{man menu|Family Trees > Export..}}, press {{man button|Next}}, select {{man label|"GEDCOM Extensions (GED2)"}}. Select the relevant options, and the data should be exported to a file with the extension ".ged2".
+
Afterwards, you can change the extension from ".ged2" to ".ged" and treat as a normal GEDCOM file.
  
−
{{man warn|Warning|There is no associated .ged2 importer in Gramps, so the {{man menu|export is one-way only (out of Gramps)}}. It should be possible for someone to also write an associated GEDCOM importer to handle the extensions to bring them into Gramps as well.}}
+
{{man warn|Warning: There is no associated .ged2 importer in Gramps, so the {{man menu|export is one-way only (out of Gramps)}}.|It should be possible for someone to also write an associated GEDCOM importer to handle the extensions to bring them into Gramps as well.}}
  
−
= Import GEDCOM Extensions =
+
== Import GEDCOM Extensions ==
  
 
There are no import extensions currently supported.
 
There are no import extensions currently supported.
  
−
= See also =
+
See feature request:
−
* {{bug|8094}} GedcomExtension to export family event secondary participant if role in CELEBRANT, INFORMANT, CLERGY, AIDE, CUSTOM
+
* {{bug|10550}} '''Refactor Gramps GEDCOM import so as to support GEDCOM extension addons'''
−
* {{bug|8093}} Wrong level for witnesses in GedcomExtension, and export
 
  
−
== Others projects ==
+
{{man note|Available for Gramps 4.x and higher.}}
  
−
* [https://github.com/DallanQ/Gedcom GEDCOM (WeRelate.org)] is a project for parsing objects ignored by a model. It includes classes and attributes for every GEDCOM tag sequence appearing in more than 4% of the 7000 GEDCOMs submitted to WeRelate.org over the past five years, with the exception of four software-specific schema tags: SCHEMA, _EVENT_DEFN, _PLAC_DEFN, and _EVDEF, generated by Family Tree Maker, Personal Ancestral File, Legacy, and RootsMagic respectively.  
+
== See also ==
 +
* The source code is available from [https://github.com/gramps-project/addons-source/blob/master/GedcomExtensions/GedcomExtensions.py addons-source/blob/master/GedcomExtensions/GedcomExtensions.py].
  
−
See the demo[https://github.com/DallanQ/Gedcom/wiki/Demo]. ''GEDCOM -> model -> json -> model -> GEDCOM'' round-trip shows the GEDCOM tags that are represented in the model as extensions, and tags that cannot be represented.
+
* [[GEDCOM]]
−
 
 
−
** differences between the object model and the GEDCOM 5.5 Specification.[https://github.com/DallanQ/Gedcom/wiki/Specification-differences]
 
−
** set of UML diagrams illustrating the core GEDCOM class and each of the top-level objects.[https://github.com/DallanQ/Gedcom/wiki/UML-Diagrams]
 
  
 +
[[Category:Addons]]
 +
[[Category:Plugins]]
 
[[Category:Developers/General]]
 
[[Category:Developers/General]]
−
[[Category:Documentation]]
 
−
[[Category:Plugins]]
 

Latest revision as of 09:16, 17 May 2026

Gramps-config-language.png Languages: 

English  • עברית

Gramps-notes.png
This is a Third-party Addon. The Addon/Plugin system is controlled by the Plugin Manager.

Please use carefully on data that is backed up, and help make it better by reporting any issues to the bug tracker.
Unless otherwise stated on this page, you can download this addon by following these instructions.
Please note that some Addons have prerequisites that need to be installed before they can be used.

"GEDCOM Extensions (GED2)" option selected in Export_Assistant

This Addon has a collection of unofficial GEDCOM extensions which extend Gramps GedcomWriter to include common non-compliant GEDCOM additions.

If the feature you want is not listed below, then you can either add it yourself, or ask a developer to help you.

Export GEDCOM Extensions

The following GEDCOM Extensions are supported:

Installation

To install the addon ensure "Expert" or "All Audiences" is selected in the Addon Manager.

Usage

Defaults shown in Export Assistant's - Export options - tab

To run the exporter, select Family Trees > Export.., press Next, on the Choose the output format dialog select "GEDCOM Extensions (GED2)", press Next. On the Export options dialog select the relevant GEDCOM extension option:

  • Include witnesses - (unchecked by default) Exports witnesses associated with a family event
  • Include media - (unchecked by default)
  • Patronymic names:
    • Don't change - (default) - Don't change Gramps export
    • Add Patronymic name after Given name - Export Patronymic after given name, instead of adding it to the list of surnames
    • Ignore Patronymic name - Ignore Patronymic names on export
  • Type of surname:
    • Don't change - (default) - Don't change Gramps export
    • select from the different options...


Then press Next, and after selecting the save location and applying the export the data should be exported to a file with the extension ".ged2".

Afterwards, you can change the extension from ".ged2" to ".ged" and treat as a normal GEDCOM file.

Gnome-important.png
Warning: There is no associated .ged2 importer in Gramps, so the export is one-way only (out of Gramps).

It should be possible for someone to also write an associated GEDCOM importer to handle the extensions to bring them into Gramps as well.

Import GEDCOM Extensions

There are no import extensions currently supported.

See feature request:

  • 10550 Refactor Gramps GEDCOM import so as to support GEDCOM extension addons
Gramps-notes.png
Available for Gramps 4.x and higher.

See also

Retrieved from "https://blog.gramps-project.org/wiki/index.php?title=Addon:GEDCOM_Extensions&oldid=131236"