Difference between revisions of "Gramps XML"

From Gramps
Jump to: navigation, search
m (Parsing Gramps XML file)
m (GRAMPS XML Resources)
Line 4: Line 4:
 
The reason XML is not used by GRAMPS as the primary format is performance, specifically memory considerations.
 
The reason XML is not used by GRAMPS as the primary format is performance, specifically memory considerations.
  
==GRAMPS XML Resources==
+
==Gramps XML Resources==
 
Starting with XML 1.0, each revision of XML has its own resource page, with references to that version's DTD and RELAX NG schema. The resource pages are listed at [http://www.gramps-project.org/xml/ http://www.gramps-project.org/xml/].
 
Starting with XML 1.0, each revision of XML has its own resource page, with references to that version's DTD and RELAX NG schema. The resource pages are listed at [http://www.gramps-project.org/xml/ http://www.gramps-project.org/xml/].
  
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.[http://www.nabble.com/Re%3A-Old-database-p23739659.html]
+
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.[http://www.nabble.com/Re%3A-Old-database-p23739659.html]
  
For versions of GRAMPS earlier than 3.1.1 refer to the table to decide which version to use to import a specific version of the xml, consult the table below.
+
For versions of Gramps earlier than 3.1.1 refer to the table to decide which version to use to import a specific version of the xml, consult the table below.
  
 
{| {{prettytable}}
 
{| {{prettytable}}
!GRAMPS release
+
!Gramps release
 
!XML version  
 
!XML version  
 
!Imports XML version
 
!Imports XML version

Revision as of 07:47, 22 August 2010

GRAMPS XML is the 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 primary format is performance, specifically memory considerations.

Gramps XML Resources

Starting with XML 1.0, each revision of XML has its own resource page, with references to that version's DTD and RELAX NG schema. The resource pages are listed at http://www.gramps-project.org/xml/.

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]

For versions of Gramps earlier than 3.1.1 refer to the table to decide which version to use to import a specific version of the xml, consult the table below.

Gramps release XML version Imports XML version Example
3.1.x 1.3.0 >= 1.0.0 - best 1.1.0 [2]
3.0.x 1.2.0 >= 1.1.0 [3]
2.2.x 1.1.0-1.1.4 >= 0.0.0 [4]
2.0.x 1.0.0 >= 0.0.0 [5]
1.0.x no official version (0.0.0) - [6]
0.0.x beta software (0.0.0) Unsupported Unsupported

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. Please file the bug report at http://bugs.gramps-project.org in that case.

Parsing Gramps XML file

See also