Meta سجلات تخص المستند نفسه لا مضمون العالم. وتوضع كلها في HEAD الخاص بالمستند باستثناء سجلات بنية المستند (DOC وBODY وEND). ويأتي في HEAD إلى جانب Meta أيضاً Edge الدليل SOURCE للمستند كله مع QUALIFIER الخاص به.

التخطيط

TAG WORD          000K KKKC CCCC LLLL      القسمان 14 و15 (0x1C0L~0x1FFL)
[Length TAG ممتد]
Payload           قيمة خام، أو سجلات Value وReference مضمّنة
  • ليست لـ Meta صيغة Issuer. فهي مواصفة مشتركة يتبعها كل Issuer ولا يعرّفها إلا GEUL.
  • LLLL هو العدد الكلي لـ WORD بما فيها TAG WORD ناقصاً 1. وأي Codec غير مذكور في الجدول فهو Reserved.

صيغة Payload

الصيغةمتىمثال
قيمة خامحين تتعين صيغة واحدة. ولا تعتمد على Codec سجل آخرطول DOC-* وSPEC-VERSION وISSUER-KEY
Value مضمّنةحين يُختار من عدة صيغ. ويدل TAG الخاص بـ Value على الصيغةPROFILE وEFFECTIVE-* والوقت وتجزئة المحتوى
Reference مضمّنحين يُشار إلى هدف مثل شخص أو منظمة أو أداة أو مستندDOC-ID وAUTHOR وCO-AUTHOR وRECORDED-BY وSIGNED-OFF وموقِّع SIGNATURE
لا شيءعلامة من 1 WORDBODY وEND
  • السجل المضمّن ليس سجلاً مستقلاً بل يتبع Meta الذي هو فيه. ويجد كل منها حدّه بـ Length الخاص به، ويجب أن يطابق موضع قراءة آخر سجل نهاية Meta تماماً.
  • ما يجوز وضع واحد منه فقط في المستند وما يجوز وضع عدة منه، يحدده «العدد» في مستند كل Codec.

الفئات

تتتابع أرقام Meta من 0x1C0L بلا Reserved. ولا تدل بتات الرقم على الفئة. وتُعرف الفئة من جدول النطاقات أدناه.

الفئةالرمز المباشرما تتناوله
البنية0x1C0L~0x1C4Lحدود المستند وطوله
التعريف0x1C5L~0x1CALتصريحات التفسير
المصدر0x1CBL~0x1D0Lمن وفي أي وقت وأين
النسب0x1D1L~0x1DDLمما جاء وكيف
السياسة0x1DEL~0x1E3Lكيف يُعامل
IMPORT0x1E4Lاستيراد مستند خارجي
التحقق0x1E5L~0x1E9Lهل يمكن الوثوق به
Reserved (للتحقق فقط)0x1EAL~0x1FFL
  • فئة التحقق هي السجلات التي C >= 5 في القسم 15، أي w >= 0x1E50. وبهذا تُعرف فئة التحقق دون codebook وتُستثنى من تجزئة المحتوى.
  • الـ Reserved اللاحق 0x1EAL~0x1FFL للتحقق فقط. فأي Meta جديد خارج التحقق لا يمكن وضعه قبل التحقق، وإن وُضع في الـ Reserved اللاحق استُثني من تجزئة المحتوى.
  • لا تُقرأ فئات البنية والتعريف وIMPORT بالبتات. فيعرفها المفكك من جدول الأرقام المضمّن.
  • Meta اللازم للتفسير: البنية والتعريف وIMPORT. فبحذفه لا يمكن قراءة السجلات أو يتغير التفسير. ويجب أن يعالجه كل مفكك. وهذه الـ Codec ضمن codebook GEUL الأساسي.
  • Meta الذي لا يغيّر التفسير: المصدر والنسب والتحقق والسياسة. فبحذفه يبقى مضمون العبارات كما هو. ولا يضيع إلا مادة الحكم على الموثوقية والتعامل.
  • الدليل لا يُكتب بـ Meta بل بـ Edge الدليل SOURCE وQUALIFIER. فدليل السجل المفرد في BODY، والمصدر الأصلي للمستند كله في HEAD بـ SOURCE الذي Target فيه 0 (المستند).

البنية

