DocBook V5.0

Question

1.1.

DocBook V5.0文書でDTDや!DOCTYPEを使わない場合、どうやってスキーマを割り当てればいいんですか？

Answer 1

文書とRELAX NGスキーマを関連付ける標準的な方法というものはありません。ほとんどのツールでは何らかの方法で関連付けを行うことができます。お使いのアプリケーションのドキュメンテーションを参照してください。ツールによっては、文書を編集したり処理するごとに、手動でスキーマを指定する必要があります。

Answer 2

新しいスキーマ言語（RELAX NGやW3C XML Schemaなど）には、特殊文字を簡単にタイプする目的で実体を定義する方法がありません。必要な文字が選べる機能や専用のツールバーを使い、生のUnicode文字や数値文字参照を文書に挿入できるようなエディタもあります。

他にも、文書の冒頭で実体を定義する方法があります。実体定義ファイルは現在W3Cにより管理されています。使おうとしている実体の定義がある定義ファイルを参照することで、インポートした実体を参照することができます。例を挙げます：

<?xml version="1.0" encoding="utf-8"?>
<!DOCTYPE article [
<!ENTITY % isopub SYSTEM "http://www.w3.org/2003/entities/iso8879/isopub.ent">
%isopub;
]>
<article xmlns="http://docbook.org/ns/docbook" version="5.0">
<title>DocBook V5.0 &ndash; the superb documentation format</title>
…

Answer 3

XIncludeを使ってください。DocBook V5.0には、XIncludeの要素を使うことができる代替スキーマがあります。このスキーマはいくつかのXMLエディタには必須です。こうしたスキーマの名前は末尾に「xi」が付きます。たとえば、docbook.rncは docbookxi.rncになります。

Answer 4

されます。現在の（1.69.1などの）スタイルシートは広く使われており、既存の多くのXSLTプロセッサが対応しているため、サポートや改善はこれからも続けます。

もちろん、いつの日か新規開発をすべてXSLT 2.0による実装のみに移行します。ただ、この移行は現在のスタイルシートの全機能が新しいスタイルシートで実装され、複数のXSLT 2.0プロセッサが出揃ってからになります。

Answer 5

標準のDocBookスキーマでは、equation要素の内部であればMathML名前空間に属する要素の使用を許可しています。つまりDocBook+MathML文書の妥当性を検証することはできるのですが、その反面、検証中はMathMLの要素が無視されてしまいます。さらに、MathMLの要素を編集する際には入力が補完されません。

MathMLを厳密に検証したり、入力補完機能が必要であれば、DocBookスキーマを MathMLスキーマで簡単に拡張することができます。

手順 1. MathMLスキーマを使ったDocBookスキーマの拡張

MathMLのRELAX NGスキーマをhttp://yupotan.sppd.ne.jp/relax-ng/mml2.htmlからダウンロードして、どこかに（たとえばmathmlサブディレクトリに）展開します。

短縮構文による簡易カスタムスキーマdbmathml.rncを作成します：

namespace html = "http://www.w3.org/1999/xhtml"
namespace mml = "http://www.w3.org/1998/Math/MathML"
namespace db = "http://docbook.org/ns/docbook"

include "/path/to/docbook.rnc" {
  db._any.mml = external "mathml/mathml2.rnc"
  db._any =
    element * - (db:* | html:* | mml:*) {
      (attribute * { text }
       | text
       | db._any)*
    }
}

もしくは、XML構文によるRELAX NGを使ったスキーマ dbmathml.rngでも構いません。

<?xml version="1.0" encoding="UTF-8"?>
<grammar xmlns="http://relaxng.org/ns/structure/1.0">

<include href="/path/to/docbook.rng">
  <define name="db._any.mml">
    <externalRef href="mathml/mathml2.rng"/>
  </define>

  <define name="db._any">
    <element>
      <anyName>
        <except>
          <nsName ns="http://docbook.org/ns/docbook"/>
          <nsName ns="http://www.w3.org/1999/xhtml"/>
          <nsName ns="http://www.w3.org/1998/Math/MathML"/>
        </except>
      </anyName>
      <zeroOrMore>
        <choice>
          <attribute>
            <anyName/>
          </attribute>
          <text/>
          <ref name="db._any"/>
        </choice>
      </zeroOrMore>
    </element>
  </define>
</include>

</grammar>

元のDocBookスキーマの代わりに、カスタマイズしたスキーマ（dbmathml.rncまたはdbmathml.rng）を使用します。

Answer 6

DocBookによるSVGの扱いはMathMLと同じです。imageobject要素の中であれば、SVG名前空間にある要素をすべて使うことができます。

手順 2. SVGスキーマを使ったDocBookスキーマの拡張

