Edge 是把其他记录作为组成部分绑在一起进行陈述的记录。“Q42 是人”、“Q42 的英文名是 Douglas Adams"这样的陈述就是一个 Edge。

布局

TAG WORD          000K KKKC CCCC LLLL      章节 5~13 (0x0A0L~0x1BFL)
[Length 扩展 TAG]
[Codec 扩展 TAG]  Issuer 格式时
Edge Id           LOCAL Reference 记录
组成部分          按 Codec 规定的顺序
  • LLLL 是包含 TAG WORD 在内的全部 WORD 数 − 1。解码器不必知道 Codec,仅凭 Length 就能跳到下一条记录。
  • 第一个组成部分始终是 Edge Id(LOCAL Reference)。 它是 LOCAL Reference(0051 + ID,Identified 0x005L),因此不知道 Codec 也能读出 Edge Id。
  • 各组成部分依靠自己的 Length 找到边界。读完最后一个组成部分的位置必须与 Edge 的末尾恰好吻合。
  • 组成部分的构成(Payload)由各 Edge Codec 文档规定。
  • 有子格式的 Codec(WORLD、TIMELINE、SCENE)用每个 Codec 专属的 1 个 TAG WORD 指定子格式。
  • Edge 记录之间的顺序没有意义(Codec 另有规定的除外。例:TOULMIN 文档)。
  • 指向其他 Edge 时使用 Edge Id。本文档的 Edge 用 LOCAL 指向,其他文档的 Edge 用指示 Reference(EXTERNAL-POINTER-*、EXTERNAL-ISSUER-*)指向。

系列

Edge 区域是 0x0A0L~0x1BFL。直接码的系列是 (码 − 0xA0) >> 5(码是 TAG ID 的前三位)。系列每 32 格一个,等于章节 w >> 9 减去 5 的值。Edge 是章节 5~13。

章节系列直接码作用
5陈述0x0A0L~0x0BFL构成关于世界和事件的内容
6依据0x0C0L~0x0DFL记录和文档来自何处(SOURCE)
7执行0x0E0L~0x0FFL可执行的程序结构(AST)
8TOULMIN0x100L~0x11BL论证图:主张、反驳、例外,攻击关系,执行,判定结果
9TOULMIN 格式0x120L~0x134LTOULMIN 文档的原文、分段、辅助节点及关系
  • 已分配的直接码就是这五个系列。0x11CL~0x11FL 是 Reserved,0x135L~0x1BCL 是 Reserved(章节 10~12 整个章节都是 Reserved)。
  • 0x1BDL~0x1BFL(章节 13 末尾三格)是 EDGE-ISSUER(见下文 Issuer 格式 Edge)。Issuer 格式没有系列规则。

陈述 Edge

Codec名称组成部分
0x0A0LREFERENCE-NODESubject(Reference)指示 Object 的有向绑定
0x0A1LSAME-NODE两个 Reference 指示同一对象
0x0A2LDIFFERENT-NODE两个 Reference 指示不同对象
0x0A3LBIND把机器用名称(UTF8-TEXT)绑定到 Subject
0x0A4LLABELSubject 的各语言名称(UTF8-LANGUAGE-TEXT)
0x0A5LALIASSubject 的其他名称。布局与 LABEL 相同
0x0A6LDESCRIPTIONSubject 的各语言说明。布局与 LABEL 相同
0x0A8L/0x0A9LVERB-SHORT / VERB动词陈述
0x0AALTRIPLE一个命题(Predicate、Subject、Object)和 rank
0x0ABLQUALIFIER限定其他 Edge 命题的一个条件
0x0B0L~0x0B2LWORLD / TIMELINE / SCENE世界观、事件顺序、场景结构
0x0B8L~0x0BALPUBLICATION / DEPRECATION / TOMBSTONE文档版本的公布、废弃建议、删除(公布地址与版本列表)
0x0BBL~0x0BELDECLARE / FIELD / ENUM / CODEC编写 Codec 规格所用的词汇(Codec 规格文档)
  • -SHORT 与一般形式按偶数、奇数成对设置(VERB-SHORT 0x0A8L/VERB 0x0A9L)。LABEL 把语言作为 Object(UTF8-LANGUAGE-TEXT)内部的语言记录来接收,所以只使用 0x0A4L 一个。
  • PUBLICATION、DEPRECATION、TOMBSTONE 由版本列表文档使用。由于必须无需 codebook 就能读取版本列表,它们内置于解码器(公布地址与版本列表的第 0 层)。
  • DECLARE、FIELD、ENUM、CODEC 是编写 Codec 规格所用的词汇。由于必须无需 codebook 就能读取规格文档,其布局内置于解码器(第 0 层)。用这套词汇写成的各 Codec 规格文档是一般文档。