فئة البنية في Meta (Codec 0x1C0L~0x1C4L) تحدد حدود المستند وطوله. ووحدة بيانات GEUL هي مستند واحد.

DOC-*                  ← بداية HEAD
  Meta للتعريف والمصدر والنسب والتحقق والسياسة وIMPORT
  SOURCE للمستند كله مع QUALIFIER الخاص به
BODY                   ← بداية BODY
  Reference وValue وEdge
END                    ← إغلاق المستند
  • يُفتح كل مستند بـ DOC-1WORD/2WORD/4WORD الذي يحدد الطول الكلي. ويستطيع المفكك بهذا الطول أن يتخطى المستند كله دفعة واحدة.
  • BODY وEND سجلان من 1 WORD بلا Payload. وEND إلزامي.
  • لا تتداخل المستندات. وتُشار المستندات الأخرى بـ IMPORT.
  • إذا كان HEAD (Meta، و SOURCE للمستند كله مع QUALIFIER الخاص به) فارغاً فيُحذف BODY. ولا يوضع BODY إلا مرة واحدة في المستند.

بنية المستند كاملة في المستند.

Codecالاسمالمعنى
0x1C0L~0x1C2LDOC-1WORD / 2WORD / 4WORDيفتح المستند بتحديد الطول الكلي
0x1C3LBODYينهي HEAD ويفتح BODY
0x1C4LENDيغلق المستند

التفاصيل في المستند.

التعريف

فئة التعريف في Meta (Codec 0x1C5L~0x1CAL) هي تصريحات التفسير. والتصريح يغيّر قواعد التفسير فيجب أن يعالجه كل مفكك. ونطاق التصريح هو ذلك المستند.

  • SPEC-VERSION يحدد كيف تُقرأ بقية السجلات فيوضع عدد صحيح فقط دون Value مضمّن. وGEUL v1 هو 0x0001 (السجل 1C51 0001).
  • DOC-ID هو DOC-POINTER (Issuer، معرّف المستند، الإصدار 0) الذي يشير إلى المستند نفسه. ومستند Codec يستخدم CODEC-POINTER (Issuer، Codec ID، الإصدار 0). وإذا غاب فالمستند بلا اسم ولا يمكن الإشارة إليه إلا بتجزئة المحتوى.
  • لا يوجد عنوان باسم المستند. والعنوان الذي يقرأه الإنسان يُلحق بـ LABEL من نوع العبارة (عناوين النشر وقوائم الإصدارات).
Codecالاسمالمعنى
0x1C5LSPEC-VERSIONإصدار المواصفة المتبَع. عدد صحيح واحد
0x1C6LPROFILEالـ profile المطبَّق
0x1C7LDOC-IDمعرّف هذا المستند. DOC-POINTER يشير إلى نفسه (الإصدار 0). ومستند Codec يستخدم CODEC-POINTER (الإصدار 0)
0x1C8LEFFECTIVE-FROMتاريخ سريان هذا الإصدار. وإذا غاب فهو وقت النشر
0x1C9LEFFECTIVE-UNTILنهاية مدة سريان هذا الإصدار (قانون مؤقت). وإذا غاب فحتى سريان الإصدار التالي
0x1CALDEFAULT-LANGUAGEاللغة الافتراضية

المصدر

فئة المصدر في Meta (Codec 0x1CBL~0x1D0L) تكتب من أنشأ المستند وسجّله ومتى.

  • المؤلف والمسجِّل ووقتاهما يتبعان نموذج author وcommitter في git (AUTHOR وCREATED-AT، RECORDED-BY وRECORDED-AT).
  • بحذف المصدر لا يتغير مضمون العبارات. ولا يضيع إلا مادة الحكم على الموثوقية.
  • المادة المصدرية ليست في هذه الفئة. فالمصدر الأصلي للمستند كله يُكتب في HEAD، ومصدر السجل المفرد في BODY، بـ Edge الدليل SOURCE. ونطاق التقابل في النص الأصلي ووقت الحصول وتجزئة النص الأصلي هي QUALIFIER تُلحق بذلك SOURCE (الصفحة P304 والفقرة P958 وتاريخ الاطلاع P813 والمجموع الاختباري P4092).
  • إذا وُضعت صفات تتبع المصدر (نطاق النص الأصلي ووقت الحصول) في Meta فلا يمكن تحديد صاحبها حين تتعدد المصادر. ولذلك تُكتب بـ QUALIFIER يكون SOURCE هو Target لها.
