16,602
edits
Changes
m
→Gramps XML Resources
==Gramps XML Resources==
{{man note|Starting with Gramps XML 1.0, each |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 [http://www.gramps-project.org/xml/ http://www.gramps-project.org/xml/].}}
{| class="wikitable sortable"
!Gramps release
!XML version schema!Imports XML versionschema
!Database
!Example
!Changes/Note
|-
| trunk/master/unstable| no change against 4.1 2 yet| >= 1.0.0 - best 1.5.17| 1719
| Unreleased <br />[{{Code Browser}}/tree/master/example/gramps/example.gramps example.gramps]
| Unreleased
|}
{{man note|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 xmlXML.[http://sourceforge.net/mailarchivep/gramps/mailman/message.php?msg_id=/23262334/] <br /><br />'''Note: ''' For versions of Gramps earlier than 3.1.1 refer to and the consult the table below to decide which version to use to import a specific version of the xml, consult the table belowXML.}}
{| 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
| 19
|[{{Code Browser}}/tree/maintenance/gramps50/example/gramps/example.gramps]
|
* Database backends become plugins
* BSDDB is default, convert default handle (metadata) to str
* DB-API (SQLite) is tested as viable replacement
|-
| 4.2.x
| 1.7.0 - 1.7.1
| >= 1.0.0 - 1.7
| 18
|[{{Code Browser}}/tree/maintenance/gramps42/example/gramps/example.gramps]
|
* Added PlaceNames (with Date and Language) Place
|-
| 4.1.x
| >= 1.0.0 - best 1.5.1
| 17
|[{{Code Browser}}/tree/maintenance/gramps41/~/tree/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]
|[http:/* Added new field "locality" to the Place schema* Added surnames to the Name schema (surnames is a list of surnames /www.gramps-project.orgprefix and patronymic are moved to the surname)* Replaced Markers with Tags ( marker removed from all /wikitags added to Person, Media, Family, and Notes)* Transaction* Merging* Improvements on Import/index.php?title=Export file formats (vcard, gedcom, xml)* [[Gramps_3.3_Wiki_Manual_-_What%27s_new%3F#Database Changes]]
|-
|3.1.x
|[{{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
|}
{{man note|Note: |To convert an old Gramps XML file you could use VirtualBox or Vmware and the old lgenealogy images from: <br><code>http://ftp.gwdg.de/pub/linux/gramps/</code>}}
===DTD generation===
===RELAX NG generation===
Tools like [http://code.google.com/p/jing-trang/ trang] or [http://people.apache.org/~andyc/neko/doc/dtd/index.html NekoDTD] could help to convert a Gramps DTD file to a RELAX NG file.
Some others tools and up-to-date informations (''2010-09-19'') are listed on this [http://www.relaxng.org/ page].
==Validating Gramps XML file==
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 http://bugs.gramps-project.org in that case.'''}}
==Parsing Gramps XML file==
* [[Database_Formats]]
* [[Gramps Old database]]
* [[Previous releases of Gramps]]
[[Category:Developers/Reference]]
[[Category:Developers/General]]
