4,602
edits
Changes
m
→See also
{{languages|Gramps XML}}
'''Gramps XML''' is the '''Extensible Markup Language ''' ([http://en.wikipedia.org/wiki/XML 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.
{| class="wikitable sortable"
!Gramps release
!XML version schema!Imports XML versionschema
!Database
!Example
| no change against 4.2 yet
| >= 1.0.0 - best 1.7
| 1819
| Unreleased <br />[{{Code Browser}}/tree/master/example/gramps/example.gramps example.gramps]
| Unreleased
{| class="wikitable sortable"
!Gramps release
!XML version schema!Imports XML versionschema
!Database
!Example
!Changes/Note
|-
| 5.1.x
| 1.7.0 - 1.7.1
| >= 1.0.0 - 1.7
| 19
|[{{Code Browser}}/tree/maintenance/gramps51/example/gramps/example.gramps]
|
* DB-API (SQLite) is default backend
* BSDDB is Legacy backend
|-
| 5.0.x
| 1.7.0 - 1.7.1
| >= 1.0.0 - 1.7
| 1819
|[{{Code Browser}}/tree/maintenance/gramps50/example/gramps/example.gramps]
|
* Database backends become plugins
* BSDDB is default, convert default handle (metadata) to str* DB-API (SQLSQLite) is tested as viable replacement<br />
|-
| 4.2.x
| 18
|[{{Code Browser}}/tree/maintenance/gramps42/example/gramps/example.gramps]
|added * Added PlaceNames (with Date and Language) Place<br />
|-
| 4.1.x
| 17
|[{{Code Browser}}/tree/maintenance/gramps41/example/gramps/example.gramps]
|* added Tags to Event, Place, Repository, Source, and Citation<br />* Source/Citation.data became SourceAttributes<br />* added optional support for checksum on Media object<br />* added PlaceRef and Place Hierarchies<br />
|-
|4.0.x
|16
|[{{Code Browser}}/tree/maintenance/gramps34/example/gramps/example.gramps]
|* Citations support<br />* Gramps XML is now idempotent[http://en.wikipedia.org/wiki/Idempotence].{{bug|4365}}<br />* Exporter does not change records order any more, making it easier to look at differences between versions/revisions.
|-
|3.3.x
|15
|[{{Code Browser}}/tree/maintenance/gramps33/example/gramps/example.gramps]
|* Added new field "locality" to the Place schema<br />* Added surnames to the Name schema (surnames is a list of surnames / prefix and patronymic are moved to the surname)<br />* Replaced Markers with Tags ( marker removed from all / tags added to Person, Media, Family, and Notes)<br />* Transaction<br />* Merging<br />* Improvements on Import/Export file formats (vcard, gedcom, xml)<br />* [[Gramps_3.3_Wiki_Manual_-_What%27s_new%3F#Database Changes]]
|-
|3.1.x
|15
|[{{Code Browser}}/tree/maintenance/gramps31/example/gramps/example.gramps]
| * Added lat/long to places
|-
|3.0.x
|14
|[{{Code Browser}}/tree/maintenance/gramps30/example/gramps/example.gramps]
| * added newyear to Dates<br />* Replace plain text with StyledText in Notes
|-
|2.2.x
|1.1.0-1.1.4
| >= 0.0.0
|13
|[{{Code Browser}}/tree/maintenance/gramps22/example/gramps/data.gramps]
|
|13
|[{{Code Browser}}/tree/maintenance/gramps20/gramps2/example/gramps/data.gramps]
| * changed name formats
|-
|1.0.x
|
|[{{Code Browser}}/tree/maintenance/gramps10/example/gramps/data.gramps]
|(Install [https://github.com/gramps-project/gramps/releases/tag/v2.2.10 Gramps 2.2.10] to import and convert old beta Gramps XML backups - see [[Gramps_Old_database]] & issue {{bug|6129}})
|-
|0.0.x
==Parsing Gramps XML file==
* [[Xsl|XSLT]] scripts: [http://www.gramps-project.org/grampsExhibit/0.0.2/grampsexhibit.xsl gramps exhibit] (Michiel Nauta), [[media:Ancestors.xsl.gz|Ancestors.xsl]], [[media:Birthday.xsl.gz|Birthday.xsl]] (Gramps 1.x), [[media:Tellico.tar.gz|Tellico scripts]], [[Lxml_GrampletAddon:Lxml Gramplet|lxml gramplet]], [http://sourceforge.net/mailarchive/message.php?msg_id=28108782 Print Notes], etc ... see [[media:Xpaths.gz|XPaths]].
* A [http://svn.code.sf.net/p/gramps-addons/code/trunk/contrib/DescendantsLines/ft.py sample of standalone script] (Adam Sampson) which parses a Gramps XML file for drawing a family tree.
* [[Other_genealogy_tools#Gramps-php-exporter|Gramps-php-exporter]]
* A [http://sourceforge.net/projects/joomlagen/ Joomla! component/module] for uploading the Gramps XML database and for showing genealogical information and overviews.
* [http://www.phpgedview.net PhpGedView] supports [http://phpgedview.svn.sourceforge.net/viewvc/phpgedview/trunk/phpGedView/includes/classes/class_grampsexport.php 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 [http://sourceforge.net/projects/phpgedview/forums/forum/185166/topic/5177979 partial support on version 4.3.0].
* [http://en.wikipedia.org/wiki/Greasemonkey Greasemonkey] scripts (Michiel Nauta)* 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/ GrampsXMLview2012 www.gramps.van-staveren.net Internet Archive] is a number of PHP scripts in combination with a Gramps XML database.
* [https://github.com/claws/gramps2gource gramps2gource] for blurring the line between Genealogy and Software Configuration Management visualisation.
* ...
==See also==
* [https://gramps.discourse.group/t/auxiliary-xml-format-documentation/2800 Auxiliary XML files in Gramps]:
** filters: custom_filters.xml
** report settings: report_options.xml
** Books: books.xml
** holiday sets or country calendars: [[Calendar_tools_holidays#format_of_holidays.xml|holidays.xml]]
* [[Generate XML]]
* Tutorial: [[Customize_reports_with_XML_tool|Customize reports with XML tool]]
* [[GEDCOM]]
* [[Gramps and GEDCOM]]
