openfv

افتح مواصفات إصدار الخط

الإصدار 0.3.0

الحالة: مسودة تجريبية غير مستقرة

جدول المحتويات

• مقدمة والأساس المنطقي
• التعريفات
• مواصفات OpenFV
  • معرف جدول الاسم 5 مواصفات السجل
  • تحديد جدول جدول المواصفات
  • رقم الإصدار دلالات
• أمثلة
  • معرف جدول الاسم 5 أمثلة تسجيل
  • أمثلة تسجيل طاولة الرأس fontrevision
• رخصة

مقدمة والأساس المنطقي

تتضمن سلاسل إصدار البرنامج عادة الدلالات التالية:

• يتغير الحجم والتوافق المتخلف عن رمز المصدر بالنسبة إلى الإصدار الأخير
• استعداد الكود المصدري لإصدار مستوى الإنتاج للمستخدمين النهائيين
• حالة رمز المصدر في وقت البناء

يستخدم نهج SEMVER المنشأة والاستخدام على نطاق واسع لإصدار البرنامج الدلالي تنسيق رقم الإصدار MAJOR.MINOR.PATCH مع معيار يستند إلى API للبرامج للقيم المتزايدة أثناء عملية تطوير البرمجيات. عادة ما يتم إلحاق البيانات الوصفية الإضافية ببناء بناء الجملة Semver هذا للإشارة إلى استعداد البرنامج للاستخدام العام من قبل المستخدم النهائي مع تقدم العمل نحو معلم الإصدار (على سبيل المثال v1.2.0-alpha ، v1.2.0-beta ، v1.2.0-rc.1 ، v1.2.0-rc.2 ، v1.2.0 ). تربط المشاريع التي تنشئ قطعًا ثنائية تم تجميعها من رمز المصدر بشكل متكرر مع Art Artifact لإنشاء سجل لحالة الكود المصدر في وقت الإنشاء (على سبيل المثال ، سلسلة تجزئة GIT SHA1).

تنطبق مفاهيم الإصدار هذه على تطوير برنامج المحرف ومرغوب فيه أثناء عملية التطوير ؛ ومع ذلك ، فهي ليست محددة جميعها ضمن مواصفات الإصدار Opentype Font. يتم تجميع سلاسل إصدار برنامج المحرف في سجل NameID 5 لجدول اسم Opentype وسجل FontRevision لجدول رأس Opentype. يتم تعريف هذه السجلات في مواصفات تنسيق OpenType على النحو التالي ، وشرحها في وثائق أفضل الممارسات لتطوير الخط (المصدر).

OPENTYPE اسم جدول المعرف 5 تعريف السجل

سلسلة الإصدار. يجب أن تبدأ مع بناء الجملة ". (الحالة العليا ، العلبة السفلية ، أو المختلطة ، مع مساحة بين "الإصدار" والرقم).

يجب أن تحتوي السلسلة على رقم إصدار من النموذج التالي: رقم واحد أو أكثر (0-9) من القيمة أقل من 65،535 ، تليها فترة ، تليها رقم واحد أو أكثر من القيمة أقل من 65،535. أي حرف آخر غير الرقم سوف ينهي الرقم الثانوي. شخصية مثل "؛" مفيد لفصل أجزاء مختلفة من معلومات الإصدار.

يمكن استخدام أول مطابقة في السلسلة بواسطة برنامج التثبيت لمقارنة إصدارات الخط. لاحظ أن بعض المثبتات قد تتطلب من السلسلة أن تبدأ بـ "الإصدار" ، متبوعًا برقم الإصدار على النحو الوارد أعلاه.

(مصدر)

Opentype Head Table تعريف سجل Fontrevision

حددها الشركة المصنعة للخطوط

(مصدر)

