openfv

Открыть спецификацию версии шрифта

Версия 0.3.0

Статус: экспериментальный, нестабильный черновик

Оглавление

• Введение и обоснование
• Определения
• Спецификация OpenFV
  • идентификатор таблицы имени 5 Спецификация записи
  • Спецификация записей FONTREVISION FONTREVISION
  • Номер версии Семантика
• Примеры
  • идентификатор таблицы имени 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 ). Проекты, которые создают составленные бинарные артефакты из исходного кода, часто связывают этикетку с артефактом сборки, чтобы установить запись состояния исходного кода во время сборки (например, строка HASH Commit Commit SHA1).

Эти концепции управления версиями применимы к разработке программного обеспечения для шрифтов и желательны в процессе разработки; Тем не менее, они не все определены в соответствии с спецификацией версии шрифта Opentype. Строки версии программного обеспечения шрифта скомпилированы в запись 5. Эти записи определены в спецификации формата Opentype, как показано ниже, и объясняются в документации «Лучшие практики разработки шрифта» (источник).

Имя OpenType идентификатор таблицы 5 Определение записи

Версия строка. Должен начать с синтаксиса «версия». (Верхний корпус, нижний чехол или смешанный, с пространством между «версией» и числом).

Строка должна содержать номер версии следующей формы: одна или несколько цифр (0-9) значения менее 65 535, а затем период, за которым следует одна или более цифры стоимости менее 65 535. Любой символ, кроме цифры, прекратит незначительное число. Персонаж, такой как «». полезен, чтобы разделить различные части информации версии.

Первое такое совпадение в строке может использоваться программным обеспечением для установки для сравнения версий Font. Обратите внимание, что некоторые установщики могут потребовать, чтобы строка запустилась с «версии», а затем номер версии, как указано выше.

(Источник)

Опенсипная таблица Head Table Определение записи

Установлен производителем шрифтов

(Источник)

Спецификация Opentype определяет номер версии как MAJOR.MINOR . Не существует спецификации для номера версии PATCH / BUILD , ни номера версии метаданных метаданных. Управление версиями шрифтов отклоняется от формата номера версий Semver в результате соглашения компилятора шрифта, включающего нулевое прокладку в MINOR номера версий. Хотя это не всегда так, как в записях nameid 5, это последовательный формат, используемый в записи головы. Интерпретация номеров версий с этим подходом не является интуитивной. Строки номера версии Version 1.1 , Version 1.01 и Version 1.001 все определяются как «разные», хотя все эти цифры могут представлять одну и ту же стадию разработки (т.е. одна итерация за пределами первого основного выпуска). Эти различия в номерах версий возникают из -за конвенций, установленных автором проектов и инструментами, которые они используют для компиляции шрифтов из их исходного кода. Определения OpenType не указывают формат, чтобы указать состояние разработки проекта шрифта относительно его вехи версии, а также не определяют подход для поддержания информации о состоянии исходного кода во время сборки в артефакте сборки шрифта. Отсутствие официального стандарта для решения вышеуказанных проблем обеспечило стимул для этой спецификации.

Спецификация Open Font версии (OpenFV) представляет собой совместимое расширение имен имени OpenType имени 5 Запись и спецификации opentype Head.fontRevision. OpenFV предназначен для того, чтобы служить стандартом управления программным обеспечением для шрифта для разработки, тестирования, выпуска и использования исходного кода шрифта и артефактов сборки (шрифтов), полученных из источника. Эта спецификация определяет синтаксис строки номера версии с семантическими основаниями, которые содержат информативные данные как для разработчиков, так и для пользователей.

Определения

• BUILD - Скомпилированный файл любого типа артефакта сборки шрифта, который определяется состоянием исходного кода во время сборки (то есть двоичный файл шрифта)
• Разработка - исходный код и составное состояние артефакта сборки, которое включает в себя неполную реализацию работ для достижения вехи выпуска
• Метаданные - данные, которые выходят за рамки определения openfv номера версии
• Позиция первая - первая позиция подстроения строки версии
• Вторая позиция - вторая позиция подстроения строки версии
• Выпуск - исходный код и скомпилированное артефакт -артефакт State State Milestone, предназначенный для использования уровня производства, конечным пользователем
• Статус - двоичный индикатор состояния разработки/выпуска исходного кода
• Состояние - показатель состояния исходного кода во время сборки