Codecالاسمالمعنى
0x1CBLAUTHORالمؤلف (Reference)
0x1CCLCO-AUTHORالمؤلف المشارك
0x1CDLCREATED-ATوقت التأليف
0x1CELMODIFIED-ATوقت التعديل
0x1CFLRECORDED-BYالجهة المسجِّلة
0x1D0LRECORDED-ATوقت التسجيل
  • المادة المصدرية لا تُكتب بـ Meta بل بـ Edge الدليل SOURCE (Target 0) في HEAD، ونطاق النص الأصلي ووقت الحصول وتجزئة النص الأصلي تُكتب بـ QUALIFIER تُلحق بذلك SOURCE.

النسب

فئة النسب في Meta (Codec 0x1D1L~0x1DDL) تكتب مم جاء المستند وكيف. ويتبع النسب نموذج commit في git، والوحدة المقابلة لـ commit هي المستند.

  • تجزئة المحتوى تشير إلى محتوى نسخة واحدة من المستند (git commit id). وهي SHA-256 من السجل الفاتح (DOC-*) إلى ما قبل END مباشرة، وتُستثنى من الحساب سجلات فئة التحقق (C >= 5 في القسم 15، أي w >= 0x1E50).
  • معرّف الإصدار عدد صحيح من 2 WORD يُرقَّم من 1 بترتيب النشر داخل المستند ذي الاسم. و0 تعني أن الإصدار لم يُكتب.
  • يشير Meta النسب إلى الإصدار بتجزئة المحتوى. وPARENT داخل المستند يدخل في التجزئة أيضاً، فتصير تجزئة المحتوى سلسلة تجزئات تصل التاريخ كله.
  • لا يُحذف التاريخ. وما عُدّل يُصدر إصداراً جديداً. ولا يوضع في المستند مؤشر متغير مثل branch.
  • DELTA-BASE وDELTA-REMOVE صيغة لحفظ الإصدار بوصفه diff بالنسبة إلى إصدار أساس. ويُعرَّف الإصدار دائماً بوصفه snapshot.

قواعد التعديل في المستند.

يتبع النسب نموذج commit في git. والوحدة المقابلة لـ commit هي المستند.

Codecالاسمالمعنى
0x1D1LPARENTتجزئة محتوى الإصدار السابق مباشرة. وإذا تعدد فهو دمج
0x1D2LDERIVED-FROMمشتق من مادة في نسب آخر
0x1D3LGENERATED-BYالجهة المنتِجة (إنسان أو نموذج أو محرك قواعد)
0x1D4LTRANSFORMED-BYأداة التحويل وإصدار مصدرها (digest الـ commit)
0x1D5LCHERRY-PICKED-FROMالإصدار الأصلي للتغيير المأخوذ
0x1D6LREVERTSالإصدار الهدف الذي جرى التراجع عنه
0x1D7LREPLACESالإصدار الهدف الذي أُعيدت كتابته. ولا يُحذف الإصدار الأصلي
0x1D8LSQUASHED-FROMالإصدارات الأصلية التي دُمجت في واحد
0x1D9LMESSAGEسبب التغيير. واحد لكل لغة
0x1DALTAGاسم ثابت يُلحق بإصدار
0x1DBLDELTA-BASEهذا الملف diff بالنسبة إلى إصدار أساس
0x1DCLDELTA-REMOVEقائمة LOCAL ID التي تُحذف في الـ diff
0x1DDLNEXT-LOCAL-IDLOCAL ID التالي الذي سيُخصَّص. ويوضع في مستند قائمة الإصدارات
  • لا يُحذف التاريخ. وما عُدّل يُصدر إصداراً جديداً.
  • لا يوضع في المستند مؤشر متغير مثل branch. فالمستودع والفهرس يديرانه.

التحقق

