GEUL (General Encoding Unified Language) — искусственный язык и двоичный формат, позволяющий людям и ИИ обмениваться данными без неоднозначности.

Эти документы определяют грамматику GEUL v1. Текущая редакция — черновик до публикации и может измениться. Спецификация открыта по лицензии CC0 1.0.

Обзор

  • Все данные — последовательность 16-битных слов (WORD). Запись ведётся в порядке big-endian.
  • Единица данных — запись. Запись начинается с одного TAG WORD, и этот TAG WORD задаёт вид и длину записи.
  • Записи бывают четырёх видов (Kind).
KindНазначениеПример
ReferenceУказывает на объектQ42 Викиданных, #7 внутри этого документа
ValueХранит само значениедата, количество, текст с указанием языка
EdgeСвязывает другие записи и высказывает утверждение«Q42 — человек», «английское имя Q42 — Douglas Adams»
MetaГоворит о самом документередакция спецификации, ID документа, автор, подпись
  • Записи собраны в один документ. Как и HTML, документ делится на HEAD (Meta, а также источник всего документа SOURCE и его QUALIFIER) и BODY (Reference, Value, Edge).
  • Документ выпускает Issuer (выпускающий субъект), а каждая версия фиксируется хешем содержимого. Опубликованная версия не меняется.

Принципы проектирования

  1. Пропуск возможен без кодовой книги. Вид и длина записи заключены в 16 битах TAG WORD. Декодер, не знающий способа интерпретации (кодовой книги), всё равно может подсчитать записи и пропустить их.
  2. Хранится высказывание, а не факт. Документ фиксирует вместе с Meta и Edge основания, кто, когда и из чего это высказал.
  3. Идентификация — через Reference. Объект указывается по ID, а не по имени. Имя присоединяется через Edge.
  4. Опубликованное не меняется. Исправления выходят в новой версии. ID внутри документа указывает на один и тот же объект во всех версиях.
  5. Пространство оставляется свободным. Большая часть битового пространства оставлена на будущее. Прямые коды нельзя отозвать, поэтому назначаются только те, чья частота использования подтверждена.

Подчинённые документы

Если вы читаете впервые, читайте по таблице сверху вниз.

ДокументСодержание
Структура записираскладка TAG WORD, Length, Codec, расширяющий TAG
Issuer и публикацияуровни Issuer, таблица назначения 2 WORD, способ раскрытия, подпись, ключ проверки
Адрес публикации и список версийзапись ID, адрес публикации, указание формата, список Issuer, список версий, уровни доверия
Документ спецификации Codecкодовая книга, записываемая через DECLARE, FIELD, ENUM, CODEC
Общий документDOC, HEAD, BODY, END, ID документа, хеш содержимого, версия и редакция
Индекс кодоввсе 227 назначенных ячеек, таблицы Codec по Kind и семействам
Раскладка разделов16 разделов и размещение ячеек, назначенные и Reserved-диапазоны
Маркер местаABSENT, UNKNOWN-VALUE, NO-VALUE, правила приёма
Referenceидентификация объекта, LOCAL, внешние ссылки, Quantifier, маркеры места
Valueсемейства значений, прямые коды, текст, количество, дата
Metaструктура, объявление, происхождение, родословная, проверка, политика, IMPORT
Edgeсемейства высказываний, оснований, исполнения и TOULMIN, TRIPLE, QUALIFIER, LABEL
TOULMINсемейство графов вердиктов и исполнения, раскладки NODE, LINK, SOURCE
Пример: элемент Викиданныхчтение одного документа пословно

Что известно без кодовой книги

ИнформацияБез кодовой книгиОснование
Kindизвестнодиапазон раздела w >> 9 в TAG WORD (Reference 0–2, Value 3 и 4, Edge 5–13, Meta 14 и 15)
Полная длина записи, положение следующей записиизвестноLength в TAG WORD
Номер CodecизвестноTAG WORD (в формате Issuer — Issuer и номер Codec из расширяющего TAG)
Семейство, классчастично известноПо битам известно только семейство прямых кодов Edge. Прямые коды Value, семейство формата Issuer и класс Meta по битам неизвестны. В формате Issuer известны Issuer и номер Codec. Класс проверки Meta определяется по C >= 5 раздела 15 (w >= 0x1E50)
Edge Id у Edgeизвестнопервый компонент Edge (разделы 5–13) — всегда LOCAL Reference
Маркер места (не записано, неизвестно, отсутствует)известнозначение WORD 0x0000, 0x0010, 0x0020 (Reference, C < 3, L 0). См. Маркер места
Quantifierизвестносмещение C внутри раздела: для раздела 0 при 5 <= C < 30, для раздела 1 при C < 30 это C % 5
Длина TAG по Codec, начало Payloadнеизвестнокодовая книга
Интерпретация Payload, роли компонентов Edgeнеизвестнокодовая книга
  • Декодер без кодовой книги может, пропуская записи, считать их по Kind и Codec, но не может проследовать по структуре графа.
  • Все декодеры обязаны обрабатывать классы Meta: структуру, объявление и IMPORT. Эти Codec входят в базовую кодовую книгу GEUL, и декодер знает их по встроенной таблице номеров (Meta).

Кодовая книга публикуется как документ GEUL (Документ спецификации Codec). Поэтому декодеру достаточно получить и прочитать нужный документ спецификации.

Структура областей

Старшие биты TAG WORD делят пространство на области.

PrefixОбластьДоляОпределение
1далёкое будущее50%Reserved (далёкое будущее). Не используется
01будущее25%Reserved (ближайшее будущее). Не используется
001стандарт12.5%грамматика, официально принятая и применяемая
000свободная и предлагаемая12.5%текущая грамматика. При принятии раскладка сохраняется, меняется только Prefix на 001

Вся текущая грамматика находится в области 000. Все TAG WORD этой спецификации начинаются с 000.

  • Декодер v1 отклоняет TAG WORD, у которого Prefix не 000. Остальные области определит более поздняя редакция.
  • Область 000 — пространство предложений. Сейчас регистрация и защита к ней не применяются.