Grammar

文档

GEUL 数据的单位是一个文档(DOC)。

DOC-POINTER (0x041L)

DOC-POINTER 是指向 Issuer 所公布文档某一版本的指示声明 Reference。

CODEC-POINTER (0x042L)

CODEC-POINTER 是指向 Issuer 所公布 Codec 文档某一版本的指示声明 Reference。

章节布局

规定 TAG WORD 高 4 位的 16 个章节和章节内 5 位偏移的 32 格的布局,表中没有的格为 Reserved。

占位标记

占位标记(slot marker)是填充记录字段位置的 1 WORD 记录。

Reference

Reference 是指向对象的记录。

BOOL (0x060L)

BOOL 是表示逻辑值 false 和 true 的 Value。

COORDINATE-EARTH (0x064L)

COORDINATE-EARTH 是以纬度、经度和不确定度表示地球上一点的坐标 Value。

Value

Value 是承载值本身的记录。

COORDINATE-GEO (0x065L)

COORDINATE-GEO 是以纬度、经度和不确定度表示指定天体(行星、卫星、小行星等)上一点的坐标 Value。

QUANTITY (0x066L)

QUANTITY 是以数值、单位、下限·上限表示一个数量的 Value。

FRACTION (0x067L)

FRACTION 是按原文书写形式原样表示分数的 Value。

SIGNED-DECIMAL (0x068L)

SIGNED-DECIMAL 是带有符号 coefficient 的精确十进制数(exact decimal)Value。

UNSIGNED-DECIMAL (0x069L)

UNSIGNED-DECIMAL 是带有无符号 coefficient 的精确十进制数(exact decimal)Value。

GREGORIAN-DATE (0x06AL)

GREGORIAN-DATE 是以 proleptic Gregorian 1970-01-01 为 day 0 的 signed 日期数。

EDTF (0x06EL·0x06FL)

EDTF 是以 ISO 8601-2 扩展日期字符串承载年·月精度、公元前、不确定、区间等日期的 Value(Codec 0x06EL/0x06FL)。

Meta

Meta 不是关于世界的内容,而是关于文档的记录。

GEDCOM-DATE (0x070L·0x071L)

GEDCOM-DATE 是 GEDCOM 7 日期值字符串,按书写原样保存儒略历等其他历法的日期的 Value(Codec 0x070L/0x071L)。

URI (0x074L·0x075L)

URI 是承载符合 RFC 3986 URI(含 scheme 的绝对 URI)语法的 ASCII 字节序列的 Value。

Edge

Edge 是把其他记录作为组成部分绑在一起进行陈述的记录。

UTF8-LANGUAGE-TEXT (0x078L·0x079L)

UTF8-LANGUAGE-TEXT 是把一个语言 Value 记录和 UTF-8 文本放进同一个 Value 的带语言文本(Codec 0x078L/0x079L)。

LANGUAGE-SHORT-CODE (0x07AL)

LANGUAGE-SHORT-CODE 是以 1 WORD 承载 GEUL Language Registry 中已分配编号的一个 BCP 47 tag 的 GEUL 压缩语言码。

UUID (0x07BL)

UUID 是承载 RFC 9562 UUID 128bit 值的定宽 Value。

TOULMIN

用图尔敏论证模型写入判定·执行图。

REFERENCE-NODE (0x0A0L)

REFERENCE-NODE 是把一个 Reference 连接到一条 Object 记录,从而定义或绑定该 Reference 是什么的有向陈述 Edge。

SAME-NODE (0x0A1L)

SAME-NODE 是声明两个 Reference 指示同一 referent 的无向同一性陈述 Edge。

DIFFERENT-NODE (0x0A2L)

DIFFERENT-NODE 是表示两个 Reference 指示互不相同的 referent 的非同一性陈述 Edge。

BIND (0x0A3L)

BIND 是把机器对接用的名称绑定到 Subject 的陈述 Edge。

LABEL (0x0A4L)

LABEL 是把 Subject 对象的某一语言名称(label)作为 Object 连接起来的陈述 Edge。

ALIAS (0x0A5L)

ALIAS 是把 Subject 对象的另一个名称(别名)作为 Object 连接起来的陈述 Edge。

DESCRIPTION (0x0A6L)

DESCRIPTION 是把 Subject 对象的某一语言说明作为 Object 连接起来的陈述 Edge。

TRIPLE (0x0AAL)

TRIPLE 是承载一个命题(Predicate、Subject、Object)及其等级(rank)的陈述 Edge。

QUALIFIER (0x0ABL)

QUALIFIER 是附加一个条件来限定其他 Edge(主要是 TRIPLE)所承载命题的陈述 Edge。

PUBLICATION (0x0B8L)

