Difference between revisions of "Nl:Gramps XML"

From Gramps
Jump to: navigation, search
m ({{languages|GRAMPS_XML|GRAMPs_XML/nl}})
 
(9 intermediate revisions by 4 users not shown)
Line 1: Line 1:
{{languages|GRAMPS_XML|GRAMPs_XML/nl}}
+
{{languages|Gramps XML|Gramps XML/nl}}
'''GRAMPS XML''' is een XML formaat ontwikkeld om het GRAMPS gegevens op te slaan.
+
 
 +
'''Gramps XML''' is een XML-formaat ontwikkeld om Gramps-gegevens op te slaan.
 
Het doel is een volledig omzetbaar, door mens en machine te lezen, {{man label|XML}}-formaat te hebben. Zeer belangrijk is dat dit formaat toelaat om gegevens te lezen en weg te schrijven zonder gegevensverlies.
 
Het doel is een volledig omzetbaar, door mens en machine te lezen, {{man label|XML}}-formaat te hebben. Zeer belangrijk is dat dit formaat toelaat om gegevens te lezen en weg te schrijven zonder gegevensverlies.
 
Bovendien laat dit XML-formaat toe de gegevens op een slimme en gecomprimeerde manier op te slaan en men kan gebruik maken van een versiecontrolesysteem om veranderingen te volgen.  
 
Bovendien laat dit XML-formaat toe de gegevens op een slimme en gecomprimeerde manier op te slaan en men kan gebruik maken van een versiecontrolesysteem om veranderingen te volgen.  
  
Waarom dan dit formaat niet algemeen gebruiken voor GRAMPS? De reden: de performantie niet verlagen en speciaal om het geheugen van de computer te ontlasten, is gekozen voor een ander intern formaat.
+
De reden waarom het XML-formaat niet als werkgegevensbestandsformaat (''intern'') is performantie niet verlagen en speciaal om het geheugen van de computer te ontlasten.
  
==GRAMPS XML hulpmiddelen==
+
==Gramps XML-hulpmiddelen==
Startend met '''XML 1.0''' heeft iedere nieuwere versie van XML zijn eigen hulpmiddelenpagina waar verwezen wordt naar de ''DTD'' en het ''RELAX NG'' schema van die bepaalde revisie. Deze pagina's kunt u [http://www.gramps-project.org/xml/ hier] vinden.
+
Startend met '''XML 1.0''' heeft iedere nieuwere versie van XML zijn eigen hulpmiddelenpagina waar verwezen wordt naar de ''DTD'' en het ''RELAX NG'' schema van die bepaalde revisie. Deze pagina's kunt u op [http://www.gramps-project.org/xml/ http://www.gramps-project.org/xml/] vinden.
  
