标题投影图使用 RDF 1.2 abstract data model。Turtle 是本书示例的可读序列化表面。Turtle 排版、前缀顺序和 triple 顺序不构成图语义。

本书使用以下命名空间：

aat: 承载标题投影词表。rel: 承载由 xref rel 字段映射出的关系谓词。rdf: 承载 rdf:type 和 rdf:reifies。prov: 承载来源关系。xsd: 承载 typed literal。

标题投影图承诺两类结构查询资源：

标题投影图的其它事实归属于这两类资源。标题字段归属于 heading node。xref edge 字段归属于 xref edge evidence。来源坐标归属于可回源的 heading node、xref edge evidence 和 raw value object。

source document、projection 和 projection activity 是 provenance 资源。它们描述图从哪份源文件派生、由哪次投影活动生成。它们不属于标题节点集合，也不参与标题层级边。

raw value object 是 complex property 的值。heading complex property 通过 field predicate 归属于 heading node；xref edge complex property 通过 field predicate 归属于 xref edge evidence。raw value object 保存 raw、format、binding evidence 和回源坐标。raw value object 不作为标题层级、标题顺序、relation triple 或 xref target binding 的结构资源。

raw value object 的 RDF identity 由投影器生成。source value block 的手动 ID 只在 xref edge complex property 通过 named attribute value 指向该 block 时成为 aat:sourceValueId。source value id 是绑定事实，不是 raw value object 的 RDF identity，也不是字段名。

标题投影图把 raw value object 的 raw 作为 opaque literal 保存。field predicate 和 format 为下游解释 raw 提供源表面线索；schema validation 与 raw 内部字段解释属于下游消费者。

本地非标题 target 的 ID 是标题节点的地址事实。该 ID 归属为覆盖 target source span 的标题节点的 aat:addressLabel，不创建结构节点，不参与标题层级边，也不作为 relation triple 的端点。

标题投影图服务以下动作：

公共图单位必须服务这些动作。不能服务这些动作的结构不进入标题投影图的核心对象。

标题节点提供阅读单位。标题层级边提供递归阅读路径。aat:childOrder 提供同父 direct children 的局部顺序。aat:documentOrder 提供全局 preorder。交叉引用边提供作者显式写出的非层级关系。字段提供标题和边证据上的查询面。raw value object 提供复杂字段值的 raw 承载面。回源坐标提供读取和修改闭环。

这些对象共同构成标题投影图。标题投影图以标题为结构单位，并以标题切片、标题层级、交叉引用、字段、raw value object 和回源坐标满足阅读、遍历、关系查询、复杂值消费和源文件修改动作。

段落、listing、table、inline anchor、label、surface attribute 和 source value block 不创建结构节点。它们可以作为标题 raw、字段来源、raw value source、binding evidence、address label 来源或回源事实出现。

本地非标题 target 的 ID 投影为所属标题节点的 aat:addressLabel。该投影不表示源文档标题表面声明了该 ID，只表示该 ID 在标题投影图中寻址到该标题节点。

raw value object 内部 JSON、YAML、TOML、XML 或其它格式作为 raw literal 保留。raw 的内部解释属于读取该字段的下游消费者。

raw value object 的 format 来自 source block language。该字段表达 raw 的源文本语法。

heading complex property 由带 for 或 forSelector marker 的 source value block 产生。字段名来自该 block 的 property role。xref edge complex property 由 xref named attribute 产生。字段名来自 attribute key；attribute value 唯一匹配 source value id 时，字段值是 raw value object；未匹配或多义匹配时，字段值是 string literal。

标题投影图必须包含 source document entity、projection entity 和 projection activity。来源关系使用 PROV-O。

aat:relativePath 使用 / 作为路径分隔符。该路径相对于调用方给定的 document root。每个可回源的 heading、xref edge evidence 和 raw value object 都必须保存自身的 aat:relativePath 以及自己的 line span。

包含 source file reconstruction surface 的 RDF12 输出通过 aat:sourceFile 连接 source document 与 aat:SourceFile。aat:SourceFile 使用 aat:relativePath 标识 source file，并使用 aat:raw 保存该 source file 的完整原始文本。