TRIPLE

详见:TRIPLE

TAG WORD          0000 1010 1010 LLLL
[Length 扩展 TAG]
Edge Id           LOCAL Reference
Predicate         Reference (维基数据属性等)
Subject           Reference
Object            Reference 或 Value
Rank              1 WORD
Rank名称含义
0normal默认
1preferred当前值,最具权威的值
2deprecated被判定为错误或过时但仍作为记录保留的值
  • Rank 与维基数据 statement rank 相同。不单独标注 rank 的来源使用 0。
  • TRIPLE 的含义是指向其 Edge Id 的所有 QUALIFIER 汇集在一起的结果。 读取方在解释 TRIPLE 之前先收集 QUALIFIER。

例:Q42 — P31(instance of)— Q5(人),normal,Edge Id 2

0AA9  0051 0002  0191 001F  0141 002A  0141 0005  0000
TAG   #2         P31        Q42        Q5         normal

QUALIFIER

详见:QUALIFIER

TAG WORD          0000 1010 1011 LLLL
[Length 扩展 TAG]
Edge Id           LOCAL Reference
Property          Reference
Target            LOCAL Reference (被限定 Edge 的 Edge Id)
Value             Reference 或 Value
  • QUALIFIER 是命题的一部分。它不是关于命题的单独主张,而是限定命题成立的条件(起止时间、适用范围等)。
  • 关于命题的单独主张(谁提出的等)用 TRIPLE 书写。
  • Target 是同一文档中的 Edge。同一 Target 的 QUALIFIER 顺序就是文档内的顺序。

例:Q42 — P69(educated at)— Q691283,开始(P580)1971

0AAA 0051 0003 0191 0045 0141 002A 0142 000A 8C53 0000   TRIPLE    #3 P69 Q42 Q691283 normal
0AB9 0051 0004 0191 0244 0051 0003 06E2 3139 3731        QUALIFIER #4 P580 #3 EDTF "1971"

LABEL, ALIAS, DESCRIPTION

详见:LABEL、ALIAS、DESCRIPTION

TAG WORD          0000 1010 0100 LLLL   (LABEL)
[Length 扩展 TAG]
Edge Id           LOCAL Reference
Subject           Reference
Object            UTF8-LANGUAGE-TEXT
  • 名称和语言放在一个 Object(UTF8-LANGUAGE-TEXT)里。
  • 同一 Subject、同一语言的 LABEL 至多一个。其他名称用 ALIAS 书写。
  • 没有语言的机器用名称用 BIND 书写。LABEL 必须有语言。

BIND

详见:BIND

  • 把机器对接用的名称(UTF8-TEXT)绑定到 Subject。没有语言,也不做规范化。字节相同才是同一名称。
  • 名称的范围是包含该 BIND 的文档。同一文档中不把同一名称绑定到不同的 Subject。
  • 其他记录不通过名称,而是通过 LOCAL ID 来指向。名称用于与外部(宿主函数、地址输入、人)对接。

SAME-NODE, DIFFERENT-NODE, REFERENCE-NODE

详见:SAME-NODE、DIFFERENT-NODE、REFERENCE-NODE

  • SAME-NODE 是两个 Reference 指向同一对象的同一性。它具有自反性、对称性、传递性。
  • DIFFERENT-NODE 是两个 Reference 为不同对象的非同一性。
  • REFERENCE-NODE 是用 Object 定义 Subject(Reference)是什么的有向绑定。它不是同一性主张。例:定义 LOCAL 节点所指向的 URI。

依据 Edge

为 BODY 中的单个记录或整个文档(HEAD)附加依据。依据系列的直接码只有 SOURCE(0x0C0L)一个。

