Reference הוא רשומה המצביעה על יעד. היעד יכול להיות ישות, מושג, מסמך או Edge אחר. מצביעים עליו ב-ID ולא בשם.

פריסה

TAG WORD          000K KKKC CCCC LLLL      קטעים 0~2 (0x000L~0x05FL)
[Length TAG הרחבה]
[IMPORT ID]       ב-EXTERNAL-POINTER (1/2/4 WORD)
[Issuer]          ב-EXTERNAL-ISSUER (2/4/16 WORD)
[ID מסמך]         ב-EXTERNAL-ISSUER (4 WORD)
ID יעד            כל השאר
  • LLLL הוא מספר ה-WORD הכולל, כולל ה-TAG WORD, פחות אחד (רשומה ו-TAG WORD).
  • Reference הוא 96 מקומות בקטעים 0~2 (w < 0x0600). קטע 0, ישויות: 0x000L~0x01FL. קטע 1, EXTERNAL: 0x020L~0x03FL. קטע 2, שונים: 0x040L~0x05FL.
  • ה-Codec נכתבים בטבלת קודים (להלן). בערכת 5Q, קוד אחד נושא יחד את ערכת הזיהוי ואת הכימות. הכימות של REFERENCE-ISSUER נקבע במסמך ה-Issuer.
  • ID היעד הוא מספר שלם ללא סימן ב-big-endian ונכתב ברוחב הקצר ביותר. הרוחב הוא מה שנותר מ-Length אחרי הפחתת השדות הקודמים.
  • ID יעד 0 נכתב כ-0x0000 ב-WORD אחד. בשאר המקרים אין מוסיפים לפניו WORD 0x0000.
  • ערכים שלמים שווים הם אותו ID. הרוחב אינו חלק מה-ID.
  • כל ה-Codec משתמשים ברוחב הקצר ביותר. Codec אינו קובע רוחב קבוע ל-ID היעד.
  • ISSUER-POINTER, DOC-POINTER ו-CODEC-POINTER אינם פועלים לפי הפריסה הזו. אין להם ID יעד, ויש בהם רק Issuer (ו-ID מסמך, Codec ID, ID גרסה).
  • גם REFERENCE-ISSUER אינו פועל לפי הפריסה הזו. הוא TAG, Issuer, מספר Codec של 2 WORD ו-Payload. ה-Payload נקבע במסמך ה-Codec ש-Issuer פרסם.

Codec

TAG IDשםסיווגיעד
0x000L~0x002Lסמן מקוםסמן מקוםאינו מצביע על יעד. משתמשים רק בסמנים של WORD אחד: 0x0000 ABSENT (לא נרשם), 0x0010 UNKNOWN-VALUE (לא ידוע), 0x0020 NO-VALUE (אין)
0x005L~0x009LLOCALהצהרהID שהמסמך הזה הנפיק
0x00AL~0x00ELGEULהצהרהישות ש-geul.org מנפיק
0x00FL~0x013LGEUL-SIDXהצהרהמזהה מיושר-משמעות שהביטים שלו נושאים משמעות
0x014L~0x018LWIKIDATA-QIDהצהרהפריט ב-Wikidata. המספר השלם אחרי Q
0x019L~0x01DLWIKIDATA-PIDהצהרהתכונה ב-Wikidata. המספר השלם אחרי P
0x020L~0x02ELEXTERNAL-POINTER-1/2/4WORDמכווןLOCAL ID של מסמך שיובא ב-IMPORT
0x02FL~0x03DLEXTERNAL-ISSUER-2/4/16WORDמכוון-מצהירLOCAL ID של מסמך שפרסם Issuer
0x040LISSUER-POINTERמכוון-מצהירה-Issuer עצמו
0x041LDOC-POINTERמכוון-מצהירגרסה אחת של מסמך שפרסם Issuer
0x042LCODEC-POINTERמכוון-מצהירגרסה אחת של Codec שפרסם Issuer
0x05DL~0x05FLREFERENCE-ISSUER-2/4/16WORDפורמט Issuerה-Issuer מגדיר. הסיווג ומקום ID היעד נקבעים במסמך ה-Issuer
  • Reserved הם 0x003L~0x004L, 0x01EL~0x01FL (קטע 0), 0x03EL~0x03FL (קטע 1) ו-0x043L~0x05CL (קטע 2, מקום לערכות זיהוי חדשות).
  • מספר הערכה נקרא מההיסט בתוך הקטע C. בקטע 0, אם 5 <= C < 30, הערכה היא C / 5 (1~5). בקטע 1, אם C < 30, הערכה היא 6 + C / 5 (6~11).