以下表面都创建标题节点：

一个等号标题、两个等号标题、三个等号标题直到六个等号标题均为标题。投影不因 Asciidoctor 将一个等号标题归入 document title 而取消该标题节点。

headline 是标题文本，不包含标题等号标记。

该标题节点的 aat:headline 是 配送策略。

aat:headingLevel 使用解析器恢复出的标题层级坐标。该坐标是 0-based section level 时，源文本中的 = 对应 0，== 对应 1，=== 对应 2。

在 structural-payload.adoc 中，== 配送策略 和 == 运力规则 的解析层级是 1，=== 我是3级标题 的解析层级是 2。该数值正确表达标题嵌套层级。

标题节点的 IRI 由投影器生成。address label、generated address label 和 headline 不构成节点 IRI。

节点 IRI 的输入是 baseIri、documentKey 和 heading local id。documentKey 是 relative path 的 sha256 十六进制摘要。heading local id 使用 heading-l<startLine>-o<ordinal>。同一 relative path、同一 startLine 下出现多个 heading 时，ordinal 按源文档顺序从 0 递增；无冲突时使用 0。

规范形式：

源文档中的作者字符串只作为查询 label 或 selector 使用。

示例：

delivery 是 address label。配送策略 是 headline。二者都不构成 :heading-l5-o0 的身份。

标题节点 label 空间由 aat:addressLabel、aat:generatedAddressLabel 和 aat:headline 构成。selector 绑定标题节点时只查询这三类 label，不查询标题节点 IRI、role、普通字段谓词、xref display label 或 raw 文本。

aat:addressLabel 表示标题投影图中可寻址到标题节点的作者声明 label。该 label 来自标题自身手动 ID，或来自归属到该标题切片的本地非标题 target ID。aat:addressLabel 不表示该 label 一定写在标题表面。

同一 selector 可以命中多个标题节点。多义命中是源文档事实，投影器必须保留多义结果，不得任意选择一个标题节点作为唯一目标。

AsciiDoc 的本地 target catalog 可以包含 section、listing、table、block、inline anchor 和未知类型 target。标题投影图只把等号标题创建为标题节点；非标题 target 不创建 RDF 结构节点。

本地非标题 target 的 ID 归属为覆盖该 target source span 起始行的最内层标题节点的 aat:addressLabel。归属依据是 target 的源位置，不是引用该 target 的 xref 出现位置。source span 缺失的本地非标题 target 不形成 address label。

engine-code 是 listing block 的本地 target ID。该 ID 在标题投影图中归属为 核心引擎设计 标题节点的 address label。

该投影不创建 listing block 结构节点：

同一 address label 可以归属多个标题节点。该 selector 绑定时产生多义候选，不生成单一 target heading，也不生成主 relation triple。同一 address label 在同一标题节点下出现多次时，selector owner 是同一个标题节点，不因此制造多义。

跨文档 target 不读取外部文件，不归属到当前标题投影图。

标题头部 attrlist 的 ID、role 和 named attributes 均投影到标题节点。

投影为：

named attributes 直接使用 aat: 命名空间下同名谓词。字段值作为 literal 保存。投影器不解释 status 和 owner 的业务语义。标题 role 是源文档表面的作者角色，不参与 selector binding，不决定 heading node 的 RDF type。heading node 的结构身份只来自等号标题。

字段名映射必须确定。字段名是合法 IRI local name 时，谓词 IRI 为 aat:<fieldName>。字段名包含不能直接进入 prefixed name 的字符时，投影器必须使用稳定的 IRI-safe 编码；同一字段名在同一投影配置下必须得到同一谓词 IRI。字段值统一按源文档表面值保存为 string literal。

#id 不投影为 aat:id。它投影为 aat:addressLabel。点号 role token 不投影为字段名谓词。它投影为 aat:role。named attribute 才进入 aat:<fieldName> 谓词。