Ключевые слова «должны», «не должны», «обязательно», «должны», «не должны», «не должны», «не должны», «рекомендуется», «может» и «необязательно» в этом документе должны интерпретироваться, как описано в RFC 2119.

Спецификация OpenFV

1. Идентификационный идентификатор таблицы таблицы 5 Строка версии записи

а Версия строка Синтаксиса

Строки версий в идентификационном идентификаторе таблицы Opentype 5 должны быть определены как полуколонные подборы обязательных и дополнительных элементов данных.

Синтаксис спецификации OpenFV для элементов подстроки строки полной версии:

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

Строка версии шрифтов должна включать:

• Подстроение номера версии шрифта

Строка версии шрифтов может включать в себя:

• Статус/штат Метаданная подстрока
• Другие подстроки метаданных

беременный Подстроение номера версии шрифта

Подстроение номера версии шрифта:

• Должен быть расположен в подстроении.
• Должен быть определен как капитализированное слово «версия», космический глиф (U+0020), MAJOR цифры номера версии, период (U+002E), MINOR цифры номера версии.
• Не должен включать метаданные.
• Может включать в себя полуколон в его окончательной позиции символа, если метаданные следуют за подстроением номера версии шрифта на второй позиции подстроки. Материалы пробелов не должны быть включены между MINOR номером версии и полуколоном.
• Не должен включать полуколон, если нет метаданных после подстроения номера версии.

MAJOR номер версии:

• Должен иметь от одного до трех цифр с минимальным значением 0 и максимальным значением 999.

НОМЕР MINOR :

• Должен иметь ровно три цифры. Для чисел менее 100, нулевая прокладка должна использоваться в номере MINOR версии. MINOR номер версии должен иметь минимальное значение 000 и максимальное значение 999.

в Государственная метаданная подстроение

Государственная подстроение метаданных:

• Должен определить состояние исходного кода во время сборки шрифта.
• необязательно.
• Должен быть расположен в подстроении.
• Не должен включать символы за пределами набора: a-zA-Z0-9._-
• Должен включать разделитель [ как начальный символ и разделитель ] в качестве конечного характера подстроения. Содержимое строки внутри этих разделителей должно быть определено как «метка состояния». Штативная этикетка должна составлять 50 символов или меньше.
• Может включать подстроение состояния (см. Ниже).

дюймовый Статусная метаданная подстроение

Подстроение метаданных статуса:

• Должен определить статус бинарной разработки/выпуска исходного кода и сборки шрифта, как определено в разделе «Определения».
• необязательно.
• Должен быть расположен в подстроении второй.
• Должен использовать один из следующих чувствительных к случаям форматов с нулевым или одним предыдущим космическим символом для строк версий, которые не включают в себя подстроение состояния:
  • DEV
  • RELEASE
• Необходимо использовать один из следующих чувствительных к случаям форматов без предшествующих космических символов для строк версий, которые включают в себя подстроение состояния:
  • -dev
  • -release

эн. Другие подстроки метаданных

Другие подстроки метаданных:

• необязательны.
• Может быть включен один или несколько раз в строку версии шрифта
• Должен следовать всем данным подстроки номера версии и подборов состояния/состояния с помощью полуколонного разделителя, за которым следует нулевой или один космический символ, предшествующий подстроению метаданных друг друга.
• Должно быть ограничено 50 символами или меньше.

2. Головная таблица Fontrevision rescord strers string string

Номер версии шрифта в записи FONTREVISION The OpenType Head Table:

• Должен быть определен как 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 FONTREVISION, которые соответствуют спецификации OpenFV, включают:

 1.001

 10.010

 100.100

Лицензия

CC на 4,0