| البند | القيمة |
|---|---|
| الاسم | DOC-ID (BIND مستند المواصفة DOC-ID) |
| TAG ID | 0x1C7L |
| Codec ID | 0x00001C70 |
| مستند المواصفة | 0x00000000/codecs/0x00001C70/ (هدف DECLARE 1C70) |
| القسم | 14 1110 (Meta)، الإزاحة داخل القسم C = 7 |
| Kind | Meta · الفئة: التعريف |
| TAG WORD | 0001 1100 0111 LLLL (000K KKKC CCCC LLLL) |
| وصف الفهرس | معرّف هذا المستند. Reference مضمّن DOC-POINTER (Issuer، معرّف المستند، الإصدار 0). ومستند Codec يستخدم CODEC-POINTER (Issuer، Codec ID، الإصدار 0) |
| جهة Hugo | meta/declaration/doc-id.md |
الحقول (مستند المواصفة)
ترتيب FIELD داخل المستند هو ترتيب حقول Payload (مستند مواصفة Codec).
| الترتيب | الحقل (BIND) | FIELD | العرض | الصيغة المستقبِلة (CODEC) | ENUM |
|---|---|---|---|---|---|
| 1 | doc | #2 | سجل | 0410 DOC-POINTER، 0420 CODEC-POINTER |
يعلن معرّف هذا المستند. وهو لازم لكي تشير مستندات أخرى إلى هذا المستند وإلى الأهداف داخله.
التخطيط
TAG WORD 0001 1100 0111 LLLL Codec 0x1C7L
[Length TAG ممتد]
المستند سجل Reference من DOC-POINTER. (Issuer، معرّف المستند، الإصدار 0). ومستند Codec يستخدم CODEC-POINTER
- Codec: Meta
0x1C7L، فئة التعريف - Payload: Reference مضمّن واحد DOC-POINTER (Issuer، معرّف المستند، الإصدار 0)
- العدد: واحد على الأكثر. وهو إلزامي في مستندات الإصدار تحت
docs/<معرّف المستند>/وcodecs/<Codec ID>/
التفسير والصلاحية
- Payload هو سجل Reference واحد بالضبط من
DOC-POINTER(Issuer، معرّف المستند، الإصدار0). ولا يُستخدم لمعرّف الإصدار إلا0. فالإصدار لا يعيّنه المستند بل تعيّنه قائمة الإصدارات. ومستند Codec يستخدمCODEC-POINTER(Issuer، Codec ID، الإصدار0) (CODEC-POINTER). - لذلك فإن صيغة الإشارة إلى «هذا المستند» واحدة في DOC-ID وفي سجل PUBLICATION في قائمة الإصدارات وفي اقتباسات المستندات الأخرى.
- المستند نفسه بصرف النظر عن الإصدار له
DOC-IDنفسه. ولا يُكتب معرّف الإصدار ولا تجزئة المحتوى في المستند (الإصدار). - لا يوجد عنوان باسم المستند (عناوين النشر وقوائم الإصدارات). والعنوان الذي يقرأه الإنسان يتولاه LABEL من نوع العبارة.
- إذا غاب فالمستند بلا اسم ولا يمكن الإشارة إليه إلا بتجزئة المحتوى. وهو لازم لكي يشير مستند آخر إلى LOCAL في هذا المستند بـ Reference إشاري.
- الجهة التي تجلب المستند تتحقق من أن
DOC-IDفي المستند المستلَم يساوي Issuer ومعرّف المستند المطلوبين. - معرّف المستند
0x0000000000000000هو مستند فهرس تعريف المصطلحات لدى Issuer (Issuer). وهذا المستند أيضاً مستند إصدار تحتdocs/<معرّف المستند>/فيوضع له DOC-ID (DOC-POINTER(Issuer،0،0)). أما Issuer نفسه فيمثّله ISSUER-POINTER. - مستندات الإصدار
<معرّف الإصدار>.geul(ومنها مستندات المواصفة) تحت<Issuer>/docs/<معرّف المستند>/و<Issuer>/codecs/<Codec ID>/في.well-known/geul/يلزمهاDOC-ID. - مستندات القوائم استثناء ولا يوضع فيها
DOC-ID: قائمة الإصداراتversions.geul(PUBLICATION) وإصدار<معرّف الإصدار>.geulمن قائمة Issuer فيissuers/(عناوين النشر وقوائم الإصدارات). وما تسرده القائمة يحدده DOC-POINTER في السجل. وإصدار مستند القائمة تشير إليه PUBLICATION فيversions.geulالخاص بها بـ DOC-POINTER (0x00000000، معرّف مستند محجوز، معرّف الإصدار). أما عنوان تجزئة المحتوى<Issuer>/hashes/فهو نسخة من المستندات أعلاه فيتبع الأصل. - معرّف المستند
0xFFFFFFFFFFFFFFFFمحجوز في كل Issuer (و0x0000000000000000كذلك)، ويُستخدم في قائمة Issuer لدى Issuer0x00000000. ولا يستخدمه Issuer آخر. ولأن مستند القائمة بلاDOC-IDفلا تظهر هذه القيمة إلا في DOC-POINTER داخل سجلissuers/versions.geul. - مستند مواصفة Codec هو مستند Codec لدى GEUL Issuer
0x00000000. وليس له معرّف مستند، ويضع فيDOC-IDقيمة CODEC-POINTER (0x00000000، Codec ID،0). وCodec ID هو قيمة Kind وCodec في TAG WORD مكتوبة في 32 بت (0x0B80←0x00000B80) (مستند المواصفة).
مثال
- Issuer
0x00000002، المستند0x…0005:1C79 0418 0000 0002 0000 0000 0000 0005 0000 0000(TAG لـ Meta 1 + TAG لـ Reference 1 + Issuer 2 + معرّف المستند 4 + الإصدار 2 = 10 WORD)
نص مستند المواصفة
هذه هي صورة مستند المواصفة 0x00000000/codecs/0x00001C70/latest.geul عند قراءته بـ geul show (الأرقام الستة عشرية بأحرف كبيرة).
SPEC-VERSION 0x0001
DOC-ID 0x04260000000000001C7000000000
BODY
#1 DECLARE 0x1C70
#2 FIELD #1 record
#5 CODEC #2 0x0410
#3 BIND #1 "DOC-ID"
#4 BIND #2 "doc"
#6 CODEC #2 0x0420