标题 complex property 也使用同一套字段名映射。标题 complex property 的字段名来自 source value block 的 property role，字段值是 raw value object。标题 metadata role 仍只表达标题角色，不表达 complex property 字段名。

重复 headline 合法。重复 address label 按源文档事实保留。按重复 label 查询时，结果可以包含多个标题节点。投影器不为重复 label 虚构唯一绑定。

标题切片的起点是该标题头部 metadata 的第一行。没有 metadata 时，起点是标题行。

该标题切片从 attrlist 行开始。

标题头部 metadata 是紧邻标题行、并归属于该标题的连续 metadata 表面。空行会结束 metadata 归属。属于前一个 block 的 metadata 不进入下一个标题切片起点。

标题切片的终点是下一个标题切片起点的前一行。没有下一个标题时，终点是源文件末尾。

标题切片不因标题层级嵌套而包含子标题切片。父子关系由结构边表达，标题节点自身 raw 只保存自身切片。

标题节点必须保存 aat:raw。aat:raw 是标题切片的原文。

示例：

该 raw 不包含子标题：

读取子标题内容使用标题层级边递归完成。

aat:raw 只表示标题节点自身切片。它不表示该标题统摄的完整子树文本。

子树文本是查询结果，不是节点字段。消费者需要完整子树时，先取得当前标题节点的 aat:raw，再沿 aat:containsDirectly 递归取得后代标题节点的 aat:raw，并按文档顺序组合。

标题节点必须保存：

标题节点具有 metadata 或正文内容时，必须保存对应的专用行范围：

标题没有 metadata 时，不输出 aat:metadataStartLine 和 aat:metadataEndLine。标题行之后没有正文内容时，不输出 aat:contentStartLine 和 aat:contentEndLine。

所有 line number 使用 1-based line number。line span 是闭区间。

aat:containsDirectly 表达父标题到直接子标题的关系。该关系来自 AbundantDocument 的 logical heading tree，不来自 source line、relative path、IRI 或 Turtle 文本顺序。

示例：

直接包含不表达传递闭包。若 root 直接包含 运力规则，且 运力规则 直接包含 我是3级标题，则 root 不直接包含 我是3级标题。

直接包含只连接标题节点。标题节点不通过 aat:containsDirectly 指向段落、listing、table、source value block、raw value object、label 或普通属性。

顶层标题没有父标题。若源文档存在一个等号 document title，该标题可以作为其它顶层 section 的父标题。若源文档没有可作为父级的等号标题，多个顶层标题之间不生成虚构 document heading；它们通过 aat:documentOrder 保持全局阅读顺序。

消费者通过 aat:containsDirectly 的递归查询取得标题子树。读取当前标题自身时只使用该标题节点的 aat:raw。读取标题统摄的完整子树时，递归读取子标题节点的 aat:raw。

aat:childOrder 表达标题在其父标题 direct children 中的 1-based 局部顺序。只有存在父标题的 heading 输出 aat:childOrder。

示例：

同一父标题下的 direct children 必须拥有唯一、连续、从 1 开始的 aat:childOrder。消费者通过 aat:containsDirectly 取得 direct children 后，按 numeric aat:childOrder 排序。

aat:childOrder 不跨父标题。不同 parent 下的两个 heading 可以拥有相同 aat:childOrder，因为该值只在 parent 的 direct children 集合内解释。

aat:documentOrder 表达标题在 logical heading tree preorder traversal 中的 1-based 全局顺序。所有 heading resources 必须输出 aat:documentOrder。

示例：

aat:documentOrder 在同一 projection 内唯一、连续、从 1 开始。存在 document title heading 时，该 heading 的 aat:documentOrder 为 1。无 document title heading 时，顶层 sections 按 AbundantDocument.children 顺序进入 traversal。

消费者需要整篇文档的线性标题序列时，按 numeric aat:documentOrder 排序。该字段不替代 aat:containsDirectly，因为全局 preorder 不能单独表达父子结构。

aat:relativePath、aat:startLine、aat:endLine、aat:headingLine 和 aat:raw 表达 heading 在 origin source file 中的位置与原文切片。

