验证文档手册 5.0，链接/链接

Question

我想知道为什么这个 Docbook 5.0 文档无效：

<?xml version='1.0' encoding='utf-8'?>
<article xmlns='http://docbook.org/ns/docbook' xmlns:xlink='http://www.w3.org/1999/xlink' version='5.0'>
<section xml:id='H_0'>
<title>This is a title</title>
<para>
Blah <link linkend='H_0'>This is a link</link>blah blah blah.</para>
</section>
</article>

这是我从xmlstarlet得到的：

$ xmlstarlet val --err --xsd /usr/share/xml/docbook/schema/xsd/5.0/docbook.xsd test.xml
test.xml:3.22: Element '{http://docbook.org/ns/docbook}section', attribute '{http://www.w3.org/XML/1998/namespace}id': '' is not a valid value of the atomic type 'xs:ID'.
test.xml:6.25: Element '{http://docbook.org/ns/docbook}link', attribute 'linkend': '' is not a valid value of the atomic type 'xs:IDREF'.
test.xml - invalid

我只想要文档中指向各部分的内部链接。

补充：也许这是一个xmlstarlet问题，因为其他工具可以愉快地处理文件。无论如何，如果有人能解释这个问题，我会很高兴。

Answer 1

也许是您安装的xmlstarlet版本中的错误？它在 Debian 上对我有用：

$ xmlstarlet val --err --xsd /usr/share/xml/docbook/schema/xsd/5.0/docbook.xsd -
<?xml version='1.0' encoding='utf-8'?>
<article xmlns='http://docbook.org/ns/docbook'
xmlns:xlink='http://www.w3.org/1999/xlink' version='5.0'>
<section xml:id='H_0'>
<title>This is a title</title>
<para>
Blah <link linkend='H_0'>This is a link</link>blah blah blah.</para>
</section>
</article>
- - valid
^^^^^

这是我的xmlstarlet版本信息：

$ xmlstarlet --version
1.6.1
compiled against libxml2 2.9.4, linked with 20904
compiled against libxslt 1.1.29, linked with 10129

---

不过，顺便说一下，问题中的 DocBook 文档实际上并无效，因为 DocBookarticle元素必须具有title或info子元素：

$ cat > test.xml
<?xml version='1.0' encoding='utf-8'?>
<article xmlns='http://docbook.org/ns/docbook'
xmlns:xlink='http://www.w3.org/1999/xlink' version='5.0'>
<section xml:id='H_0'>
<title>This is a title</title>
<para>
Blah <link linkend='H_0'>This is a link</link>blah blah blah.</para>
</section>
</article>
$ java -jar /usr/share/java/jing.jar 
/usr/share/xml/docbook/schema/rng/5.0/docbook.rng test.xml
test.xml:3:23: error: element "section" not allowed yet; expected element "info",
"subtitle", "title" or "titleabbrev"

请参阅 http://tdg.docbook.org/tdg/5.0/article.html：

文章 — 一篇文章。

概要

顺序：

• 其中之一：

  • 顺序：

    • 交错：

      • title
      • titleabbrev?
      • subtitle?

    • info?(db.titleforbidden.info)

  • info(db.titlereq.info)

在title和info后缺少?问号，再加上One of意味着需要title或info中的一个或另一个。

我很惊讶 XSD 架构没有抓住这一点。但我想这可能表明，为了确保您的 DocBook 文档确实有效，您可能需要考虑针对 RelaxNG 模式(/usr/share/xml/docbook/schema/rng/5.0/docbook.rng文件)进行验证。