Codec名称组成部分
0x0C0LSOURCETarget(被附加依据的 BODY Edge 的 Edge Id,在 HEAD 中 0 = 整个文档),Origin(来源 Reference,ABSENT 或 UNKNOWN-VALUE)
0x0C1L~0x0DFLReserved
  • 来源本身的性质(URL、标题、作者、发行日期 …)用以来源为 Subject 的 TRIPLE 书写,引用的性质(查阅日期、来源内的位置 …)用以 SOURCE 的 Edge Id 为 Target 的 QUALIFIER 书写。
  • 整个文档的来源在 HEAD 中用 Target 为 0 的 SOURCE 书写,以它为 Target 的 QUALIFIER 也放在 HEAD 中。HEAD 中只能出现这两种 Edge,Edge Id 由 HEAD 和 BODY 共用一个编号空间(整个文档的出处)。
  • 其他依据(原文范围、制作主体、可信度、各条文的施行期间、旧记录)用 QUALIFIER 书写,最初进入的版本由版本历史计算得出(SOURCE)。
  • 记录级别的判定结果由 TOULMIN VERDICT 负责。

SOURCE

详见:SOURCE

TAG WORD          0000 1100 0000 LLLL
[Length 扩展 TAG]
Edge Id           LOCAL Reference
Target            LOCAL Reference (被附加依据的 BODY Edge 的 Edge Id,在 HEAD 中为 0 = 整个文档)
Origin            Reference 或占位标记 0x0000 ABSENT、0x0010 UNKNOWN-VALUE

例:Q42 P19 TRIPLE #178 的出处是不列颠百科全书(Q5375741),其中的标识符 P1417

SOURCE     #1347  #178   Q5375741
QUALIFIER  #1348  P1417  #1347  "biography/Douglas-Adams"

执行 Edge

不绑定特定编程语言的程序结构。组成部分用本文档的 LOCAL ID 指向。

分组Codec
声明FUNCTION-DECLARE、TYPE-DECLARE
表达式CONST、UNARY、BINARY、CALL、MEMBER、INDEX、CONSTRUCT、CONDITIONAL
语句BLOCK、ASSIGN、IF、SWITCH、WHILE、FOREACH、JUMP、RETURN
错误RAISE、TRY
  • 这不是原样容纳外部语言代码的格式。外部语言的代码以 Issuer 格式放置。
  • 组成部分用本文档的 LOCAL ID(REF)指向。表达式位置放表达式 Edge 或符号。REF 0 表示无。
  • 表达式产生值,语句不产生值。表达式可以放在 BLOCK 的语句位置(值被丢弃)。
  • C 式 for 写成 BLOCK(初始化、WHILE),else if 写成假分支位置的 IF。
  • 符号是 LOCAL ID,名称用 BIND 绑定。其他记录不通过名称,而是通过 LOCAL ID 指向符号。名称相同但 LOCAL ID 不同则是不同的符号。
  • 符号是什么(变量、参数、函数、类型)由指向该符号的记录决定。文档内没有定义的符号由外部(宿主)提供,若是 CALL 的目标则为宿主函数。

未决问题:运算符码、类型表示、各 Codec 的 Payload 布局。

TOULMIN Edge

用图尔敏论证模型书写判定与执行图。直接码为 0x100L~0x11BL,辅助记录为 TOULMIN 格式系列 0x120L~0x134L。详见:TOULMIN

Issuer 格式 Edge

Issuer 可以定义并使用自己的 Edge 格式(EDGE-ISSUER-2WORD、4WORD、16WORD,Codec 0x1BDL~0x1BFL)。这是 Edge 区域末尾的三格。Codec 扩展 TAG 中放 Issuer 和 Codec 编号共 2 WORD。Edge Id 是其后 Payload 的第一个元素(TAG、Issuer、Codec 编号、Edge Id、其余 Payload)。Codec 编号由 Issuer 决定,没有系列规则。与 Kind 无关,在该 Issuer 的 codecs/ 内不得重复。Codec 文档放在该 Issuer 的 codecs/ 之下,以记录的 Codec 编号命名(公布地址与版本列表)。

  • 目前没有登记的 Edge ISSUER 格式。