15,534
edits
Changes
→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"
!XML version
!Imports XML version
!Database
!Example
!Changes/Note
|-
| Trunkmaster| Unreleased ''1.6''<br />[http://svn.code.sf.net/p/gramps/code/trunk/data/grampsxmlno change against 4.dtd grampsxml.dtd]2 yet| Unreleased <br />''>= 1.0.0 - best 1.5.0''7| 18| Unreleased <br />[http://svn.code.sf.net/p/gramps{{Code Browser}}/codetree/trunkmaster/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"
!XML version
!Imports XML version
!Database
!Example
!Changes/Note
|-
| 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<br />
|-
| 4.1.x
| 1.6.0
| >= 1.0.0 - best 1.5.1
| 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
|1.5.0 - 1.5.1
| >= 1.0.0 - best 1.4.0
|16
|[{{Code Browser}}/tree/maintenance/gramps40/example/gramps/example.gramps]
| -
|-
|3.4.x
|1.5.0- 1.5.1
| >= 1.0.0 - best 1.4.0
|16|[http:{{Code Browser}}//svn.code.sf.net/p/gramps/code/branchestree/maintenance/gramps34/example/gramps/example.gramps]
|Citations support<br />
Gramps XML is now idempotent[http://en.wikipedia.org/wiki/Idempotence].{{bug|4365}}<br />
|1.4.0
| >= 1.0.0 - best 1.3.0
|15|[http://svn.code.sf.net/p/gramps/code{{Code Browser}}/branchestree/maintenance/gramps33/example/gramps/example.gramps]|[http: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 /www.gramps-project.org>Improvements on Import/wikiExport file formats (vcard, gedcom, xml)<br /index.php?title=>[[Gramps_3.3_Wiki_Manual_-_What%27s_new%3F#Database Changes]]
|-
|3.1.x
|1.3.0
| >= 1.0.0 - best 1.1.0
|15|[http://svn.code.sf.net/p/gramps{{Code Browser}}/code/branchestree/maintenance/gramps31/example/gramps/example.gramps]|Added lat/long to places
|-
|3.0.x
|1.2.0
| >= 1.1.0
|14|[http://svn.code.sf.net/p/gramps{{Code Browser}}/code/branchestree/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
||[http:{{Code Browser}}//svn.code.sf.net/p/gramps/code/branchestree/maintenance/gramps22/example/gramps/data.gramps]
|
|-
|1.0.0
| >= 0.0.0
|13|[http://svn.code.sf.net/p/gramps/code{{Code Browser}}/branchestree/maintenance/gramps20/gramps2/example/gramps/data.gramps]|changed name formats
|-
|1.0.x
|no official version (0.0.0)
| -
||[http:{{Code Browser}}//svn.code.sf.net/p/gramps/code/branchestree/maintenance/gramps10/example/gramps/data.gramps]
|
|-
|0.0.x
|beta software (0.0.0)
| Unsupported
| Unsupported
| Unsupported
|}
{{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==
* [[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_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.
* [http://www.gramps.van[Other_genealogy_tools#Gramps-php-exporter|Gramps-staveren.net/ GrampsXMLviewphp-exporter]] is a number of PHP scripts in combination with a Gramps XML database.
* 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)
* [[Other_genealogy_tools#Grampshttp://www.gramps.van-php-exporter|staveren.net/ GrampsXMLview] is a number of PHP scripts in combination with a Gramps-php-exporter]XML database.* [https://github.com/claws/gramps2gource gramps2gource]for blurring the line between Genealogy and Software Configuration Management visualisation.
* ...