تحدد مواصفات Opentype رقم الإصدار على أنه MAJOR.MINOR . لا توجد مواصفات لرقم إصدار PATCH / BUILD أو سلاسل بيانات رقم الإصدار. ينحرف إصدار FONT من تنسيق رقم إصدار SEMVER نتيجة لاتفاقية برنامج التحويل البرمجي FONT لتضمين حشوة صفرية في أرقام الإصدار MINOR . على الرغم من أن هذا ليس هو الحال دائمًا في سجلات NameID 5 ، إلا أن هذا تنسيق ثابت يستخدم في سجل Head.FontRevision. تفسير أرقام الإصدار مع هذا النهج ليس بديهيًا. يتم تعريف كل من Number Number Strings Version 1.1 Version 1.01 والإصدار Version 1.001 على أنه "مختلف" على الرغم من أن هذه الأرقام قد تمثل جميعها نفس المرحلة من التطوير (أي تكرار واحد يتجاوز الإصدار الرئيسي الأول). تظهر هذه الاختلافات في أرقام الإصدار بسبب الاتفاقيات التي أنشأها مؤلف (مؤلفين) للمشروع والأدوات التي يستخدمونها لتجميع الخطوط من رمز المصدر. لا تحدد تعريفات OpenType تنسيقًا للإشارة إلى حالة تطوير مشروع محرف بالنسبة إلى معلم الإصدار ، ولا تحدد نهجًا للحفاظ على معلومات حول حالة الكود المصدر في وقت الإنشاء داخل Art Font Build Art. عدم وجود معيار رسمي لمعالجة المشكلات المذكورة أعلاه قدمت الزخم لهذا المواصفات.

تمثل مواصفات إصدار FONT OPEN (OPENFV) امتدادًا متوافقًا لسجل جدول Opentype NameID 5 و OPENTYPE HEAD.FONTREVISION. يهدف OpenFV إلى العمل كمعيار لإصدار برنامج محرف لتطوير واختبار وإصدار واستخدام رمز مصدر المحرف والتحف (FONTs) المستمدة من المصدر. تحدد هذه المواصفات بناء جملة سلسلة رقم الإصدار مع الأسس الدلالية التي تحافظ على بيانات مفيدة لكل من المطورين والمستخدمين.

التعريفات

• Build - ملف مجمع لأي نوع من نوع Artfact Artifact تم تعريفه بواسطة حالة الكود المصدر في وقت الإنشاء (أي ملف ثنائي الخط)
• التنمية - رمز المصدر وحالة القطع الأثرية المترجمة التي تتضمن تنفيذ العمل غير المكتمل لتحقيق علامة فارقة الإصدار
• البيانات الوصفية - البيانات التي تقع خارج تعريف OpenFV لسلسلة رقم الإصدار
• الموضع الأول - أول موضع فرعي لسلسلة الإصدار
• الموضع الثاني - الموضع الفرعي الثاني لسلسلة الإصدار
• الإصدار - رمز المصدر وتجميع البناء معلم حالة القطع الأثرية المخصصة لاستخدام مستوى الإنتاج من قبل المستخدم النهائي
• الحالة - مؤشر ثنائي لتطوير/حالة إصدار رمز المصدر
• الدولة - مؤشر لحالة كود المصدر في وقت البناء

الكلمات الرئيسية "يجب" ، "يجب ألا" ، "مطلوبة" ، "يجب" ، "يجب ألا" ، "ينبغي" ، "لا ينبغي" ، "الموصى بها" ، "مايو" ، و "اختيارية" في هذا المستند كما هو موضح في RFC 2119.

مواصفات OpenFV

1. معرف جدول المعرف 5 سلسلة إصدار سجل

أ. إصدار بناء جملة سلسلة

يجب تعريف سلاسل الإصدار في سجل جدول OpenType معرف 5 على أنه فرعية محددة من عناصر البيانات الإلزامية والاختيارية.

بناء جملة مواصفات OpenFV للعناصر الفرعية لسلسلة الإصدار الكامل هي:

 [Font Version Number]; [Status/State Metadata]; [Other Metadata]

يجب أن تتضمن سلسلة إصدار الخط:

• رقم إصدار الخط

قد تتضمن سلسلة إصدار الخط:

• الحالة/البيانات الوصفية للدولة
• بيانات التعريف الأخرى

ب. رقم إصدار الخط

ترتيب رقم إصدار الخط:

• يجب أن تكون موجودة في Sundring Position One.
• يجب تعريفها على أنها كلمة "الإصدار" ذات الرسملة ، وفضاء الفضاء (U+0020) ، وأرقام (أرقام) رقم الإصدار MAJOR ، وفترة (U+002E) ، وأرقام رقم الإصدار MINOR .
• يجب ألا تشمل البيانات الوصفية.
• قد تتضمن فاصلة فاصلة في موضع الطابع النهائي إذا اتبع البيانات الوصفية رقم إصدار الخط في الموضع الفرعي الثاني. لا ينبغي تضمين أحرف المسافة البيضاء بين رقم الإصدار MINOR و Semicolon.
• لا يجب أن تتضمن فاصلة فاصلة إذا لم يكن هناك بيانات تعريف باتباع رقم الإصدار.

رقم الإصدار MAJOR :

• يجب أن يكون بين رقم وثلاثة أرقام مع الحد الأدنى قيمة 0 وقيمة الحد الأقصى 999.

رقم الإصدار MINOR :

• يجب أن يكون بالضبط ثلاثة أرقام. بالنسبة للأرقام أقل من 100 ، يجب استخدام حشوة صفر في رقم الإصدار MINOR . يجب أن يكون لرقم الإصدار MINOR قيمة لا تقل عن 000 وقيمة أقصى قدرها 999.

ج. الدولة البيانات الوصفية

سلسلة بيانات البيانات الوصفية:

• يجب تحديد حالة رمز المصدر في وقت بناء الخط.
• اختياري.
• يجب أن يكون موجودًا في Sundring Position اثنين من سلسلة إصدار الخط.
• يجب ألا تتضمن أحرفًا خارج المجموعة: a-zA-Z0-9._-
• يجب أن تشمل تحديد المحدد [ كحرف أولي ومحدد ] باعتباره الحرف النهائي للسلسلة الفرعية. يجب تعريف محتويات السلسلة داخل هذه المحددات على أنها "ملصق الحالة". يجب أن تكون ملصق الدولة 50 حرفًا أو أقل.
• قد تشمل فرعية الحالة (انظر أدناه).

د. حالة البيانات الوصفية

سلسلة بيانات الوصفية:

• يجب أن تحدد حالة التطوير الثنائي/إصدار رمز المصدر وبناء الخط على النحو المحدد في قسم التعاريف.
• اختياري.
• يجب أن تكون موجودة في المركز الفرعي الثاني.
• يجب استخدام أحد التنسيقات الحساسة للحالة التالية مع صفر أو أحرف فضاء مسبقة واحدة لسلاسل الإصدار التي لا تتضمن فرعية للدولة:
  • DEV
  • RELEASE
• يجب استخدام أحد التنسيقات الحساسة للحالة التالية دون مسبقة أحرف الفضاء لسلاسل الإصدار التي تتضمن فرعية للدولة:
  • -dev
  • -release

ه. بيانات التعريف الأخرى

سلاسل البيانات الوصفية الأخرى:

• اختيارية.
• قد يتم تضمين مرة واحدة أو أكثر في سلسلة إصدار الخط
• يجب اتباع جميع البيانات الفرعية لأرقام الإصدار وبيانات السلسلة الفرعية للدولة/الحالة مع محدد فاصلة فاصلة تليها صفر أو حرف واحد يسبق بعضها البعض.
• يجب أن يقتصر على 50 حرفًا أو أقل.

2. جدول تسجيل جدول سجل FONTREVISION

رقم إصدار الخط في سجل Fontrevision لجدول رأس Opentype:

• يجب تعريفها على أنها أرقام (أرقام) رقم الإصدار MAJOR ، وفترة ، وأرقام رقم الإصدار MINOR
• يجب أن يكون لديك رقم إصدار رئيسي يتراوح بين رقم وثلاثة أرقام في الطول مع الحد الأدنى لقيمة 0 وقيمة أقصى قدرها 999.
• يجب أن يكون لديك رقم إصدار MINOR هو بالضبط ثلاثة أرقام في الطول. لأرقام الإصدار MINOR أقل من 100 ، يجب استخدام حشوة صفر. يجب أن يكون لرقم الإصدار MINOR قيمة لا تقل عن 000 وقيمة أقصى قدرها 999.
• يجب ألا تتضمن أي أحرف قبل رقم الإصدار MAJOR ولا بعد رقم الإصدار MINOR