PUBLICATION·DEPRECATION·TOMBSTONE 是记录文档版本的公布、停用建议、删除的陈述 Edge,本页同时规定用这些 Edge 书写的版本列表文档的规格(Codec 0x0B8L~0x0BAL)。

DEPRECATION (0x0B9L)

PUBLICATION·DEPRECATION·TOMBSTONE 是记录文档版本的公布、停用建议、删除的陈述 Edge,本页同时规定用这些 Edge 书写的版本列表文档的规格(Codec 0x0B8L~0x0BAL)。

TOMBSTONE (0x0BAL)

PUBLICATION·DEPRECATION·TOMBSTONE 是记录文档版本的公布、停用建议、删除的陈述 Edge,本页同时规定用这些 Edge 书写的版本列表文档的规格(Codec 0x0B8L~0x0BAL)。

DECLARE (0x0BBL)

DECLARE 是声明一个 Codec 的 Payload 构成的陈述 Edge。

FIELD (0x0BCL)

FIELD 是声明 Codec Payload 中一个字段的陈述 Edge。

ENUM (0x0BDL)

ENUM 是为原始值字段的某个码值附加含义的陈述 Edge。

CODEC (0x0BEL)

CODEC 是指定一个 FIELD 所接受的一个 Kind·Codec 的陈述 Edge。

SOURCE (0x0C0L)

SOURCE 是依据 Edge,把单条记录(对象)或整个文档连接到它所出自的来源。

CONST (0x0E8L)

CONST 是执行 Edge 中“表达式”分组的 Codec。

UNARY (0x0E9L)

UNARY 是执行 Edge 中“表达式”分组的 Codec。

BINARY (0x0EAL)

BINARY 是执行 Edge 中“表达式”分组的 Codec。

CALL (0x0EBL)

CALL 是执行 Edge 中“表达式”分组的 Codec。

MEMBER (0x0ECL)

MEMBER 是执行 Edge 中“表达式”分组的 Codec。

INDEX (0x0EDL)

INDEX 是执行 Edge 中“表达式”分组的 Codec。

BLOCK (0x0F0L)

BLOCK 是执行 Edge 中“语句”分组的 Codec。

ASSIGN (0x0F1L)

ASSIGN 是执行 Edge 中“语句”分组的 Codec。

IF (0x0F2L)

IF 是执行 Edge 中“语句”分组的 Codec。

SWITCH (0x0F3L)

SWITCH 是执行 Edge 中“语句”分组的 Codec。

WHILE (0x0F4L)

WHILE 是执行 Edge 中“语句”分组的 Codec。

FOREACH (0x0F5L)

FOREACH 是执行 Edge 中“语句”分组的 Codec。

JUMP (0x0F6L)

JUMP 是执行 Edge 中“语句”分组的 Codec。

RETURN (0x0F7L)

RETURN 是执行 Edge 中“语句”分组的 Codec。

RAISE (0x0F8L)

RAISE 是执行 Edge 中“错误”分组的 Codec。

TRY (0x0F9L)

TRY 是执行 Edge 中“错误”分组的 Codec。

ATTACKS (0x108L)

ATTACKS 是用于写入 TOULMIN 图关系的 LINK Codec。

RUN (0x110L)

RUN 是用于写入 TOULMIN 图关系的 LINK Codec。

DO (0x111L)

DO 是用于写入 TOULMIN 图关系的 LINK Codec。

DO-ONCE (0x112L)

DO-ONCE 是用于写入 TOULMIN 图关系的 LINK Codec。

UNDO (0x113L)

UNDO 是用于写入 TOULMIN 图关系的 LINK Codec。

CHECKING (0x114L)

CHECKING 是用于写入 TOULMIN 图关系的 LINK Codec。

ENTRY (0x115L)

ENTRY 是用于写入 TOULMIN 图节点的 NODE Codec。

TRIGGER (0x116L)

TRIGGER 是用于写入 TOULMIN 图节点的 NODE Codec。

SOURCE (0x120L)

SOURCE 是 TOULMIN 文档的原文·分段记录。

TEXT (0x121L)

TEXT 是 TOULMIN 文档的原文·分段记录。

PROSE (0x125L)

PROSE 是 TOULMIN 文档的原文·分段记录。

FUNC (0x127L)

FUNC 是用于写入 TOULMIN 图节点的 NODE Codec。

FIELD (0x128L)

FIELD 是用于写入 TOULMIN 图节点的 NODE Codec。

ALIAS (0x129L)

ALIAS 是用于写入 TOULMIN 图节点的 NODE Codec。

GROUP (0x12AL)

GROUP 是用于写入 TOULMIN 图节点的 NODE Codec。

REQUIRES (0x12BL)

REQUIRES 是用于写入 TOULMIN 图关系的 LINK Codec。

MEANS (0x12CL)

MEANS 是用于写入 TOULMIN 图关系的 LINK Codec。