source coordinate fields 不表达 heading tree order。book-entry 输入中，不同 included files 的 heading 可以拥有相同 origin line number；消费者不得通过 source line、relative path、IRI lexical order 或 Turtle textual order 推断文档顺序。

aat:previousSibling 不属于核心 heading projection。核心 heading projection 使用 aat:childOrder 表达同父局部顺序，使用 aat:documentOrder 表达全局 preorder。

xref 所在的标题切片决定边的 source heading。

该 xref 位于 配送策略 标题切片中，因此 source heading 是 配送策略。

xref target 是 selector。selector 在标题投影 label 空间中绑定。标题投影 label 空间由 aat:addressLabel、aat:generatedAddressLabel 和 aat:headline 构成；xref target 不绑定到 role、字段谓词、xref display label、raw 文本或标题节点 IRI。

aat:addressLabel 来自标题自身手动 ID，或来自归属到标题的本地非标题 target ID。selector 指向 listing、table、block、inline anchor 或 source value block 的本地 target ID 时，target heading 是该 target ID 所属的标题节点。

capacity 绑定到 address label 为 capacity 的标题节点。因此上例的 target heading 是 运力规则。

engine-code 是 核心引擎设计 标题切片内 listing block 的本地 target ID 时，xref target selector engine-code 绑定到 核心引擎设计 标题节点。relation triple 的 object 是标题节点，不是 listing block。

selector 未绑定时，边证据保留 aat:targetSelector 和回源坐标，不生成虚构 target heading，不生成主 relation triple。

selector 多义绑定时，边证据保留候选目标，不任意选择一个 target heading，不生成主 relation triple。

xref edge evidence 保留原始 selector 和官方解析事实。aat:targetSelector 保存作者写出的 selector；aat:officialResolvedId、aat:officialResolvedType 和 aat:officialHref 保存 Asciidoctor 解析出的 target id、target type 和 href。官方解析事实不改变 relation triple 的 heading endpoint。

predicate 由 xref attribute rel 决定。没有 rel 时，predicate 是 aat:references。有 rel 时，predicate 使用该字段映射出的关系 IRI。

示例：

投影为：

示例：

投影为：

rel 只选择谓词。投影器不解释该谓词的业务语义。

rel 字段是绝对 IRI 时，predicate 使用该 IRI。rel 字段是已知 CURIE 时，predicate 使用展开后的 IRI。rel 字段是普通 token 时，predicate 使用 rel: 命名空间下的稳定 IRI-safe 映射。rel 不能映射为合法 IRI 时，边证据保留 aat:rel，不生成主 relation triple。

交叉引用边证据保存该边在源文档中的出现点、字段和 official resolved facts。边证据不是标题节点。

边证据 IRI 使用 xref-edge-l<startLine>-c<startColumn>-o<ordinal> local id。startLine 和 startColumn 来自 xref occurrence 的起点。相同行列出现多个 xref 时，ordinal 按源文档顺序从 0 递增；无冲突时使用 0。

边证据的 aat:startColumn 与 aat:endColumn 使用 source span column 语义。列号是 1-based Unicode code point column；aat:startColumn 是 xref occurrence 的起始列，aat:endColumn 是 xref occurrence 结束后的列位置。

示例：

普通 xref named attributes 使用 aat: 命名空间下同名 field predicate。示例中的 weight=0.8 投影为 aat:weight "0.8"。字段值按源文档表面值保存为 string literal。

xref edge complex property 也使用 field predicate。示例中的 relation-evidence=rel-delivery-capacity 匹配 source value block id 时，边证据输出 aat:relation-evidence :value-l25-o0。raw value object 保存该 source value block 的 raw、format、source coordinates 和 aat:sourceValueId。

同一个 xref edge evidence 可以拥有多个 complex properties。每个 xref named attribute 的 key 是字段名；value 唯一匹配 source value block id 时，该字段值是 raw value object。未匹配或多义匹配时，该字段值是 string literal。

