البندالقيمة
الاسم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 عبارة يربط بـ Object وصفاً واحداً بلغة معينة لهدف Subject. Codec 0x0A6L.

الوصف عبارة قصيرة تميّز الهدف (description في ويكيداتا، مثل «عاصمة ألمانيا وأكبر مدنها»). وليس تعريفاً للهدف ولا ادعاءً. تُكتب القضايا المتعلقة بالهدف بـ TRIPLE. التخطيط مثل LABEL. يوضع الوصف ولغته في Object واحد هو UTF8-LANGUAGE-TEXT. فلا يوجد حقل قيمة خام.

التخطيط

TAG WORD          0000 1010 0110 LLLL
[Length 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.
  • لا يزيد DESCRIPTION لـ Subject واللغة نفسيهما على واحد.
  • يُستخدم الوصف للتمييز عن هدف آخر بالاسم نفسه. والأفضل ألا يتكرر زوج LABEL وDESCRIPTION في اللغة نفسها لهدفين، لكن المواصفة لا تفحص ذلك (وهو توصية في ويكيداتا أيضاً لا إلزام).
  • يقيِّد مستند مواصفة geul.org الـ Object بـ CODEC (0780·0790·0050، مثل LABEL).

الطول

الكل = 1 + N_len + N_id + N_subject + N_object WORD
  • سجل اللغة وعدد بايتات النص في Object من مسؤولية سجل Object. يجب أن يطابق المؤشر بعد قراءة السجل الأخير نهاية Edge تماماً.
  • الوصف أطول من label، فيسهل أن يتجاوز كل من Object وEdge 15 WORD. عندئذ يُستخدم Length الممتد (السجل).

مثال (غير معياري)

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 byte (فردي، 18 WORD)، فهو 0x079L، وTAG 1 + TAG ممتد 1 + 20 = 22 WORD، 079E 0016 ….
  • Edge هو TAG 1 + TAG ممتد 1 + Edge Id 2 + Subject 2 + Object 22 = 28 WORD، فـ LLLL=1110، وTAG هو 0A6E، و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

مقابلة ويكيداتا

  • 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