HAS (0x12DL)

HAS 是用于写入 TOULMIN 图关系的 LINK Codec。

RUNS (0x12EL)

RUNS 是用于写入 TOULMIN 图关系的 LINK Codec。

TRIGGERS (0x130L)

TRIGGERS 是用于写入 TOULMIN 图关系的 LINK Codec。

UNTIL (0x131L)

UNTIL 是用于写入 TOULMIN 图关系的 LINK Codec。

SAME-AS (0x132L)

SAME-AS 是用于写入 TOULMIN 图关系的 LINK Codec。

LABEL (0x134L)

LABEL 是用于写入 TOULMIN 图关系的 LINK Codec。

DOC-1WORD (0x1C0L)

DOC-1WORD、DOC-2WORD、DOC-4WORD 是通过指定文档的总 WORD 数来开启文档的结构 Meta。

DOC-2WORD (0x1C1L)

DOC-1WORD、DOC-2WORD、DOC-4WORD 是通过指定文档的总 WORD 数来开启文档的结构 Meta。

DOC-4WORD (0x1C2L)

DOC-1WORD、DOC-2WORD、DOC-4WORD 是通过指定文档的总 WORD 数来开启文档的结构 Meta。

AUTHOR (0x1CBL)

记录撰写文档内容的主体(git author)。

PARENT (0x1D1L)

记录上一版本的内容哈希(git parent)。

TRANSFORMED-BY (0x1D4L)

记录从其他表示转换为本文档的方法(例:Wikidata 转换器、自然语言编码器)。

REVERTS (0x1D6L)

记录被撤销更改的目标版本的内容哈希(git revert)。

REPLACES (0x1D7L)

记录被改写的目标版本的内容哈希(git amend、rebase)。

TAG (0x1DAL)

记录附加在版本上的不可变名称(git annotated tag)。

DELTA-BASE (0x1DBL)

表明该版本文件不是快照,而是相对于同一文档基准版本的 diff 的标记(git packfile 的 delta)。

DELTA-REMOVE (0x1DCL)

在 diff(DELTA-BASE)中,记录要从基准快照的 BODY 中去掉的记录的 LOCAL ID(Edge Id)("删除第X条")。

NEXT-LOCAL-ID (0x1DDL)

记录该文档的下一版本要分配给新陈述的 LOCAL ID(DBMS 的 auto increment、MySQL AUTO_INCREMENT)。

LICENSE (0x1DEL)

记录本文档及字节序列内作品的许可证。

USAGE (0x1E3L)

记录使用限制(例:禁止训练,禁止商业使用)。

SIGNATURE (0x1E6L)

对文档内容哈希的签名(git 签名提交、标签)。

BBOX2-BINARY64

BBOX2-BINARY64 是由 (minX, minY, maxX, maxY) 顺序的 IEEE 754 binary64 四个分量构成的二维边界框。

BLAKE3-256-DIGEST

BLAKE3-256-DIGEST 是承载 BLAKE3 default hash mode 输出前 32 octet(256 bit)的定宽 Value。

CLOSED-INTERVAL-BINARY64

CLOSED-INTERVAL-BINARY64 是以 (lower, upper) 顺序的 IEEE 754 binary64 两个 endpoint 表示闭区间的 Value。

COMPLEX128

COMPLEX128 是以 (real, imag) 顺序的 IEEE 754 binary64 两个分量表示复数的 Value。

COMPLEX64

COMPLEX64 是以 (real, imag) 顺序的 IEEE 754 binary32 两个分量表示复数的 Value。

DENSE-BFLOAT16-VECTOR

DENSE-BFLOAT16-VECTOR 不带 descriptor,连续存储 bfloat16 16 位元素的 bit pattern。

DENSE-BINARY16-VECTOR

DENSE-BINARY16-VECTOR 不带 descriptor,连续存储 IEEE 754 binary16 interchange bit pattern。

DENSE-BINARY32-VECTOR

DENSE-BINARY32-VECTOR 不带 descriptor,连续存储 IEEE 754 binary32 interchange bit pattern。

DENSE-BINARY64-VECTOR

DENSE-BINARY64-VECTOR 不带 descriptor,连续存储 IEEE 754 binary64 interchange bit pattern。

DENSE-I16-VECTOR

DENSE-I16-VECTOR 是不带 descriptor、连续存储 big-endian int16 元素的同质一维 Value。

DENSE-I32-VECTOR

DENSE-I32-VECTOR 是不带 descriptor、连续存储 big-endian int32 元素的同质一维 Value。

DENSE-I64-VECTOR

DENSE-I64-VECTOR 是不带 descriptor、连续存储 big-endian int64 元素的同质一维 Value。

DENSE-U16-VECTOR

DENSE-U16-VECTOR 是不带 descriptor、连续存储 big-endian uint16 元素的同质一维 Value。