标题 attrlist named attributes 直接投影为标题节点 literal fields。

投影为：

xref named attributes 在未绑定 source value block id 时投影为 xref edge evidence literal fields。

投影为：

literal field 不触发业务解释。aat:role、aat:status、aat:owner、aat:weight 只是源文档表面字段的 RDF 表达。下游消费者可以解释这些字段，也可以忽略这些字段。

字段名映射必须确定。字段名是合法 IRI local name 时，谓词 IRI 为 aat:<fieldName>。字段名包含不能直接进入 prefixed name 的字符时，投影器使用稳定的 IRI-safe 编码；同一字段名在同一投影配置下得到同一谓词 IRI。

rel 是 xref relation control field。它决定主 relation triple 的谓词，并可作为 aat:rel 保留。rel 不参与 source value id matching。

raw value object 是 complex property 的值。raw value object 保存 source value block 的 raw、format、source coordinate 和 binding evidence。

raw value object 保存以下事实：

raw value object 不保存字段名、结构分类标记或下游模型名。字段名由 heading node 或 xref edge evidence 指向 raw value object 的 field predicate 表达。raw value object 的 raw 作为 opaque literal 保存。schema validation 与 raw 内部字段解释属于下游消费者。

带 for 或 forSelector marker 的 source value block 表达 heading complex property。该 block 的 property role 是字段名。source block language 是 format。block body 是 raw。

带值 marker 查询 标题节点 定义的 heading projection label space。绑定目标来自标题节点的 aat:addressLabel、aat:generatedAddressLabel 或 aat:headline。绑定失败或多义绑定时，不输出 heading complex property。

无值 marker 表达 source ownership binding。投影器使用 source value block 的源位置，找到覆盖该 block 起始行的最内层 heading node，并把 complex property 写到该 heading node。源位置无法确定 owning heading 时，不输出 heading complex property。

property role 必须稳定给出一个字段名。没有 property role 或有多个 property roles 的 source value block 不输出 heading complex property。

投影为：

无值 for 使用源位置归属 owning heading：

该 source value block 已经由 for 字段声明为 heading complex property candidate。投影器按源位置确定 owning heading，并通过 aat:review-playbook 连接 raw value object。无值 marker 不输出 aat:forSelector。

xref edge complex property 由 xref named attribute 和 source value block 共同表达。attribute key 是字段名。attribute value 唯一匹配 source value block id 时，字段值是 raw value object。

投影为：

edge complex property 归属于 xref edge evidence。它不归属于 source heading，也不归属于 target heading。

一个 xref edge evidence 可以拥有多个 complex properties。每个匹配的 attribute 产生一个 field predicate。attribute value 未匹配 source value block id 或多义匹配 source value block id 时，该 attribute 按 literal field 输出。

raw value object 的 raw 作为 opaque literal 保存。JSON、YAML、TOML、XML 或其它格式内部字段由下游消费者解释。

raw value object 必须保存 raw、relative path、完整 line span 和 content line span。format 来自 source block language。heading selector binding 使用 aat:forSelector 保存 selector。xref edge source value binding 使用 aat:sourceValueId 保存 source value id。

raw value object 是 complex property 的值。公共查询通过所属 heading node 或 xref edge evidence 上的 field predicate 取得 raw value object。标题结构遍历由 heading node、aat:containsDirectly、aat:childOrder 和 aat:documentOrder 承担；relation triple 的端点由 source heading 与 target heading 承担。

source value block 的本地 target ID 可以成为所属标题节点的 address label。该 address label 只用于寻址标题节点，不改变 raw value object 的 complex property 身份。

format 表达 raw 的源文本语法。该事实来自 source block language：[source,json] 的 format 是 json，[source,yaml] 的 format 是 yaml。source block 没有 language 时，raw value object 不输出 aat:format；投影器不通过 raw 内容猜测格式。

field predicate 与 format 是正交事实。aat:policy-risk-profile 或 aat:relation-evidence 表达下游模型入口；json 或 yaml 表达 raw 的文本语法。下游消费者按 field predicate 选择模型，按 format 解析 raw。