ערכהשםIdentifiedGenericFree-choiceUniversalVariable
1LOCAL0x005L0x006L0x007L0x008L0x009L
2GEUL0x00AL0x00BL0x00CL0x00DL0x00EL
3GEUL-SIDX0x00FL0x010L0x011L0x012L0x013L
4WIKIDATA-QID0x014L0x015L0x016L0x017L0x018L
5WIKIDATA-PID0x019L0x01AL0x01BL0x01CL0x01DL
6EXTERNAL-POINTER-1WORD0x020L0x021L0x022L0x023L0x024L
7EXTERNAL-POINTER-2WORD0x025L0x026L0x027L0x028L0x029L
8EXTERNAL-POINTER-4WORD0x02AL0x02BL0x02CL0x02DL0x02EL
9EXTERNAL-ISSUER-2WORD0x02FL0x030L0x031L0x032L0x033L
10EXTERNAL-ISSUER-4WORD0x034L0x035L0x036L0x037L0x038L
11EXTERNAL-ISSUER-16WORD0x039L0x03AL0x03BL0x03CL0x03DL
  • הצהרה מזהה את היעד ישירות באמצעות ID שגורם ההנפקה קבע.
  • מכוון מצביע על LOCAL בתוך מסמך שיובא באמצעות IMPORT ID. רוחב ה-IMPORT ID נקבע לפי הערכה: אם ערכה − 6 הוא 0, 1 או 2, הרוחב הוא 1, 2 או 4 WORD.
  • מכוון-מצהיר מצביע ברשומה אחת, בלי IMPORT, על מסמך אחר ועל יעד בתוכו. רוחב ה-Issuer ב-EXTERNAL-ISSUER הוא 2, 4 או 16 WORD כאשר ערכה − 9 הוא 0, 1 או 2.
  • 0x020L~0x03DL (קטע 1, ערכות 6~11) מצביעים על LOCAL של מסמך אחר. ערכות ההצהרה האחרות מזהות את היעד ישירות (LOCAL של המסמך הזה, ID מונפק). מצביעים (קטע 2, 0x040L~0x042L) מצביעים על ה-Issuer, המסמך וה-Codec עצמם. REFERENCE-ISSUER נמצא מחוץ להבחנה הזו.
  • 0x000L~0x002L הם קודים שהוקצו לסמני מקום, ולא משתמשים בהם כ-Reference המצביע על יעד. ה-WORD 0x0000, 0x0010 ו-0x0020 (L 0, WORD אחד) הם סמני מקום (0x0000 ABSENT, 0x0010 UNKNOWN-VALUE, 0x0020 NO-VALUE). הסמן תקף רק במקום של שדה ברשומה שיעד ה-CODEC שלו הוא בדיוק ה-WORD הזה. תו כללי (wildcard) ושדה ללא CODEC אינם מקבלים אותו, ובמקום של רשומת HEAD או BODY ובמקום של Edge Id הוא invalid. צורת TAG עם Payload ב-C 0~2 (L ≥ 1) היא Reserved.
  • רק direct code ופרסומים ש-geul.org מספק הם CC0. אין מציבים כ-direct code ערכות זיהוי שאינן CC0 (WordNet ועוד). הרישיון של פורמט Issuer נקבע על ידי אותו Issuer.

TAG נפוצים

רשומהWORD
LOCAL 10051 0001
LOCAL 655360052 0001 0000
Wikidata Q5 (אדם)0141 0005
Wikidata Q6912830142 000A 8C53
Wikidata P31 (instance of)0191 001F
סמן מקום ABSENT / UNKNOWN-VALUE / NO-VALUE0000 / 0010 / 0020

LOCAL

LOCAL הוא ID שהמסמך הזה הנפיק.

  • ייחודי. במסמך אחד, LOCAL ID אחד מצביע על יעד אחד בלבד.
  • 0 אינו מוקצה. ID של יעד מוקצים החל מ-1.
  • מומלץ להקצות בסדר עולה (auto increment). לגודל ה-ID אין משמעות.
  • הוא מצביע על אותו יעד גם בין גרסאות. ID שנמחק אינו נעשה בו שימוש חוזר (תיקון של מסמך).
  • כדי שיהיה אפשר להצביע מחוץ למסמך, חייב להיות במסמך DOC-ID.
  • LOCAL ID שונים אינם אומרים שהיעדים במציאות שונים. אם הם זהים, מקשרים ב-Edge SAME-NODE, ואם שונים, ב-DIFFERENT-NODE.