SVG RELAX NGスキーマをhttp://www.w3.org/Graphics/SVG/1.1/rng/rng.zipからダウンロードして、どこかに（たとえばsvgサブディレクトリに）展開します。

短縮構文による簡易カスタムスキーマdbsvg.rncを作成します：

namespace html = "http://www.w3.org/1999/xhtml"
namespace db = "http://docbook.org/ns/docbook"
namespace svg = "http://www.w3.org/2000/svg"

include "/path/to/docbook.rnc" {
  db._any.svg = external "svg/svg11.rnc"
  db._any =
    element * - (db:* | html:* | svg:*) {
      (attribute * { text }
       | text
       | db._any)*
    }
}

もしくは、XML構文によるRELAX NGを使ったスキーマ dbsvg.rngでも構いません。

<?xml version="1.0" encoding="UTF-8"?>
<grammar xmlns="http://relaxng.org/ns/structure/1.0">

<include href="/path/to/docbook.rng">
  <define name="db._any.svg">
    <externalRef href="svg/svg11.rng"/>
  </define>

  <define name="db._any">
    <element>
      <anyName>
        <except>
          <nsName ns="http://docbook.org/ns/docbook"/>
          <nsName ns="http://www.w3.org/1999/xhtml"/>
          <nsName ns="http://www.w3.org/2000/svg"/>
        </except>
      </anyName>
      <zeroOrMore>
        <choice>
          <attribute>
            <anyName/>
          </attribute>
          <text/>
          <ref name="db._any"/>
        </choice>
      </zeroOrMore>
    </element>
  </define>
</include>

</grammar>

元のDocBookスキーマの代わりに、カスタマイズしたスキーマ（dbsvg.rnc またはdbsvg.rng）を使用します。

Answer 7

できます。MathMLとSVGをDocBookスキーマに組み合わせるカスタムスキーマを作成すればよいのです。短縮構文による両者を併合したスキーマはこのようになります：

namespace html = "http://www.w3.org/1999/xhtml"
namespace mml = "http://www.w3.org/1998/Math/MathML"
namespace db = "http://docbook.org/ns/docbook"
namespace svg = "http://www.w3.org/2000/svg"

include "/path/to/docbook.rnc" {
  db._any.mml = external "mahtml/mathml2.rnc"
  db._any.svg = external "svg/svg11.rnc"
  db._any =
    element * - (db:* | html:* | mml:* | svg:*) {
      (attribute * { text }
       | text
       | db._any)*
    }
}

RELAX NG構文では次のようになります：

<?xml version="1.0" encoding="UTF-8"?>
<grammar xmlns="http://relaxng.org/ns/structure/1.0">

<include href="/path/to/docbook.rng">
  <define name="db._any.mml">
    <externalRef href="mathml/mathml2.rng"/>
  </define>

  <define name="db._any.svg">
    <externalRef href="svg/svg11.rng"/>
  </define>

  <define name="db._any">
    <element>
      <anyName>
        <except>
          <nsName ns="http://docbook.org/ns/docbook"/>
          <nsName ns="http://www.w3.org/1999/xhtml"/>
          <nsName ns="http://www.w3.org/1998/Math/MathML"/>
          <nsName ns="http://www.w3.org/2000/svg"/>
        </except>
      </anyName>
      <zeroOrMore>
        <choice>
          <attribute>
            <anyName/>
          </attribute>
          <text/>
          <ref name="db._any"/>
        </choice>
      </zeroOrMore>
    </element>
  </define>
</include>

</grammar>

Answer 8

XMLSpyには自前のxml.xsdがバンドルされていますが、このスキーマにはxml:id属性が定義されていません。バンドルされたxml.xsdはプログラムに組み込まれており、別のバージョンと置き換えることはできません。この問題を解決するには、XMLSpyのバージョンを2006 SP1にアップグレードするしかありません。

古い名前	新しい名前
`sgmltag`	`tag`
`bookinfo`, `articleinfo`, `chapterinfo`, `*info`	`info`
`authorblurb`	`personblurb`
`collabname`, `corpauthor`, `corpcredit`, `corpname`	`orgname`
`isbn`, `issn`, `pubsnumber`	`biblioid`
`lot`, `lotentry`, `tocback`, `tocchap`, `tocfront`, `toclevel1`, `toclevel2`, `toclevel3`, `toclevel4`, `toclevel5`, `tocpart`	`tocdiv`
`graphic`, `graphicco`, `inlinegraphic`, `mediaobjectco`	`mediaobject`と`inlinemediaobject`
`ulink`	`link`

1. 作成
1.1.	DocBook V5.0文書でDTDや!DOCTYPEを使わない場合、どうやってスキーマを割り当てればいいんですか？
	文書とRELAX NGスキーマを関連付ける標準的な方法というものはありません。ほとんどのツールでは何らかの方法で関連付けを行うことができます。お使いのアプリケーションのドキュメンテーションを参照してください。ツールによっては、文書を編集したり処理するごとに、手動でスキーマを指定する必要があります。