DENSE-U32-VECTOR

DENSE-U32-VECTOR 是不带 descriptor、连续存储 big-endian uint32 元素的同质一维 Value。

DENSE-U64-VECTOR

DENSE-U64-VECTOR 是不带 descriptor、连续存储 big-endian uint64 元素的同质一维 Value。

DESCRIBED-DENSE-TENSOR

DESCRIBED-DENSE-TENSOR 是在 Payload descriptor 中记录 shape 与 element format,并存储 C-contiguous row-major payload 的张量 Value。

DESCRIBED-PACKED-TENSOR

DESCRIBED-PACKED-TENSOR 是在 Payload descriptor 中记录 shape 与 packed format,并以 packed 方式存储小于 WORD 的元素的张量 Value。

POINT2-BINARY64

POINT2-BINARY64 是由 (x, y) 顺序的 IEEE 754 binary64 两个分量构成的二维点。

POINT3-BINARY64

POINT3-BINARY64 是由 (x, y, z) 顺序的 IEEE 754 binary64 三个分量构成的三维点。

QUATERNION-BINARY32

QUATERNION-BINARY32 是以 (x, y, z, w) 顺序的 IEEE 754 binary32 四个分量表示 quaternion 的 Value。

RATIONAL-I64

RATIONAL-I64 是以 big-endian int64 numerator 与 int64 denominator 的既约分数表示有理数的 Value。

TAI-TIMESTAMP-NANOSECONDS

TAI-TIMESTAMP-NANOSECONDS 是自同一 TAI epoch 1970-01-01T00:00:00 TAI 起的 signed nanosecond 数。

TAI-TIMESTAMP-SECONDS

TAI-TIMESTAMP-SECONDS 是自 1970-01-01T00:00:00 TAI 起的 signed SI-second 数。

GPS-TIMESTAMP-NANOSECONDS

GPS-TIMESTAMP-NANOSECONDS 是自 GPS epoch 1980-01-06T00:00:00 GPS 起的 signed nanosecond 数。

GPS-TIMESTAMP-SECONDS

GPS-TIMESTAMP-SECONDS 是自 GPS epoch 1980-01-06T00:00:00 GPS 起的 signed second 数。

IEEE-DECIMAL128-BID

IEEE-DECIMAL128-BID 是表示 IEEE 754 decimal128 BID interchange encoding 的 Value。

IEEE-DECIMAL128-DPD

IEEE-DECIMAL128-DPD 是表示 IEEE 754 decimal128 DPD interchange encoding 的 Value。

IEEE-DECIMAL32-BID

IEEE-DECIMAL32-BID 是表示 IEEE 754 decimal32 BID interchange encoding 的 Value。

IEEE-DECIMAL32-DPD

IEEE-DECIMAL32-DPD 是表示 IEEE 754 decimal32 DPD interchange encoding 的 Value。

IEEE-DECIMAL64-BID

IEEE-DECIMAL64-BID 是表示 IEEE 754 decimal64 BID interchange encoding 的 Value。

IEEE-DECIMAL64-DPD

IEEE-DECIMAL64-DPD 是表示 IEEE 754 decimal64 DPD interchange encoding 的 Value。

MAC-48-ADDRESS

MAC-48-ADDRESS 是承载 48-bit IEEE 802 MAC 地址值的定宽 Value。

POSIX-TIMESTAMP-NANOSECONDS

POSIX-TIMESTAMP-NANOSECONDS 是自 Unix epoch 1970-01-01T00:00:00Z 起的 signed nanosecond 数。

CRC32C

CRC32C 是承载 CRC-32C 结果的定宽 Value。

IPV4-ADDRESS

IPV4-ADDRESS 是承载 IPv4 地址 32bit 值的定宽 Value。

IPV6-ADDRESS

IPV6-ADDRESS 是承载 IPv6 地址 128bit 值的定宽 Value。

URI-RELATIVE-REF

URI-RELATIVE-REF 是承载 RFC 3986 relative-ref 语法的 ASCII 字节序列的 Value。

BGRA8-UNORM

BGRA8-UNORM 是将 B、G、R、A 四个 UNORM8 分量 packed 存储于固定 Payload 2 WORD 的 Value。

RGBA8-UNORM

RGBA8-UNORM 是将 R、G、B、A 四个 UNORM8 分量 packed 存储于固定 Payload 2 WORD 的 Value。

SHA-512-DIGEST

SHA-512-DIGEST 是承载 SHA-2 系列 SHA-512 完整结果的定宽 Value。

SHA3-256-DIGEST

SHA3-256-DIGEST 是承载 SHA3-256 完整结果的定宽 Value。

GEUL 语法

GEUL v1 语法规范。定义 16 位 WORD 之上的记录、四种 Kind、文档结构、Issuer 与公布规则。