Difference between revisions of "Gramps XML"
m (→See also: add other Gramps XML files cross-references) |
(→See also) |
||
(18 intermediate revisions by 4 users not shown) | |||
Line 5: | Line 5: | ||
==Gramps XML Resources== | ==Gramps XML Resources== | ||
− | {{man note|Starting with Gramps XML 1.0|Each revision of Gramps XML has its own resource page, with references to that version's [https://en.wikipedia.org/wiki/Document_type_definition DTD] and [https://en.wikipedia.org/wiki/RELAX_NG RELAX NG] schema.<br />The resource pages are listed at [ | + | {{man note|Starting with Gramps XML 1.0|Each revision of Gramps XML has its own resource page, with references to that version's [https://en.wikipedia.org/wiki/Document_type_definition DTD] and [https://en.wikipedia.org/wiki/RELAX_NG RELAX NG] schema.<br />The resource pages are listed at [https://www.gramps-project.org/xml/ https://www.gramps-project.org/xml/].}} |
{| class="wikitable sortable" | {| class="wikitable sortable" | ||
Line 11: | Line 11: | ||
!XML schema | !XML schema | ||
!Imports XML schema | !Imports XML schema | ||
− | !Database | + | !Database schema |
+ | !Imports database schema | ||
!Example | !Example | ||
!Changes/Note | !Changes/Note | ||
|- | |- | ||
| master | | master | ||
− | | no change against | + | | no change against 5.2 yet |
| >= 1.0.0 - best 1.7 | | >= 1.0.0 - best 1.7 | ||
− | | | + | | 20 |
+ | | 13-20 | ||
| Unreleased <br />[{{Code Browser}}/tree/master/example/gramps/example.gramps example.gramps] | | Unreleased <br />[{{Code Browser}}/tree/master/example/gramps/example.gramps example.gramps] | ||
| Unreleased | | Unreleased | ||
Line 29: | Line 31: | ||
!XML schema | !XML schema | ||
!Imports XML schema | !Imports XML schema | ||
− | !Database | + | !Database schema |
+ | !Imports database schema | ||
!Example | !Example | ||
!Changes/Note | !Changes/Note | ||
+ | |- | ||
+ | | 5.2.x | ||
+ | | 1.7.0 - 1.7.1 | ||
+ | | >= 1.0.0 - 1.7 | ||
+ | | 20 | ||
+ | | 13-20 | ||
+ | |[{{Code Browser}}/tree/maintenance/gramps52/example/gramps/example.gramps] | ||
+ | | | ||
+ | * DB-API (SQLite) is default backend | ||
+ | * BSDDB only for conversions to SQLite | ||
|- | |- | ||
| 5.1.x | | 5.1.x | ||
Line 37: | Line 50: | ||
| >= 1.0.0 - 1.7 | | >= 1.0.0 - 1.7 | ||
| 19 | | 19 | ||
+ | | 13-19 | ||
|[{{Code Browser}}/tree/maintenance/gramps51/example/gramps/example.gramps] | |[{{Code Browser}}/tree/maintenance/gramps51/example/gramps/example.gramps] | ||
| | | | ||
Line 46: | Line 60: | ||
| >= 1.0.0 - 1.7 | | >= 1.0.0 - 1.7 | ||
| 19 | | 19 | ||
+ | | 13-19 | ||
|[{{Code Browser}}/tree/maintenance/gramps50/example/gramps/example.gramps] | |[{{Code Browser}}/tree/maintenance/gramps50/example/gramps/example.gramps] | ||
| | | | ||
Line 56: | Line 71: | ||
| >= 1.0.0 - 1.7 | | >= 1.0.0 - 1.7 | ||
| 18 | | 18 | ||
+ | | 13-18 | ||
|[{{Code Browser}}/tree/maintenance/gramps42/example/gramps/example.gramps] | |[{{Code Browser}}/tree/maintenance/gramps42/example/gramps/example.gramps] | ||
| | | | ||
Line 64: | Line 80: | ||
| >= 1.0.0 - best 1.5.1 | | >= 1.0.0 - best 1.5.1 | ||
| 17 | | 17 | ||
+ | | 13-17 | ||
|[{{Code Browser}}/tree/maintenance/gramps41/example/gramps/example.gramps] | |[{{Code Browser}}/tree/maintenance/gramps41/example/gramps/example.gramps] | ||
| | | | ||
Line 75: | Line 92: | ||
| >= 1.0.0 - best 1.4.0 | | >= 1.0.0 - best 1.4.0 | ||
|16 | |16 | ||
+ | |13-16 | ||
|[{{Code Browser}}/tree/maintenance/gramps40/example/gramps/example.gramps] | |[{{Code Browser}}/tree/maintenance/gramps40/example/gramps/example.gramps] | ||
| - | | - | ||
Line 82: | Line 100: | ||
| >= 1.0.0 - best 1.4.0 | | >= 1.0.0 - best 1.4.0 | ||
|16 | |16 | ||
+ | |13-16 | ||
|[{{Code Browser}}/tree/maintenance/gramps34/example/gramps/example.gramps] | |[{{Code Browser}}/tree/maintenance/gramps34/example/gramps/example.gramps] | ||
| | | | ||
Line 92: | Line 111: | ||
| >= 1.0.0 - best 1.3.0 | | >= 1.0.0 - best 1.3.0 | ||
|15 | |15 | ||
+ | |13-15 (3.3.1) | ||
|[{{Code Browser}}/tree/maintenance/gramps33/example/gramps/example.gramps] | |[{{Code Browser}}/tree/maintenance/gramps33/example/gramps/example.gramps] | ||
| | | | ||
Line 105: | Line 125: | ||
|1.3.0 | |1.3.0 | ||
| >= 1.0.0 - best 1.1.0 | | >= 1.0.0 - best 1.1.0 | ||
− | | | + | |14 |
+ | |13-14 | ||
|[{{Code Browser}}/tree/maintenance/gramps31/example/gramps/example.gramps] | |[{{Code Browser}}/tree/maintenance/gramps31/example/gramps/example.gramps] | ||
| | | | ||
Line 113: | Line 134: | ||
|1.2.0 | |1.2.0 | ||
| >= 1.1.0 | | >= 1.1.0 | ||
− | |14 | + | |13-14 (depends on version) |
+ | | [https://gramps.discourse.group/t/import-convert-old-database/3768/ 9-14 (3.0.4)] | ||
|[{{Code Browser}}/tree/maintenance/gramps30/example/gramps/example.gramps] | |[{{Code Browser}}/tree/maintenance/gramps30/example/gramps/example.gramps] | ||
| | | | ||
Line 122: | Line 144: | ||
|1.1.0-1.1.4 | |1.1.0-1.1.4 | ||
| >= 0.0.0 | | >= 0.0.0 | ||
− | | | + | |9-12 (depends on version) |
+ | |5-12 (2.2.10) | ||
+ | |[{{Code Browser}}/tree/maintenance/gramps22/example/gramps/data.gramps] | ||
+ | | | ||
+ | |- | ||
+ | | 2.0.6-10 | ||
+ | | 1.0.0 | ||
+ | | >= 0.0.0 | ||
+ | | 8 | ||
+ | | 1-8 | ||
+ | |[{{Code Browser}}/tree/maintenance/gramps22/example/gramps/data.gramps] | ||
+ | | | ||
+ | |- | ||
+ | | 2.0.5 | ||
+ | | 1.0.0 | ||
+ | | >= 0.0.0 | ||
+ | | 7 | ||
+ | | 1-7 | ||
+ | |[{{Code Browser}}/tree/maintenance/gramps22/example/gramps/data.gramps] | ||
+ | | | ||
+ | |- | ||
+ | | 2.0.1-4 | ||
+ | | 1.0.0 | ||
+ | | >= 0.0.0 | ||
+ | | 6 | ||
+ | | 1-6 | ||
|[{{Code Browser}}/tree/maintenance/gramps22/example/gramps/data.gramps] | |[{{Code Browser}}/tree/maintenance/gramps22/example/gramps/data.gramps] | ||
| | | | ||
|- | |- | ||
− | |2.0. | + | | 2.0.0 |
− | |1.0.0 | + | | 1.0.0 |
| >= 0.0.0 | | >= 0.0.0 | ||
− | | | + | | 5 |
+ | | 1-5 | ||
|[{{Code Browser}}/tree/maintenance/gramps20/gramps2/example/gramps/data.gramps] | |[{{Code Browser}}/tree/maintenance/gramps20/gramps2/example/gramps/data.gramps] | ||
− | | | + | | * changed name formats |
− | * changed name formats | ||
|- | |- | ||
|1.0.x | |1.0.x | ||
|no official version (0.0.0) | |no official version (0.0.0) | ||
| - | | - | ||
+ | | | ||
| | | | ||
|[{{Code Browser}}/tree/maintenance/gramps10/example/gramps/data.gramps] | |[{{Code Browser}}/tree/maintenance/gramps10/example/gramps/data.gramps] | ||
Line 145: | Line 193: | ||
| Unsupported | | Unsupported | ||
| Unsupported | | Unsupported | ||
+ | | | ||
| Unsupported | | Unsupported | ||
| | | | ||
Line 163: | Line 212: | ||
xmllint --noout filename.gramps | xmllint --noout filename.gramps | ||
− | {{man warn|If the Gramps XML file does not validate|this indicates an error in either the DTD or the XML Writer.<br>'''Please file the bug report at | + | {{man warn|If the Gramps XML file does not validate|this indicates an error in either the DTD or the XML Writer.<br>'''Please file the bug report at https://gramps-project.org/bugs/ in that case.'''}} |
==Parsing Gramps XML file== | ==Parsing Gramps XML file== | ||
Line 175: | Line 224: | ||
* GrampsXMLview was a number of PHP scripts in combination with a Gramps XML database (Sjoerd van Staveren). [https://web.archive.org/web/20120220103003/http://www.gramps.van-staveren.net/ 2012 www.gramps.van-staveren.net Internet Archive] | * GrampsXMLview was a number of PHP scripts in combination with a Gramps XML database (Sjoerd van Staveren). [https://web.archive.org/web/20120220103003/http://www.gramps.van-staveren.net/ 2012 www.gramps.van-staveren.net Internet Archive] | ||
* [https://github.com/claws/gramps2gource gramps2gource] for blurring the line between Genealogy and Software Configuration Management visualisation. | * [https://github.com/claws/gramps2gource gramps2gource] for blurring the line between Genealogy and Software Configuration Management visualisation. | ||
− | * ... | + | * [https://betty.readthedocs.io/latest/index.html Betty] generates a ready-to-publish static website from Gramps XML genealogy archives |
==See also== | ==See also== | ||
* [https://gramps.discourse.group/t/auxiliary-xml-format-documentation/2800 Auxiliary XML files in Gramps]: | * [https://gramps.discourse.group/t/auxiliary-xml-format-documentation/2800 Auxiliary XML files in Gramps]: | ||
− | + | :.gramps/: | |
− | * | + | :* report_options.xml - report settings: |
− | * | + | :* books.xml - Books |
− | * | + | :* tool_options.xml |
+ | :* [[Calendar_tools_holidays#format_of_holidays.xml|holidays.xml]] - holiday sets or country calendars | ||
+ | :* recent-files-gramps.xml - | ||
+ | :* fan_chart.xml | ||
+ | :* place_formats.xml | ||
+ | :.gramps//gramps52/ | ||
+ | :* custom_filters.xml - filters | ||
* [[Generate XML]] | * [[Generate XML]] | ||
+ | * Tutorial: [[Customize_reports_with_XML_tool|Customize reports with XML tool]] | ||
* [[GEDCOM]] | * [[GEDCOM]] | ||
* [[Gramps and GEDCOM]] | * [[Gramps and GEDCOM]] | ||
* [[Database_Formats]] | * [[Database_Formats]] | ||
+ | * wiki "Just Solve the File Format Problem" - [http://fileformats.archiveteam.org/wiki/Genealogical_data Genealogical data] file formats | ||
* [[Gramps Old database]] | * [[Gramps Old database]] | ||
* [[Previous releases of Gramps]] | * [[Previous releases of Gramps]] |
Latest revision as of 04:14, 13 March 2024
Gramps XML is the Extensible Markup Language (XML) format designed for storing Gramps data. The goal is to have a fully portable, human- and machine-readable XML format so that the data can be read and written without any loss. In addition, XML format allows for smaller files (if compressed) and for using the version control system for tracking the changes (if uncompressed).
The reason XML is not used by Gramps as the working database ("internal") format is performance, specifically memory considerations.
Contents
Gramps XML Resources
Starting with Gramps XML 1.0 Each revision of Gramps XML has its own resource page, with references to that version's DTD and RELAX NG schema. |
Gramps release | XML schema | Imports XML schema | Database schema | Imports database schema | Example | Changes/Note |
---|---|---|---|---|---|---|
master | no change against 5.2 yet | >= 1.0.0 - best 1.7 | 20 | 13-20 | Unreleased example.gramps |
Unreleased |
Note Commencing with Gramps 3.1.2 all official versions of Gramps XML files can be imported. However, a warning will be given on import of 1.0.0 XML.[1] |
Gramps release | XML schema | Imports XML schema | Database schema | Imports database schema | Example | Changes/Note |
---|---|---|---|---|---|---|
5.2.x | 1.7.0 - 1.7.1 | >= 1.0.0 - 1.7 | 20 | 13-20 | [2] |
|
5.1.x | 1.7.0 - 1.7.1 | >= 1.0.0 - 1.7 | 19 | 13-19 | [3] |
|
5.0.x | 1.7.0 - 1.7.1 | >= 1.0.0 - 1.7 | 19 | 13-19 | [4] |
|
4.2.x | 1.7.0 - 1.7.1 | >= 1.0.0 - 1.7 | 18 | 13-18 | [5] |
|
4.1.x | 1.6.0 | >= 1.0.0 - best 1.5.1 | 17 | 13-17 | [6] |
|
4.0.x | 1.5.0 - 1.5.1 | >= 1.0.0 - best 1.4.0 | 16 | 13-16 | [7] | - |
3.4.x | 1.5.0 - 1.5.1 | >= 1.0.0 - best 1.4.0 | 16 | 13-16 | [8] | |
3.3.x | 1.4.0 | >= 1.0.0 - best 1.3.0 | 15 | 13-15 (3.3.1) | [10] |
|
3.1.x | 1.3.0 | >= 1.0.0 - best 1.1.0 | 14 | 13-14 | [11] |
|
3.0.x | 1.2.0 | >= 1.1.0 | 13-14 (depends on version) | 9-14 (3.0.4) | [12] |
|
2.2.x | 1.1.0-1.1.4 | >= 0.0.0 | 9-12 (depends on version) | 5-12 (2.2.10) | [13] | |
2.0.6-10 | 1.0.0 | >= 0.0.0 | 8 | 1-8 | [14] | |
2.0.5 | 1.0.0 | >= 0.0.0 | 7 | 1-7 | [15] | |
2.0.1-4 | 1.0.0 | >= 0.0.0 | 6 | 1-6 | [16] | |
2.0.0 | 1.0.0 | >= 0.0.0 | 5 | 1-5 | [17] | * changed name formats |
1.0.x | no official version (0.0.0) | - | [18] | (Install Gramps 2.2.10 to import and convert old beta Gramps XML backups - see Gramps_Old_database & issue 6129) | ||
0.0.x | beta software (0.0.0) | Unsupported | Unsupported | Unsupported |
Note: To convert an old Gramps XML file you could use VirtualBox or Vmware and the old lgenealogy images from: |
DTD generation
Tool like xml2dtd could help people not familiar with DTD grammar by generating a DTD file from a XML file. New content on Gramps XML could be tested with the tool and be merged on current Gramps DTD.
RELAX NG generation
Tools like trang or NekoDTD could help to convert a Gramps DTD file to a RELAX NG file. Some others tools and up-to-date informations are listed on this page.
Validating Gramps XML file
To validate the Gramps XML file against its DTD, use xmllint program (comes with the libxml2-utils package):
xmllint --noout filename.gramps
If the Gramps XML file does not validate this indicates an error in either the DTD or the XML Writer. |
Parsing Gramps XML file
- XSLT scripts: gramps exhibit (Michiel Nauta), Ancestors.xsl, Birthday.xsl (Gramps 1.x), Tellico scripts, lxml gramplet, Print Notes, etc ... see XPaths.
- A sample of standalone script (Adam Sampson) which parses a Gramps XML file for drawing a family tree.
- Gramps-php-exporter
- A Joomla! component/module for uploading the Gramps XML database and for showing genealogical information and overviews.
- PhpGedView supports simple output to Gramps XML file format for the Clippings Cart and has an option to download entire Gedcom in Gramps XML form as well as being able to retrieve raw data from the SOAP web service in Gramps XML format. Still a partial support on version 4.3.0.
- Greasemonkey scripts (Michiel Nauta)
- GrampsXMLview was a number of PHP scripts in combination with a Gramps XML database (Sjoerd van Staveren). 2012 www.gramps.van-staveren.net Internet Archive
- gramps2gource for blurring the line between Genealogy and Software Configuration Management visualisation.
- Betty generates a ready-to-publish static website from Gramps XML genealogy archives
See also
- .gramps/:
- report_options.xml - report settings:
- books.xml - Books
- tool_options.xml
- holidays.xml - holiday sets or country calendars
- recent-files-gramps.xml -
- fan_chart.xml
- place_formats.xml
- .gramps//gramps52/
- custom_filters.xml - filters
- Generate XML
- Tutorial: Customize reports with XML tool
- GEDCOM
- Gramps and GEDCOM
- Database_Formats
- wiki "Just Solve the File Format Problem" - Genealogical data file formats
- Gramps Old database
- Previous releases of Gramps