ПунктЗначение
ИмяDESCRIPTION (BIND документа спецификации DESCRIPTION)
TAG ID0x0A6L
Codec ID0x00000A60
Документ спецификации0x00000000/codecs/0x00000A60/ (цель DECLARE 0A60)
Раздел5 0101 (Edge-высказывание), смещение C внутри раздела = 6
KindEdge · семейство: высказывание, группа: указание и имя
TAG WORD0000 1010 0110 LLLL (000K KKKC CCCC LLLL)
Описание в индексеСвязывает Subject с описанием (description) на конкретном языке. Раскладка та же, что у LABEL
Сторона Hugoedge/description.md

Поля (документ спецификации)

Порядок FIELD в документе — это порядок полей Payload (документ спецификации Codec). Edge Id у Edge не объявляется через FIELD.

ПорядокПоле (BIND)FIELDШиринаПринимаемый формат (CODEC)ENUM
1subject#2записьлюбая запись (кроме маркера места)
2object#3запись0780 UTF8-LANGUAGE-TEXT, 0790 UTF8-LANGUAGE-TEXT, 0050 LOCAL

DESCRIPTION — Edge-высказывание, связывающий с Subject через Object одно описание объекта на конкретном языке. Codec 0x0A6L.

Описание — короткая фраза, отличающая объект от других (description в Wikidata, например «столица и крупнейший город Германии»). Это не определение объекта и не утверждение. Предложение об объекте записывается как TRIPLE. Раскладка та же, что у LABEL. Описание и его язык хранятся в одном Object — UTF8-LANGUAGE-TEXT. Поля простого значения нет.

Раскладка

TAG WORD          0000 1010 0110 LLLL
[Length, расширяющий TAG]
Edge Id           запись LOCAL Reference
Subject           1 запись Reference
Object            1 Value UTF8-LANGUAGE-TEXT или запись LOCAL Reference

Интерпретация и действительность

  • Правила для Subject и Object те же, что у LABEL. Subject — ровно одна полная запись Reference. Object — либо ровно одна полная запись UTF8-LANGUAGE-TEXT (0x078L·0x079L), либо LOCAL Reference, разрешающаяся в UTF8-LANGUAGE-TEXT привязкой REFERENCE-NODE в том же документе.
  • Текст без языка (UTF8-TEXT) DESCRIPTION быть не может. Описание одно на язык, поэтому это правило действует только при наличии языка. Описание, общее для нескольких языков, записывается с языком mul.
  • DESCRIPTION с одним Subject и языком — не более одного.
  • Описание служит для отличия от другого объекта с тем же именем. Желательно, чтобы пара LABEL и DESCRIPTION на одном языке не совпадала у двух объектов, но спецификация этого не проверяет (Wikidata тоже лишь рекомендует, но не принуждает).
  • Документы спецификации geul.org ограничивают Object через CODEC (0780·0790·0050, как у LABEL).

Длина

всего = 1 + N_len + N_id + N_subject + N_object WORD
  • Запись языка и число байтов текста в Object ведёт запись Object. Курсор после чтения последней записи должен точно совпасть с концом Edge.
  • Описание длиннее метки, поэтому и Object, и Edge легко превышают 15 WORD. Тогда используется расширение Length (запись).

Пример (не нормативно)

Edge Id 0009, Subject Q64 (0141 0040), Object capital and largest city of Germany (en). Язык — пример формата LANGUAGE-BCP47-CODE (для en есть номер реестра 0x0784, поэтому можно использовать и SHORT-CODE).

  • Object: язык 0761 656E (BCP47 en, 2 WORD) + 35 байт текста (нечётное число, 18 WORD), поэтому 0x079L, TAG 1 + расширяющий TAG 1 + 20 = 22 WORD, 079E 0016 ….
  • Edge — TAG 1 + расширяющий TAG 1 + Edge Id 2 + Subject 2 + Object 22 = 28 WORD, поэтому LLLL=1110, TAG 0A6E, расширяющий TAG 001C.
0A6E 001C 0051 0009 0141 0040
079E 0016 0761 656E 6361 7069 7461 6C20 616E 6420 6C61 7267 6573 7420 6369 7479 206F 6620 4765 726D 616E 7900

Соответствие Wikidata

  • descriptions элемента (по одному на язык) → по одному DESCRIPTION на язык. Код языка переносится по той же таблице соответствия кодов языков, что и для LABEL.

Открытые проблемы

  • Есть ли случаи, в которых стоит допустить описание в виде UTF8-TEXT без языка (сейчас не допускается).

Связанные страницы

Исходный текст документа спецификации

Документ спецификации 0x00000000/codecs/0x00000A60/latest.geul, прочитанный через geul show (16-ричные цифры в верхнем регистре).

SPEC-VERSION 0x0001
DOC-ID 0x04260000000000000A6000000000
BODY
#1 DECLARE 0x0A60
#2 FIELD #1 record
#3 FIELD #1 record
#4 BIND #1 "DESCRIPTION"
#5 BIND #2 "subject"
#6 BIND #3 "object"
#7 CODEC #3 0x0780
#8 CODEC #3 0x0790
#9 CODEC #3 0x0050