1.2.	DocBook V5.0では`–`のような実体を使うことができないんですか？
	新しいスキーマ言語（RELAX NGやW3C XML Schemaなど）には、特殊文字を簡単にタイプする目的で実体を定義する方法がありません。必要な文字が選べる機能や専用のツールバーを使い、生のUnicode文字や数値文字参照を文書に挿入できるようなエディタもあります。他にも、文書の冒頭で実体を定義する方法があります。実体定義ファイルは現在W3Cにより管理されています。使おうとしている実体の定義がある定義ファイルを参照することで、インポートした実体を参照することができます。例を挙げます： <?xml version="1.0" encoding="utf-8"?> <!DOCTYPE article [ <!ENTITY % isopub SYSTEM "http://www.w3.org/2003/entities/iso8879/isopub.ent"> %isopub; ]> <article xmlns="http://docbook.org/ns/docbook" version="5.0"> <title>DocBook V5.0 – the superb documentation format</title> …
1.3.	文書のモジュール化はどうやるんですか？
	XIncludeを使ってください。DocBook V5.0には、XIncludeの要素を使うことができる代替スキーマがあります。このスキーマはいくつかのXMLエディタには必須です。こうしたスキーマの名前は末尾に「xi」が付きます。たとえば、`docbook.rnc`は `docbookxi.rnc`になります。
2. スタイルシート
2.1.	新しくXSLT 2.0でDocBook XSLスタイルシートの実装が始まっても、現在のXSLT 1.0による実装の管理や改善は継続されるんですか？
	されます。現在の（1.69.1などの）スタイルシートは広く使われており、既存の多くのXSLTプロセッサが対応しているため、サポートや改善はこれからも続けます。もちろん、いつの日か新規開発をすべてXSLT 2.0による実装のみに移行します。ただ、この移行は現在のスタイルシートの全機能が新しいスタイルシートで実装され、複数のXSLT 2.0プロセッサが出揃ってからになります。
3. スキーマのカスタマイズ
3.1.	MathMLの要素を使ってDocBookスキーマを拡張するには？
	標準のDocBookスキーマでは、`equation`要素の内部であればMathML名前空間に属する要素の使用を許可しています。つまりDocBook+MathML文書の妥当性を検証することはできるのですが、その反面、検証中はMathMLの要素が無視されてしまいます。さらに、MathMLの要素を編集する際には入力が補完されません。 MathMLを厳密に検証したり、入力補完機能が必要であれば、DocBookスキーマを MathMLスキーマで簡単に拡張することができます。手順 1. MathMLスキーマを使ったDocBookスキーマの拡張 MathMLのRELAX NGスキーマをhttp://yupotan.sppd.ne.jp/relax-ng/mml2.htmlからダウンロードして、どこかに（たとえば`mathml`サブディレクトリに）展開します。短縮構文による簡易カスタムスキーマ`dbmathml.rnc`を作成します： namespace html = "http://www.w3.org/1999/xhtml" namespace mml = "http://www.w3.org/1998/Math/MathML" namespace db = "http://docbook.org/ns/docbook" include "/path/to/docbook.rnc" { db._any.mml = external "mathml/mathml2.rnc" db._any = element * - (db:* \| html:* \| mml:) { (attribute { text } \| text \| db._any)* } } もしくは、XML構文によるRELAX NGを使ったスキーマ `dbmathml.rng`でも構いません。 <?xml version="1.0" encoding="UTF-8"?> <grammar xmlns="http://relaxng.org/ns/structure/1.0"> <include href="/path/to/docbook.rng"> <define name="db._any.mml"> <externalRef href="mathml/mathml2.rng"/> </define> <define name="db._any"> <element> <anyName> <except> <nsName ns="http://docbook.org/ns/docbook"/> <nsName ns="http://www.w3.org/1999/xhtml"/> <nsName ns="http://www.w3.org/1998/Math/MathML"/> </except> </anyName> <zeroOrMore> <choice> <attribute> <anyName/> </attribute> <text/> <ref name="db._any"/> </choice> </zeroOrMore> </element> </define> </include> </grammar> 元のDocBookスキーマの代わりに、カスタマイズしたスキーマ（`dbmathml.rnc`または`dbmathml.rng`）を使用します。
