Gramps XML/he

גרמפס XML הוא תסדיר ה־Extensible Markup Language (XML) המיועד לאחסון נתוני גרמפס. המטרה היא להציע תסדיר XML נייד לחלוטין, קריא למשתמש ולמכונה, כך שניתן יהיה לקרוא ולכתוב את הנתונים ללא כל אובדן. בנוסף, תסדיר XML מאפשר קבצים קטנים יותר (כאשר הם מכווצים) ושימוש במערכת בקרת גרסאות למעקב אחרי שינויים (כאשר הם לא מכווצים).

הסיבה לכך ש־XML אינו משמש כפורמט בסיסי ("פנימי") למסד הנתונים של גרמפס היא ביצועים, ובעיקר שיקולי זיכרון.

משאבי גרמפס XML

החל מגרמפס XML 1.0 לכל גרסה של גרמפס XML קיימת עמודת משאבים משלה, הכוללת הפניות ל־DTD ולתבנית RELAX NG של אותה גרסה. עמודי המשאבים מפורטים בכתובת https://www.gramps-project.org/xml/.

גרסת גרמפס	תבנית XML	תבנית XML מיובאת	תבנית מסד נתונים	תבנית מסד נתונים מיובאת	דוגמה	שינויים/הערות
master	ללא שינוי לעומת 6.0 עדיין	>= 1.0.0 - מומלץ 1.7	21	13-21	בלתי שוחרר example.gramps בלתי שוחרר

הערה החל מגרסה 3.1.2 של גרמפס ניתן לייבא את כל גרסאות הקבצים הרשמיות של גרמפס XML. עם זאת, בעת ייבוא גרסת XML 1.0.0 תוצג אזהרה.[1] הערה: לגרסאות גרמפס מוקדמות מ־3.1.1 יש לעיין בטבלה להלן כדי לבחור את גרסת ה־XML המתאימה לייבוא.

גרסת גרמפס	תבנית XML	תבנית XML מיובאת	תבנית מסד נתונים	תבנית מסד נתונים מיובאת	דוגמה	שינויים/הערות
6.0.x	1.7.2	>= 1.0.0 - 1.7	21	13-21	[2] תסדיר הסריאליזציה שונה מ-BLOBs תסדיר pickle ל־JSON.
5.2.x	1.7.0 - 1.7.1	>= 1.0.0 - 1.7	20	13-20	[3]	הוספת מובאות לאזכורי אירועים DB-API (SQLite) משמש כבסיס הנתונים ברירת המחדל BSDDB משמש רק להמרות ל־SQLite
5.1.x	1.7.0 - 1.7.1	>= 1.0.0 - 1.7	19	13-19	[4]	DB-API (SQLite) הוא בסיס הנתונים ברירת המחדל BSDDB הוא בסיס נתונים מיושן (Legacy)
5.0.x	1.7.0 - 1.7.1	>= 1.0.0 - 1.7	19	13-19	[5]	בסיסי הנתונים הפכו לתוספים (plugins) BSDDB הוא ברירת המחדל, המרה של מטפל ברירת מחדל (metadata) למחרוזת DB-API (SQLite) נבחן כהחלפה אפשרית
4.2.x	1.7.0 - 1.7.1	>= 1.0.0 - 1.7	18	13-18	[6]	הוספת שמות מקומות (עם תאריך ושפה) למקום
4.1.x	1.6.0	>= 1.0.0 - מומלץ 1.5.1	17	13-17	[7]	הוספת תגים לאירוע, מקום, מאגר, מקור ומובאה Source/Citation.data הפך ל־SourceAttributes הוספת תמיכה חלופית בבדיקת סכום ביקורת (checksum) על עצם מדיה הוספת PlaceRef ומדרגי מקום
4.0.x	1.5.0 - 1.5.1	>= 1.0.0 - מומלץ 1.4.0	16	13-16	[8]	-
3.4.x	1.5.0 - 1.5.1	>= 1.0.0 - מומלץ 1.4.0	16	13-16	[9]	תמיכה במובאות גרמפס XML הוא עתה איחודי־פעולה (idempotent)[10].4365 המייצא לא משנה עוד את סדר הרשומות, מה שמקל על השוואת הבדלים בין גרסאות/ריוויזיות.
3.3.x	1.4.0	>= 1.0.0 - מומלץ 1.3.0	15	13-15 (3.3.1)	[11]	הוספת שדה חדש "locality" לתבנית מקום הוספת שמות משפחה לתבנית שם (שמות משפחה הם רשימת שמות משפחה, הפרפקס והפטרונימיק הועברו לשמות משפחה) החלפת Marker ב־Tags (marker הוסר מכולם / תגיות נוספו לאיש, מדיה, משפחה והערות) עסקאות (Transactions) מיזוגים שיפורים בתסדירי ייבוא/ייצוא (vcard, gedcom, xml) Gramps_3.3_Wiki_Manual_-_What's_new?#Database Changes
3.1.x	1.3.0	>= 1.0.0 - מומלץ 1.1.0	14	13-14	[12]	הוספת קווי אורך ורוחב למקומות
3.0.x	1.2.0	>= 1.1.0	13-14 (תלוי בגרסה)	9-14 (3.0.4)	[13]	הוספת newyear לתאריכים החלפת טקסט פשוט ב־StyledText בהערות
2.2.x	1.1.0-1.1.4	>= 0.0.0	9-12 (תלוי בגרסה)	5-12 (2.2.10)	[14]
2.0.6-10	1.0.0	>= 0.0.0	8	1-8	[15]
2.0.5	1.0.0	>= 0.0.0	7	1-7	[16]
2.0.1-4	1.0.0	>= 0.0.0	6	1-6	[17]
2.0.0	1.0.0	>= 0.0.0	5	1-5	[18]	* שינוי בתסדיר שמות
1.0.x	אין גרסה רשמית (0.0.0)	-			[19]	(יש להתקין Gramps 2.2.10 כדי לייבא ולהמיר גיבויי בטא ישנים של גרמפס XML – למידע נוסף Gramps_Old_database ־ו6129)
0.0.x	תוכנת בטא (0.0.0)	לא נתמך	לא נתמך		לא נתמך