فئة التحقق في Meta (Codec 0x1E5L~0x1E9L) تكتب مواد الحكم على إمكانية الوثوق بالمستند. وهي المفتاح العام لـ Issuer ذاتي الإصدار، والتوقيع، والإقرار بحق المساهمة، والموثوقية، ونتيجة الحكم على المستند كله.

  • تُستثنى فئة التحقق من حساب تجزئة المحتوى. ولذلك فوضع التوقيع داخل المستند، أو إضافة عدة توقيعات، لا يغيّر تجزئة المحتوى (بالطريقة نفسها لـ git gpgsig).
  • فئة التحقق هي السجلات التي C >= 5 في القسم 15، أي w >= 0x1E50، فيمكن حساب التجزئة دون codebook. والـ Reserved اللاحق 0x1EAL~0x1FFL للتحقق فقط فيُستثنى من التجزئة أيضاً.
  • الحكم على مستوى العقدة والسجل يتولاه Edge TOULMIN VERDICT (0x118L).
Codecالاسمالمعنى
0x1E5LISSUER-KEYخوارزمية التوقيع والمفتاح العام لـ Issuer ذاتي الإصدار
0x1E6LSIGNATUREتوقيع على تجزئة المحتوى. الخوارزمية والموقِّع والتوقيع
0x1E7LSIGNED-OFFإقرار بحق المساهمة
0x1E8LCONFIDENCEالموثوقية
0x1E9LVERDICTنتيجة الحكم على المستند كله (Pass وReview وFail)
  • تُستثنى فئة التحقق من حساب تجزئة المحتوى. ولذلك فوضع التوقيع داخل المستند، أو إضافة عدة توقيعات، لا يغيّر تجزئة المحتوى.

السياسة

فئة السياسة في Meta (Codec 0x1DEL~0x1E3L) تحدد كيف يُعامَل المستند: الترخيص ونطاق الإتاحة ودرجة الخصوصية وأجل الاحتفاظ والموافقة وقيود الاستخدام.

  • السياسة لا تغيّر التفسير بل تحدد طريقة التعامل.
  • يُسجَّل الترخيص الأصلي للمصنف داخل سلسلة البايتات بـ LICENSE.
Codecالاسمالمعنى
0x1DELLICENSEالترخيص
0x1DFLACCESSنطاق الإتاحة
0x1E0LPRIVACYدرجة الخصوصية
0x1E1LRETENTIONأجل الاحتفاظ
0x1E2LCONSENTنطاق الموافقة وأساسها
0x1E3LUSAGEقيود الاستخدام
  • السياسة لا تغيّر التفسير بل تحدد طريقة التعامل.

IMPORT

فئة IMPORT في Meta (Codec 0x1E4L) تستورد مستنداً خارجياً بـ IMPORT ID. والـ Codec هو IMPORT-DOC (0x1E4L) وحده.

  • يستورد IMPORT المستند فقط. أما الأهداف داخل المستند المستورَد فيُشار إليها في BODY بـ Reference EXTERNAL-POINTER-* (IMPORT ID، LOCAL ID) (Reference).
  • إذا كُتب معرّف الإصدار فالربط بتلك النسخة، وإذا كان 0 فالربط بأحدث نسخة وقت التفسير. والمستند المنشور يكتب الإصدار.
  • لا يُستورد HEAD للمستند المستورَد. ولا تُستورد سجلات Reference وValue بل تُنسخ.
TAG WORD          0001 1110 0100 LLLL      IMPORT-DOC (0x1E4L)
[Length TAG ممتد]
المستند           سجل DOC-POINTER (Issuer، معرّف المستند، معرّف الإصدار). ومستند Codec يستخدم CODEC-POINTER
IMPORT ID         الباقي. عدد صحيح بأقصر عرض
  • يُستخدم IMPORT-DOC (0x1E4L) وحده. يستورد IMPORT المستند فقط. أما الأهداف داخل المستند المستورَد فيُشار إليها في BODY بـ EXTERNAL-POINTER-* (IMPORT ID، LOCAL ID).
  • إذا كُتب معرّف الإصدار فالربط بتلك النسخة، وإذا كان 0 فالربط بأحدث نسخة وقت التفسير. والمستند المنشور يكتب الإصدار.
  • لا يُعيَّن IMPORT ID نفسه مرتين في مستند واحد.
  • لا يُستورد HEAD للمستند المستورَد. وتُفسَّر أهداف ذلك المستند وفق تصريحاته هو.

مثال: استيراد أحدث إصدار من المستند 0x0000000000000002 لدى Issuer 0x00000002 بـ IMPORT ID 1.

1E4A 0418 0000 0002 0000 0000 0000 0002 0000 0000 0001