aat:addressLabel 来自标题自身手动 ID，或来自归属到标题的本地非标题 target ID。engine-code 是 核心引擎设计 标题切片内 listing block 的本地 target ID 时，以下查询返回 核心引擎设计 标题节点：

headline 可以重复。该查询可以返回多个标题节点。

该查询返回 capacity 标题节点自身切片 raw。子标题 raw 通过递归结构查询取得。

aat:containsDirectly+ 是查询层递归。投影图不物化传递闭包。

aat:documentOrder 是 logical heading tree preorder traversal 的全局顺序。它不替代 aat:containsDirectly；消费者需要树结构时仍应读取直接父子关系，并在同一 parent 的 direct children 上按 numeric aat:childOrder 排序。

xref target selector 指向本地非标题 target ID 时，?target 仍返回该 target 所属的标题节点。edge evidence 的 aat:targetSelector 和 aat:officialResolvedType 表达源文档中被引用的具体 AsciiDoc target 表面。

该查询返回 selector 没有绑定到标题节点的 xref edge evidence。该结果不自动表示 dead link；dead link 判断属于下游 lint。

多义边不生成主 relation triple。

直接字段谓词表达源文档表面字段。该查询不要求投影器解释 policy 或 active 的业务含义。

消费者按 field predicate 读取 heading complex property。

aat:policy-risk-profile 是下游模型入口。raw value object 保存 raw、format 和 source coordinate。查询不需要枚举机制字段或过滤 role。

冷链样例中的标题复杂属性查询使用业务字段名：

消费者按 xref edge evidence 上的 field predicate 读取 edge complex property。

冷链样例中的边复杂属性查询使用 aat:dependency-evidence：

包含 source file reconstruction surface 的 RDF12 输出可以列出 source set 中的 source files。

样例中的 delivery 和 capacity 是标题 address labels。.policy 和 .rule 是标题 roles。policy-risk-profile 是 heading complex property 字段名。relation-evidence 是 xref edge complex property 字段名。rel-delivery-capacity 是 edge complex property 的 source value id。

该文档产生四个标题节点：

rel-delivery-capacity 是 source value block 的本地 target ID。该 ID 按本地非标题 target 规则归属为 配送策略 标题节点的 address label。该归属只表示 rel-delivery-capacity 可以在标题投影图中寻址到 配送策略 标题节点，不表示 source value block 成为标题节点。

root 不直接包含 我是3级标题。该关系由递归查询推出。同一父标题下的 direct children 通过 aat:childOrder 排序；整篇文档的 preorder 通过 aat:documentOrder 排序。

包含 source file reconstruction surface 的 RDF12 输出还会通过 aat:sourceFile 指向 aat:SourceFile。aat:SourceFile 保存 source file 的 aat:relativePath 和完整 aat:raw。

[.policy-risk-profile, for=delivery] 表达 heading complex property。policy-risk-profile 是字段名。for=delivery 是 heading selector binding。该 source value block 没有 source value id；heading complex property 不要求 source value id。

该 complex property 的公共读取路径是 heading 的 aat:policy-risk-profile。消费者按字段名取得 raw value object，并按 aat:format 解析 raw。

relation-evidence=rel-delivery-capacity 表达 xref edge complex property。relation-evidence 是字段名。rel-delivery-capacity 唯一匹配 source value block id，因此字段值是 raw value object。该 complex property 归属于 xref edge evidence，不归属于 source heading 或 target heading。

本地非标题 target 的 ID 成为所属标题的 address label。以下补充样例中，capacity-evidence 是 listing block 的本地 target ID；该 listing 位于 运力规则 标题切片内。

补充样例的投影把 capacity-evidence 写为 运力规则 标题节点的 address label，并把 xref 关系投影为标题之间的关系边。

该投影不创建 listing block 结构节点。消费者通过 aat:addressLabel "capacity-evidence" 查到 运力规则 标题节点，并读取该标题节点的 aat:raw 或标题子树。

samples/structural-payload.adoc 的投影必须满足：