הערה: להמרת קובץ גרמפס XML ־ישן ניתן להשתמש בVirtualBox או Vmware ובתמונות lgenealogy הישנות מכתובת: http://ftp.gwdg.de/pub/linux/gramps/

יצירת DTD

כלי כמו xml2dtd עשוי לסייע למי שאינו שולט בדקדוק DTD ביצירת קובץ DTD מקובץ XML. תוכן חדש בגרמפס XML יכול להיבדק בעזרת הכלי ולהתמזג לתוך ה־DTD הנוכחי של גרמפס.

יצירת RELAX NG

כלים כגון trang או NekoDTD יכולים לסייע בהמרת קובץ DTD של גרמפס לתבנית RELAX NG. כלים נוספים ומידע עדכני מופיעים בעמוד [20].

אימות קובץ Gramps XML

כדי לאמת קובץ Gramps XML מול DTD שלו, יש להשתמש בתוכנית xmllint (הכלולה בחבילת libxml2-utils):

xmllint --noout filename.gramps

אם קובץ Gramps XML אינו עובר את האימות משמעות הדבר שגיאה ב־DTD או במחולל XML. במקרה כזה יש להגיש דיווח תקלה באתר https://gramps-project.org/bugs/.

פיענוח קובץ גרמפס XML

• תסריטי XSLT: gramps exhibit (מיכיאל נאוטה), Ancestors.xsl, Birthday.xsl (גרמפס 1.x), Tellico תסריטים, גרמפלט lxml, Print Notes, ועוד ... בעמוד XPaths.
• דוגמת תסריט עצמאי [21] (אדם סאמפסון) לפיענוח קובץ גרמפס XML לצורך שרטוט אילן־יוחסין.
• Gramps-php-exporter
• רכיב/מודול Joomla! להעלאת מאגר Gramps XML והצגת מידע גנאלוגי ותצוגות.
• PhpGedView תומך ביצוא פשוט לפורמט גרמפס XML עבור Clippings Cart, ומאפשר הורדת Gedcom שלם בפורמט גרמפס XML וכן קבלת נתונים גולמיים מ־SOAP web service בתסדיר גרמפס XML. תמיכה חלקית בגרסה 4.3.0.
• תסריטי Greasemonkey (מיכיאל נאוטה)
• GrampsXMLview - מספר תסריטי PHP בשילוב עם מאגר Gramps XML (סיירד ואן סטאברן). ארכיון אינטרנט 2012
• gramps2gource – להטשטש את הגבול בין גנאלוגיה להמחשה של ניהול תצור תוכנה.
• Betty – יוצרת אתר סטטי מוכן לפרסום מתוך ארכיוני גרמפס XML.

למידע נוסף

• grampsxml.dtd – קובץ הגדרת סוג מסמך (DTD) בסניף הראשי בגיטהאב
• grampsxml.rng – קובץ תבנית RELAX NG בסניף הראשי בגיטהאב

• report_options.xml – הגדרות דוחות
• books.xml – ספרים
• tool_options.xml
• holidays.xml – קבוצות חגים או לוחות שנה ארציים
• recent-files-gramps.xml
• fan_chart.xml
• place_formats.xml

.gramps//gramps52/

• custom_filters.xml – מסננים

• Generate XML
• מדריך: התאמת דוחות עם כלי XML
• GEDCOM
• Gramps and GEDCOM
• Database_Formats
• ויקי "פתרו את בעיית פורמט הקבצים" – פורמטים של נתוני גנאלוגיה
• Gramps Old database
• Previous releases of Gramps