3.2.	SVGの要素を使ってDocBookスキーマを拡張するには？
	DocBookによるSVGの扱いはMathMLと同じです。`imageobject`要素の中であれば、SVG名前空間にある要素をすべて使うことができます。手順 2. SVGスキーマを使ったDocBookスキーマの拡張 SVG RELAX NGスキーマをhttp://www.w3.org/Graphics/SVG/1.1/rng/rng.zipからダウンロードして、どこかに（たとえば`svg`サブディレクトリに）展開します。短縮構文による簡易カスタムスキーマ`dbsvg.rnc`を作成します： namespace html = "http://www.w3.org/1999/xhtml" namespace db = "http://docbook.org/ns/docbook" namespace svg = "http://www.w3.org/2000/svg" include "/path/to/docbook.rnc" { db._any.svg = external "svg/svg11.rnc" db._any = element * - (db:* \| html:* \| svg:) { (attribute { text } \| text \| db._any)* } } もしくは、XML構文によるRELAX NGを使ったスキーマ `dbsvg.rng`でも構いません。 <?xml version="1.0" encoding="UTF-8"?> <grammar xmlns="http://relaxng.org/ns/structure/1.0"> <include href="/path/to/docbook.rng"> <define name="db._any.svg"> <externalRef href="svg/svg11.rng"/> </define> <define name="db._any"> <element> <anyName> <except> <nsName ns="http://docbook.org/ns/docbook"/> <nsName ns="http://www.w3.org/1999/xhtml"/> <nsName ns="http://www.w3.org/2000/svg"/> </except> </anyName> <zeroOrMore> <choice> <attribute> <anyName/> </attribute> <text/> <ref name="db._any"/> </choice> </zeroOrMore> </element> </define> </include> </grammar> 元のDocBookスキーマの代わりに、カスタマイズしたスキーマ（`dbsvg.rnc` または`dbsvg.rng`）を使用します。
3.3.	先述のMathMLとSVGのカスタマイズを同時に行うことはできますか？
	できます。MathMLとSVGをDocBookスキーマに組み合わせるカスタムスキーマを作成すればよいのです。短縮構文による両者を併合したスキーマはこのようになります： namespace html = "http://www.w3.org/1999/xhtml" namespace mml = "http://www.w3.org/1998/Math/MathML" namespace db = "http://docbook.org/ns/docbook" namespace svg = "http://www.w3.org/2000/svg" include "/path/to/docbook.rnc" { db._any.mml = external "mahtml/mathml2.rnc" db._any.svg = external "svg/svg11.rnc" db._any = element * - (db:* \| html:* \| mml:* \| svg:) { (attribute { text } \| text \| db._any)* } } RELAX NG構文では次のようになります： <?xml version="1.0" encoding="UTF-8"?> <grammar xmlns="http://relaxng.org/ns/structure/1.0"> <include href="/path/to/docbook.rng"> <define name="db._any.mml"> <externalRef href="mathml/mathml2.rng"/> </define> <define name="db._any.svg"> <externalRef href="svg/svg11.rng"/> </define> <define name="db._any"> <element> <anyName> <except> <nsName ns="http://docbook.org/ns/docbook"/> <nsName ns="http://www.w3.org/1999/xhtml"/> <nsName ns="http://www.w3.org/1998/Math/MathML"/> <nsName ns="http://www.w3.org/2000/svg"/> </except> </anyName> <zeroOrMore> <choice> <attribute> <anyName/> </attribute> <text/> <ref name="db._any"/> </choice> </zeroOrMore> </element> </define> </include> </grammar>
4. ツール特有の問題
4.1.	DocBook V5.0文書をW3C XML Schema（`docbook.xsd`）に対して妥当性を検証する際にAltova XMLSpyを使っています。XMLSpyが未定義の`xml:id`属性に文句を言うんですけど？
	XMLSpyには自前の`xml.xsd`がバンドルされていますが、このスキーマには`xml:id`属性が定義されていません。バンドルされた`xml.xsd`はプログラムに組み込まれており、別のバージョンと置き換えることはできません。この問題を解決するには、XMLSpyのバージョンを2006 SP1にアップグレードするしかありません。

DocBook V5.0

移行ガイド

2005年12月28日

このバージョン：

最新のバージョン：

以前のバージョン：

著者：

日本語訳：

イントロダクション

待望の名前空間

注意

DocBookでリラクシング

注意

なぜDocBook V5.0に乗り換えるのか

スキーマ地獄

スキーマの入手場所

DocBookに関する文献

注意

ツールチェーン

DocBook V5.0の編集

Emacs上のnXML

注意

oXygen

XML Mind XML editor

DocBook V5.0の妥当性検証

注意

DocBook V5.0の処理

DocBook XSL Stylesheet

XSLT 2.0ベースによる再実装

マークアップの変更点

相互参照やリンクの改善

要素名の変更

要素の除去

DocBook V4.x文書をDocBook V5.0に変換する

実体はどうすれば？

ティップ

外部解析対象実体

DocBook V5.0のカスタマイズ

FAQ

1. 作成

2. スタイルシート

3. スキーマのカスタマイズ

4. ツール特有の問題

参考文献