3.

• يهدف رقم الإصدار MAJOR.MINOR إلى تمثيل معلم الإصدار الذي قد يتم تنفيذه بشكل غير كامل في المصدر الذي يتم تعريفه برقم إصدار MAJOR.MINOR . لا يهدف رقم الإصدار MAJOR.MINOR إلى تمثيل حالة الكود المصدر في وقت الإنشاء في القطع الأثرية وقد لا يكون فريدًا عبر القطع الأثرية لأن العمل يتم تنفيذه لتحقيق علامة فارقة في الإصدار MAJOR.MINOR .
• يجب تمييز حالة مصدر التطوير عن حالة مصدر الإصدار من خلال استخدام سلسلة البيانات الوصفية على النحو المحدد في هذه المواصفات.
• يجب تعيين رقم الإصدار MAJOR على 0 خلال مرحلة التطوير قبل الإنتاج قبل الإصدار الأولي. يجب أن يشير رقم الإصدار MAJOR 0 إلى مرحلة التطوير قبل الإنتاج هذه.
• يجب تعيين رقم الإصدار MAJOR على 1 وقت الإصدار الأولي للمستخدمين النهائيين. يجب أن يشير التحويل من رقم الإصدار MAJOR 0 إلى الإصدار MAJOR 1 إلى إقرار المؤلفين بأن التعليمات البرمجية المصدر وإنشاء القطع الأثرية تلبي تعريف إصدار OpenFV.
• عند الانتهاء من تغييرات الكود المصدري لتحقيق علامة فارقة الإصدار ، يجب إجراء زيادة رقم الإصدار مباشرة قبل إجراء تغييرات على التعليمات البرمجية المصدرية التي يتم تحديدها لمعلم الإصدار المستقبلي.

يجب أن تتضمن الدلالات الخاصة بالتغييرات في رقم الإصدار زيادة بقيمة 1 من:

• رقم الإصدار MAJOR لاستكمال المعالم الرئيسية الخاصة بالمشروع وجميع التغييرات غير المتوافقة مع الخلف التي تم إجراؤها على برنامج المحرف (على سبيل المثال ، التخلص من الدعم لنطاق رمز Unicode بأكمله).
• رقم الإصدار MINOR للوظائف ، والإصلاح الساخن ، وتغييرات التبعية. تشمل الأمثلة:
  • تغييرات تصميم الرحم
  • إضافة/القضاء/تعديل مجموعات التلميح/التعليمات
  • إضافة/إزالة الحروف الرسومية
  • إصلاحات عيب التصميم
  • التغييرات في بناء العمليات
  • تحديث تبعيات البناء

عندما يتم زيادة رقم الإصدار MAJOR ، يجب تغيير رقم الإصدار MINOR إلى قيمة 000.

أمثلة

سجل معرف الجدول 5

أمثلة على معرف الجدول المعرف 5 سلاسل إصدار سجل تلبي مواصفات OpenFV تتضمن:

رقم الإصدار فقط

 Version 1.001

رقم الإصدار وتسمية حالة التطوير

 Version 1.001; DEV
Version 1.001; RELEASE

رقم الإصدار وتسمية حالة رمز المصدر

 Version 1.001; [abcd123]

رقم الإصدار ، تسمية حالة رمز المصدر ، وعلامة حالة التطوير

 Version 1.001; [abcd123]-dev
Version 1.001; [abcd123]-release

رقم الإصدار ، تسمية حالة الكود المصدر ، تسمية حالة التطوير ، والبيانات الوصفية الأخرى

 Version 1.001; [abcd123]-dev; here are metadata
Version 1.001; [abcd123]-release; here are metadata

رقم الإصدار والبيانات الوصفية الأخرى

 Version 1.001; here are metadata
Version 1.001; here are metadata; here are more metadata

سجل طاولة الرأس fontrevision

تتضمن أمثلة على الجدول الرئيسي سلاسل إصدار سجل Fontrevision التي تلبي مواصفات OpenFV:

 1.001

 10.010

 100.100

رخصة

CC بحلول 4.0