Edge Id

כל Edge מציב LOCAL Reference כאיבר הראשון ב-Payload שלו. אותו LOCAL ID הוא Edge Id.

  • אפשר לקרוא את ה-Edge Id גם בלי הקודבוק.
  • LOCAL במקום של Edge Id הוא הצהרה, ו-LOCAL בשאר המקומות של ה-Edge הוא אזכור.
  • ההצהרה על Edge Id משתמשת רק ב-LOCAL מסוג Identified (0x005L).
  • Edge אחר מצביעים עליו ב-Edge Id. Edge של המסמך הזה מצביעים עליו ב-LOCAL, ו-Edge של מסמך אחר ב-Reference מכוון.

הצבעה על מסמכים אחרים

מהאיך
ה-Issuer עצמוISSUER-POINTER (Issuer)
גרסה אחת של מסמךDOC-POINTER (Issuer, ID מסמך של 4 WORD, ID גרסה של 2 WORD). גרסה 0 היא העדכנית
גרסה אחת של CodecCODEC-POINTER (Issuer, Codec ID של 2 WORD, ID גרסה של 2 WORD). גרסה 0 היא העדכנית
יעד בתוך מסמך שפורסם (עדכני)EXTERNAL-ISSUER-* (Issuer, ID מסמך, LOCAL ID)
יעד בתוך מסמך שיובא (גרסה מקובעת)מקצים IMPORT ID באמצעות Meta IMPORT-DOC ו-EXTERNAL-POINTER-* (IMPORT ID, LOCAL ID)
  • מסמך עצמו, בין בתוך המסמך ובין מחוצה לו, מצביעים עליו רק ב-DOC-POINTER אחד. הצבעה על עצמו היא DOC-POINTER של ה-DOC-ID שלו. מסמך Codec הוא יוצא מן הכלל ומצביעים עליו ב-CODEC-POINTER (גם DOC-ID שלו הוא CODEC-POINTER).
  • EXTERNAL-ISSUER עוקב אחר הגרסה העדכנית. כדי לקבע גרסה משתמשים ב-IMPORT.
  • ה-Issuer נכתב ברוחב הקצר ביותר שהערך נכנס בו (2/4/16 WORD) ובוחרים Codec התואם לאותו רוחב. כך ב-EXTERNAL-ISSUER וב-REFERENCE-ISSUER.
  • ID מסמך 0 של כל Issuer שמור למסמך האינדקס של המונחים שה-Issuer הגדיר (כלים, תפקידים ועוד). מסמך אינדקס מומלץ לכל Issuer ואינו חובה (Issuer ופרסום).

דוגמה: LOCAL 7 בתוך המסמך 0x0000000000000002 של Issuer 0x00000002

02F7 0000 0002 0000 0000 0000 0002 0007

Quantifier