Om te kunnen beslissen welke versie u moet gebruiken voor een specifieke XML-versie dient u onderstaande tabel te raadplegen.
+
Te beginnen met Gramps 3.1.2 kunnen alle officiële versies van Gramps-XML-bestanden geïmporteerd worden. Maar er zal een waarschuwing gegeven worden wanneer u tracht om een 1.0.0 XML te importeren. Zie ook [http://sourceforge.net/mailarchive/message.php?msg_id=23262334]
 +
 
 +
Voor vroegere versies dan Gramps 3.1.1 dient u onderstaande tabel te raadplegen om de juiste versie te kiezen.
  
 
{| {{prettytable}}
 
{| {{prettytable}}
 
!Gramps versie   
 
!Gramps versie   
!xml versie  
+
!XML-versie  
!Importeert volgende xml versie
+
!Importeert volgende XML-versie
!voorbeeld
+
!Voorbeeld
 +
!Opmerkingen/Wijzigingen
 +
|-
 +
|3.4.x
 +
|1.5.0
 +
| >= 1.0.0 - optimaal 1.4.0
 +
|[http://gramps.svn.sourceforge.net/viewvc/gramps/branches/maintenance/gramps34/example//gramps/example.gramps]
 +
|Ondersteuning van citaten<br />
 +
Gramps XML is nu idempotent[http://nl.wikipedia.org/wiki/idempotentie].{{bug|4365}}<br />
 +
De exporteerder verandert de gegevensvolgorde niet meer. Dit maakt het eenvoudiger om naar verschillen tussen versies/revisies te zoeken.
 +
|-
 +
|3.3.x
 +
|1.4.0
 +
| >= 1.0.0 - optimaal 1.3.0
 +
|[http://gramps.svn.sourceforge.net/viewvc/gramps/branches/maintenance/gramps33/example/gramps/example.gramps]
 +
|[http://www.gramps-project.org/wiki/index.php?title=Gramps_3.3_Wiki_Manual_-_What%27s_new%3F#Database veranderingen]
 
|-
 
|-
 
|3.1.x
 
|3.1.x
 
|1.3.0
 
|1.3.0
 
| >= 1.0.0 - optimaal 1.1.0
 
| >= 1.0.0 - optimaal 1.1.0
|[http://gramps.svn.sourceforge.net/viewvc/gramps/branches/gramps31/example/gramps/example.gramps?view=log]
+
|[http://gramps.svn.sourceforge.net/viewvc/gramps/branches/maintenance/gramps32/example/gramps/example.gramps]
 +
|
 
|-
 
|-
 
|3.0.x
 
|3.0.x
 
|1.2.0
 
|1.2.0
 
| >= 1.1.0
 
| >= 1.1.0
|[http://gramps.svn.sourceforge.net/viewvc/gramps/branches/gramps30/example/gramps/example.gramps?view=log]
+
|[http://gramps.svn.sourceforge.net/viewvc/gramps/branches/maintenance/gramps30/example/gramps/example.gramps]
 +
|
 
|-
 
|-
 
|2.2.x
 
|2.2.x
 
|1.1.0-1.1.4
 
|1.1.0-1.1.4
 
| >= 0.0.0
 
| >= 0.0.0
|[http://gramps.svn.sourceforge.net/viewvc/gramps/branches/gramps22/example/gramps/data.gramps?view=log]
+
|[http://gramps.svn.sourceforge.net/viewvc/gramps/branches/maintenance/gramps22/example/gramps/data.gramps]
 +
|
 
|-
 
|-
 
|2.0.x
 
|2.0.x
 
|1.0.0
 
|1.0.0
 
| >= 0.0.0
 
| >= 0.0.0
|[http://gramps.svn.sourceforge.net/viewvc/gramps/branches/gramps20/gramps2/example/gramps/data.gramps?view=log]
+
|[http://gramps.svn.sourceforge.net/viewvc/gramps/branches/maintenance/gramps20/gramps2/example/gramps/data.gramps]
 +
|
 
|-
 
|-
 
|1.0.x
 
|1.0.x
 
|geen officiele versie (0.0.0)
 
|geen officiele versie (0.0.0)
 
| -
 
| -
|[http://gramps.svn.sourceforge.net/viewvc/gramps/branches/gramps10/example/gramps/data.gramps?view=log]
+
|[http://gramps.svn.sourceforge.net/viewvc/gramps/branches/maintenance/gramps10/example/gramps/data.gramps]
 +
|
 
|-
 
|-
 
|0.0.x
 
|0.0.x
 
|beta software (0.0.0)
 
|beta software (0.0.0)
| -
+
| Niet ondersteund
| ?
+
| Niet ondersteund
 +
|
 
|}
 
|}
  
==Het valideren van een ''GRAMPS XML''-bestand==
+
U kunt VirtualBox of Vmware en de oude 'lgenealogy images' van
Om het GRAMPS XML bestand te valideren t.o.v. zijn ''DTD'', gebruikt u best het '''xmllint'''-programma. Dit programma maakt deel uit van het ''libxml2-utils''-pakket.
+
http://ftp.gwdg.de/pub/linux/gramps/
 +
gebruiken om een oude XML te converteren.
 +
 
 +
===DTD aanmaken===
 +
Een hulpgereedschap zoals [http://xml2dtd.sourceforge.net/ xml2dtd] kunnen een hulp zijn voor diegenen die niet zo vertrouwd zijn met de DTD-grammatica. Dit hulpmiddel maakt een DTD-bestand van een XML-bestand aan. Nieuwe inhoud van Gramps XML kunt u hiermee testen en met een huidige Gramps DTD samenvoegen.
 +
 
 +
===RELAX NG aanmaken===
 +
Hulpgereedschappen zoals [http://code.google.com/p/jing-trang/ trang] of [http://people.apache.org/~andyc/neko/doc/dtd/index.html NekoDTD] kunnen een Gramps DTD-bestand omzetten in een RELAX NG bestand.
 +
Enkele andere hulpmiddelen en recente informatie (''22/1/2011'') vind u hier [http://www.relaxng.org/ ].
 +
 
 +
==Een ''Gramps XML''-bestand valideren==
 +
Om het Gramps Xml-bestand te valideren t.o.v. zijn ''DTD'', gebruikt u best het '''xmllint'''-programma. Dit programma maakt deel uit van het ''libxml2-utils''-pakket.
  
 
  xmllint --noout bestandsnaam.gramps
 
  xmllint --noout bestandsnaam.gramps
  
 
Wordt het bestand niet gevalideerd dan is er een fout in ofwel het ''DTD'' ofwel in het XML schrijfprogramma. Gelieve dan een foutrapport op te sturen naar ''http://bugs.gramps-project.org''.
 
Wordt het bestand niet gevalideerd dan is er een fout in ofwel het ''DTD'' ofwel in het XML schrijfprogramma. Gelieve dan een foutrapport op te sturen naar ''http://bugs.gramps-project.org''.
 +
 +
==Een ''Gramps XML''-bestand parsen==
 +
 +
* [[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]], [[Addon:Lxml Gramplet|lxml gramplet]], [http://sourceforge.net/mailarchive/message.php?msg_id=28108782 Print Notes], enz. ... zie [[media:Xpaths.gz|XPaths]].
 +
* Een [http://gramps-addons.svn.sourceforge.net/viewvc/gramps-addons/trunk/contrib/DescendantsLines/ft.py voorbeeld van een losstaand script] (Adam Sampson). Een Gramps XML-bestand om een familiestamboom te tekenen.
 +
* [http://www.gramps.van-staveren.net/ GrampsXMLview] zijn een aantal PHP-programma's in combinatie met een Gramps XML-gegevensbestand.
 +
* Een [http://sourceforge.net/projects/joomlagen/ Joomla! component/module] om een Gramps XML gegevensbestand op te laden en om genealogische informatie en overzichten te tonen.
 +
* [http://www.phpgedview.net PhpGedView] ondersteunt een eenvoudige uitvoer naar het [http://phpgedview.svn.sourceforge.net/viewvc/phpgedview/trunk/phpGedView/includes/classes/class_grampsexport.php Gramps XML-bestandsformaat.].
 +
* [http://en.wikipedia.org/wiki/Greasemonkey Greasemonkey] programma (Michiel Nauta)
 +
* ...
  
 
==Zie ook==
 
==Zie ook==
 
* [[Generate XML/nl|Aanmaken XML-bestand]]
 
* [[Generate XML/nl|Aanmaken XML-bestand]]
* [[GEDCOM/nl|GEDCOM]]
 
  
[[Category:Developers/Reference]]
+
{{languages|Gramps XML|Gramps XML/nl}}
[[Category:Developers/General]]
+
{{grampsmanualcopyright/nl}}

Latest revision as of 21:01, 21 March 2022

Gramps XML is een XML-formaat ontwikkeld om Gramps-gegevens op te slaan. Het doel is een volledig omzetbaar, door mens en machine te lezen, XML-formaat te hebben. Zeer belangrijk is dat dit formaat toelaat om gegevens te lezen en weg te schrijven zonder gegevensverlies. Bovendien laat dit XML-formaat toe de gegevens op een slimme en gecomprimeerde manier op te slaan en men kan gebruik maken van een versiecontrolesysteem om veranderingen te volgen.

De reden waarom het XML-formaat niet als werkgegevensbestandsformaat (intern) is performantie niet verlagen en speciaal om het geheugen van de computer te ontlasten.

Gramps XML-hulpmiddelen

Startend met XML 1.0 heeft iedere nieuwere versie van XML zijn eigen hulpmiddelenpagina waar verwezen wordt naar de DTD en het RELAX NG schema van die bepaalde revisie. Deze pagina's kunt u op http://www.gramps-project.org/xml/ vinden.

Te beginnen met Gramps 3.1.2 kunnen alle officiële versies van Gramps-XML-bestanden geïmporteerd worden. Maar er zal een waarschuwing gegeven worden wanneer u tracht om een 1.0.0 XML te importeren. Zie ook [1]

Voor vroegere versies dan Gramps 3.1.1 dient u onderstaande tabel te raadplegen om de juiste versie te kiezen.

Gramps versie XML-versie Importeert volgende XML-versie Voorbeeld Opmerkingen/Wijzigingen
3.4.x 1.5.0 >= 1.0.0 - optimaal 1.4.0 [2] Ondersteuning van citaten

Gramps XML is nu idempotent[3].4365
De exporteerder verandert de gegevensvolgorde niet meer. Dit maakt het eenvoudiger om naar verschillen tussen versies/revisies te zoeken.

3.3.x 1.4.0 >= 1.0.0 - optimaal 1.3.0 [4] veranderingen
3.1.x 1.3.0 >= 1.0.0 - optimaal 1.1.0 [5]
3.0.x 1.2.0 >= 1.1.0 [6]
2.2.x 1.1.0-1.1.4 >= 0.0.0 [7]
2.0.x 1.0.0 >= 0.0.0 [8]
1.0.x geen officiele versie (0.0.0) - [9]
0.0.x beta software (0.0.0) Niet ondersteund Niet ondersteund

U kunt VirtualBox of Vmware en de oude 'lgenealogy images' van http://ftp.gwdg.de/pub/linux/gramps/ gebruiken om een oude XML te converteren.

DTD aanmaken

Een hulpgereedschap zoals xml2dtd kunnen een hulp zijn voor diegenen die niet zo vertrouwd zijn met de DTD-grammatica. Dit hulpmiddel maakt een DTD-bestand van een XML-bestand aan. Nieuwe inhoud van Gramps XML kunt u hiermee testen en met een huidige Gramps DTD samenvoegen.

RELAX NG aanmaken

Hulpgereedschappen zoals trang of NekoDTD kunnen een Gramps DTD-bestand omzetten in een RELAX NG bestand. Enkele andere hulpmiddelen en recente informatie (22/1/2011) vind u hier [10].

Een Gramps XML-bestand valideren

Om het Gramps Xml-bestand te valideren t.o.v. zijn DTD, gebruikt u best het xmllint-programma. Dit programma maakt deel uit van het libxml2-utils-pakket.

xmllint --noout bestandsnaam.gramps

Wordt het bestand niet gevalideerd dan is er een fout in ofwel het DTD ofwel in het XML schrijfprogramma. Gelieve dan een foutrapport op te sturen naar http://bugs.gramps-project.org.

Een Gramps XML-bestand parsen

Zie ook

Gnome-important.png Opmerking over speciale auteursrechten: Alle aanpassingen aan deze pagina vallen onder twee verschillende auteursrechtlicenties:

Deze licenties geven het Gramps-project de maximale vrijheid om het wikihandboek als vrije inhoud voor toekomstige Gramps versies te gebruiken. Indien u niet akkoord gaat met deze dubbele licentie, pas dan de inhoud van deze pagina niet aan. U mag slechts middels externe links (gebruik: [http://www.gramps-project.org/...]) naar andere wikipagina's verwijzen die enkel onder de GFDL licentie vallen, en niet via interne links.
Gebruik daarnaast enkel de bekende conventies.