פריטערך
שםDESCRIPTION (BIND במסמך המפרט DESCRIPTION)
TAG ID0x0A6L
Codec ID0x00000A60
מסמך מפרט0x00000000/codecs/0x00000A60/ (יעד DECLARE‏ 0A60)
קטע5 0101 (Edge של היגד), היסט C בתוך הקטע = 6
KindEdge · משפחה: היגד, קבוצה: הצבעה ושמות
TAG WORD0000 1010 0110 LLLL (000K KKKC CCCC LLLL)
תיאור באינדקסחיבור של תיאור (description) בשפה ל-Subject. הפריסה זהה ל-LABEL
בצד Hugoedge/description.md

שדות (מסמך מפרט)

הסדר של FIELD במסמך הוא סדר שדות ה-Payload (מסמך מפרט Codec). ה-Edge Id של Edge אינו מוצהר באמצעות FIELD.

סדרשדה (BIND)FIELDרוחבפורמט מקבל (CODEC)ENUM
1subject#2רשומהכל רשומה (פרט לסמן מקום)
2object#3רשומה0780 UTF8-LANGUAGE-TEXT, ‏0790 UTF8-LANGUAGE-TEXT, ‏0050 LOCAL

DESCRIPTION היא Edge של היגד שמחברת ל-Subject תיאור אחד בשפה מסוימת בתור Object. Codec‏ 0x0A6L.

התיאור הוא ביטוי קצר שמבחין את היעד (description של Wikidata, למשל: “בירת גרמניה והעיר הגדולה בה”). הוא אינו הגדרה של היעד ואינו טענה. טענה על היעד נכתבת כ-TRIPLE. הפריסה זהה ל-LABEL. התיאור והשפה שלו נכנסים ל-Object אחד, UTF8-LANGUAGE-TEXT. אין שדה של ערך גולמי.

פריסה

TAG WORD          0000 1010 0110 LLLL
[Length extension TAG]
Edge Id           רשומת LOCAL Reference
Subject           רשומת Reference אחת
Object            Value מסוג UTF8-LANGUAGE-TEXT או רשומת LOCAL Reference אחת

פירוש ותוקף

  • הכללים של ה-Subject וה-Object זהים ל-LABEL. ה-Subject הוא רשומת Reference שלמה אחת בדיוק. ה-Object הוא רשומת UTF8-LANGUAGE-TEXT ‏(0x078L·0x079L) שלמה אחת בדיוק, או LOCAL Reference שנפתר ל-UTF8-LANGUAGE-TEXT באמצעות קשירת REFERENCE-NODE באותו מסמך.
  • טקסט בלי שפה (UTF8-TEXT) אינו יכול להיות DESCRIPTION. התיאור הוא אחד לכל שפה, ולכן הכלל הזה מתקיים רק כשיש שפה. תיאור משותף לכמה שפות נכתב עם השפה mul.
  • לאותו Subject ואותה שפה יש לכל היותר DESCRIPTION אחד.
  • התיאור משמש להבחנה בין יעדים בעלי אותו שם. רצוי שזוג LABEL ו-DESCRIPTION באותה שפה לא יחזור בשני יעדים, אך המפרט אינו בודק זאת (גם ב-Wikidata זו רק המלצה ולא אכיפה).
  • מסמך המפרט של geul.org מגביל את ה-Object באמצעות CODEC (0780·0790·0050, כמו ב-LABEL).

אורך

סה"כ = 1 + N_len + N_id + N_subject + N_object WORD
  • מספר בתי השפה והטקסט של ה-Object הוא באחריות רשומת ה-Object. הסמן אחרי קריאת הרשומה האחרונה חייב להתלכד בדיוק עם סוף ה-Edge.
  • תיאור ארוך מ-label, ולכן קל לחרוג מ-15 WORD גם ב-Object וגם ב-Edge. אז משתמשים ב-Length extension (רשומה).

דוגמה (לא נורמטיבית)

Edge Id הוא 0009, ה-Subject הוא Q64 (‏0141 0040), וה-Object הוא capital and largest city of Germany (en). השפה היא דוגמה בפורמט LANGUAGE-BCP47-CODE (ל-en יש מספר רישום 0x0784, ולכן אפשר להשתמש גם ב-SHORT-CODE).

  • ה-Object: השפה 0761 656E (BCP47 ‏en, ‏2 WORD) + טקסט של 35 בתים (אי-זוגי, 18 WORD), לכן 0x079L, ‏TAG 1 + extension TAG 1 + 20 = 22 WORD, ‏079E 0016 ….
  • ה-Edge הוא TAG 1 + extension TAG 1 + Edge Id 2 + Subject 2 + Object 22 = 28 WORD, לכן LLLL=1110, ה-TAG הוא 0A6E וה-extension TAG הוא 001C.
0A6E 001C 0051 0009 0141 0040
079E 0016 0761 656E 6361 7069 7461 6C20 616E 6420 6C61 7267 6573 7420 6369 7479 206F 6620 4765 726D 616E 7900

התאמה ל-Wikidata

  • ה-descriptions של פריט (אחד לכל שפה) ← DESCRIPTION אחד לכל שפה. קוד השפה מומר לפי אותה טבלת התאמה של קודי שפה כמו ב-LABEL.

בעיות פתוחות

  • האם יש מקרים שבהם כדאי לאפשר תיאור UTF8-TEXT בלי שפה (כרגע אינו מותר).

דפים קשורים

טקסט מקורי של מסמך המפרט

כך נראה מסמך המפרט 0x00000000/codecs/0x00000A60/latest.geul כשהוא נקרא באמצעות geul show (ספרות הקסדצימליות באותיות גדולות).

SPEC-VERSION 0x0001
DOC-ID 0x04260000000000000A6000000000
BODY
#1 DECLARE 0x0A60
#2 FIELD #1 record
#3 FIELD #1 record
#4 BIND #1 "DESCRIPTION"
#5 BIND #2 "subject"
#6 BIND #3 "object"
#7 CODEC #3 0x0780
#8 CODEC #3 0x0790
#9 CODEC #3 0x0050