DocBook场景下RELAX NG与Schematron的关系及协同应用逻辑
DocBook 5.x 双Schema体系的角色定位与协同逻辑
两类Schema语言的分工与校验协同流程
你之前的初步认知基本是准确的,两类技术在DocBook的整个定义、校验链路里是明确分层协作的:
- RELAX NG承担基础词汇与结构的刚性定义:负责划定DocBook允许使用的全部元素、属性范围,定义元素之间合法的嵌套关系、顺序、出现次数,以及属性值的基础数据类型(比如字符串、数值、固定枚举值)。所有这类“局部结构层面的合规判断”,全部由RELAX NG兜底,只要不符合这层规则的文档,会被直接判定为非法DocBook XML。
- Schematron承担跨节点语义规则的校验:负责校验那些无法用局部结构描述的、和文档整体业务语义相关的约束,比如:
- 文档结构顺序类规则:比如
<book>节点下的版权页、序言、正文章节的先后顺序不能随意调换 - 跨元素关联类规则:比如所有被
<xref>引用的ID,必须在文档内存在定义;术语表中的每个术语,必须在正文至少出现一次引用 - 上下文关联类规则:比如
<figure>元素如果没有自带图片资源节点,就不能被标记为独立浮动元素
- 文档结构顺序类规则:比如
两者的协同逻辑完全匹配你提到的jing类工具的执行流程:
- 先加载集成了Schematron规则的RELAX NG Schema文件
- 第一遍执行RELAX NG的结构校验,筛掉所有乱嵌套、使用未定义元素、属性值格式错误的文档
- 第二遍自动执行内嵌的Schematron断言规则,对已经通过结构校验的文档,完成语义层面的合规判断
关于Schema能力边界的澄清
维基百科提到的“由集成了Schematron规则的RELAX NG schema正式定义”,并不意味着RELAX NG是“能力不足才需要打补丁”——本质是所有基于内容模型的Schema语言(包括RELAX NG、XML Schema),天生就有明确的能力边界:
- 这类语言的设计目标就是描述局部、上下文无关的结构规则,最擅长的是“某个元素下面可以放哪些子元素、按什么顺序放、放几次”的判断。这部分如果硬用Schematron写,会非常零散、可读性极差。
- 但这类语言从设计之初,就没有针对跨节点、全局语义规则做语法优化:如果要在RELAX NG里写“全文档范围内所有引用必须有对应锚点”“章节标题必须紧跟在章节开标签之后”这类规则,要么语法极其冗长晦涩,甚至部分涉及路径匹配的规则完全没法用原生语法实现。
你之前对“RELAX NG vs XML Schema”的定位模糊,本质是没区分开两类语言的同与异:
- 二者属于同一类技术,都是基于内容模型的结构Schema,核心能力边界完全一致,差异只是语法的简洁度、特性的灵活度:RELAX NG的语法更轻量,没有XML Schema的冗余包装,写出来的Schema文件更容易维护,所以DocBook 5.x弃用了之前基于XML Schema的定义方案,选择了RELAX NG作为基础结构层。
- 但不管换哪种结构类Schema,都不可能靠单一种语言覆盖DocBook的全部规则,所以才需要搭配Schematron补全语义层的校验能力,这是整个行业在XML Schema设计上形成的通用最优解,不是DocBook独有的特殊选择。
内容的提问来源于stack exchange,提问作者toraritte
相关产品推荐
相关产品推荐