C % 5שםמשמעותדוגמה
0Identifiedישות מזוההאילון מאסק, הרפובליקה של קוריאה
1Genericהיגד כללי על סוג שלם. מתיר חריגיםחיילים מצייתים לפקודות
2Free-choiceיעד כלשהו העונה על התנאיכל חייל שהוא
3Universalכל היעדים בטווחכל החיילים
4Variableמשתנה שיחהאדם ההוא, האישה הזאת
  • הכימות נקרא רק בערכות 5Q (ערכות 1~11). לפי ההיסט בתוך הקטע C: בקטע 0 כאשר 5 <= C < 30, ובקטע 1 כאשר C < 30, הכימות הוא C % 5. קטע הוא 32 מקומות, ולכן חלוקת מקום ה-Codec של 9 ביט (w >> 4) ב-5 תסיט את קטע 1. לסמנים (קטע 0, C < 3) ולקטע 2 (מצביעים, REFERENCE-ISSUER) אין כימות. הסמן 0x0010 UNKNOWN-VALUE אינו Generic. הכימות של REFERENCE-ISSUER נקבע במסמך ה-Codec ש-Issuer פרסם.
  • Generic, שלא כמו Universal, אינו אומר שהוא חל על כל יעד בודד ללא חריגים. אפשר להשתמש ב-Generic בביטוי הגדרתי כמו «מהו חייל». כשנדרשת הגדרה קפדנית של מושג או סיווג, מפרטים אותה ביחס נפרד.
  • היקף הכימות והשלילה שלו נקבעים על ידי ה-Edge שמשתמש בו, ולא על ידי ה-Reference.
  • Variable הוא יעד בשיח שסוגו ידוע אך הוא עדיין לא זוהה.
    • משתנה בעל שם מקבלים בצירוף Variable ל-LOCAL. אותו LOCAL ID הוא אותו משתנה. את הסוג מקשרים ב-Edge.
    • משתנה אנונימי מקבלים בצירוף Variable ל-Codec הצהרה שמציין את הסוג (GEUL, WIKIDATA-*) (לדוגמה: «נשיא» ב-Wikidata + Variable). אין עוקבים אחר הפניה משותפת ואי אפשר להצביע עליו שוב. משתנים אנונימיים אינם נחשבים לאותו משתנה.
    • כשהיעד מתברר מאוחר יותר, מקשרים את המשתנה ליעד ב-SAME-NODE. כל הביטויים המצביעים על אותו משתנה מפורשים יחד כאותו יעד.
    • גם משתנים שונים אינם בהכרח יעדים שונים במציאות. אם הם זהים, מקשרים ב-SAME-NODE, ואם שונים, ב-DIFFERENT-NODE.
    • ב-Codec מכוון חיצוני (EXTERNAL-POINTER-, EXTERNAL-ISSUER-), Variable הוא משתנה LOCAL של המסמך שמצביעים עליו.
    • דוגמה: ב«הנשיא נשא נאום», אם האדם לא נקבע, משתמשים ב-Variable של «נשיא». כדי להזכיר אותו שוב, מציבים LOCAL Variable ומקשרים ב-Edge את הסוג «נשיא». אם מתברר מאוחר יותר שזה אובמה, מקשרים את המשתנה ל-Identified של אובמה ב-SAME-NODE. כל הביטויים המצביעים על אותו משתנה מפורשים יחד כאובמה.
  • דוגמה: Q5 (אדם) ב-Wikidata, ב-Generic, הוא 0151 0005 («אדם הוא …»).

REFERENCE-ISSUER

REFERENCE-ISSUER הוא פורמט Reference שה-Issuer הגדיר. אלה שלושת המקומות האחרונים באזור Reference. הפריסה זהה ל-ISSUER של Value ושל Edge (רשומה ו-TAG WORD).

פריסה

TAG WORD          0000 0101 11WW LLLL      Codec 0x05DL / 0x05EL / 0x05FL (WW = רוחב Issuer: 01 2, 10 4, 11 16 WORD)
[Length TAG הרחבה]
Issuer            2/4/16 WORD (ה-Codec קובע את הרוחב)
מספר Codec        2 WORD. ה-Issuer מגדיר
Payload           נקבע במסמך ה-Codec ש-Issuer פרסם
Codecשםרוחב Issuer
0x05DLREFERENCE-ISSUER-2WORD2 WORD
0x05ELREFERENCE-ISSUER-4WORD4 WORD
0x05FLREFERENCE-ISSUER-16WORD16 WORD

פירוש ותוקף

  • GEUL מכיר רק את גבול ה-Payload דרך Length. אין מפרשים Payload בלי קודבוק.
  • משמעות מספר ה-Codec והכימות נקבעים על ידי ה-Issuer. גם מה שהוא מצביע עליו נקבע במסמך ה-Codec ש-Issuer פרסם.
  • כללי Reference המשותפים אינם חלים: הרוחב הקצר ביותר של ID היעד, הכתיבה של ID יעד 0 ב-WORD אחד, Quantifier, קריאת כימות וערכה לפי ההיסט בתוך הקטע, הסיווג להצהרה ולמכוון, והיעד המצוין.
  • מספר Codec של 2 WORD זהה ל-ISSUER של Value ושל Edge. אם המספרים אינם מספיקים, מקבלים Issuer נוסף.
  • מפענח שאינו מכיר את הפורמט יודע עד Kind, Length, Issuer ומספר Codec, ומדלג דרך Length.
  • הרישיון של פורמט Issuer נקבע על ידי אותו Issuer (Issuer ופרסום).

דפים קשורים