source: pst/xml/docbook5.xml

trunk
Last change on this file was 6b33b5b, checked in by Bruce Dubbs <bdubbs@…>, 2 months ago

Finish tagging for chapters 46-50.

  • Property mode set to 100644
File size: 15.6 KB
RevLine 
[ab4fdfc]1<?xml version="1.0" encoding="UTF-8"?>
[f6be42d]2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
3 "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
4 <!ENTITY % general-entities SYSTEM "../../general.ent">
5 %general-entities;
6
7 <!ENTITY docbook5-download-http "https://docbook.org/xml/5.0/docbook-5.0.zip">
8 <!ENTITY docbook5-download-ftp " ">
9 <!ENTITY docbook5-md5sum "2411c19ed4fb141f3fa3d389fae40736">
10 <!ENTITY docbook5-size "820 KB">
11 <!ENTITY docbook5-buildsize "6.2 MB">
12 <!ENTITY docbook5-time "0.1 SBU">
13]>
14
15<sect1 id="docbook5" xreflabel="docbook-xml-5.0">
16 <?dbhtml filename="docbook5.html"?>
17
18
19 <title>docbook-xml-5.0</title>
20
21 <indexterm zone="docbook5">
22 <primary sortas="a-DocBook5-XML-DTD">DocBook XML DTD and Schemas 5.0</primary>
23 </indexterm>
24
25 <sect2 role="package">
26 <title>Introduction to DocBook XML DTD and Schemas 5.0</title>
27
28 <para>
29 The <application>DocBook XML DTD and Schemas</application>-5.0 package
30 contains document type definitions and schemas for verification of XML
31 data files against the DocBook rule set. These are useful for structuring
32 books and software documentation to a standard allowing you to utilize
33 transformations already written for that standard. In addition to
34 providing a DTD, version 5 introduced the RelaxNG schema and Schematron
35 rules, and is incompatible with previous versions of DocBook XML.
36 </para>
37
[6b33b5b]38 &lfs121_checked;
[f6be42d]39
40 <bridgehead renderas="sect3">Package Information</bridgehead>
41 <itemizedlist spacing="compact">
42 <listitem>
[fa3edfef]43 <para>
44 Download (HTTP): <ulink url="&docbook5-download-http;"/>
45 </para>
[f6be42d]46 </listitem>
47 <listitem>
[fa3edfef]48 <para>
49 Download (FTP): <ulink url="&docbook5-download-ftp;"/>
50 </para>
[f6be42d]51 </listitem>
52 <listitem>
[fa3edfef]53 <para>
54 Download MD5 sum: &docbook5-md5sum;
55 </para>
[f6be42d]56 </listitem>
57 <listitem>
[fa3edfef]58 <para>
59 Download size: &docbook5-size;
60 </para>
[f6be42d]61 </listitem>
62 <listitem>
[fa3edfef]63 <para>
64 Estimated disk space required: &docbook5-buildsize;
65 </para>
[f6be42d]66 </listitem>
67 <listitem>
[fa3edfef]68 <para>
69 Estimated build time: &docbook5-time;
70 </para>
[f6be42d]71 </listitem>
72 </itemizedlist>
73
74 <bridgehead renderas="sect3">DocBook XML DTD and Schemas 5.0 Dependencies</bridgehead>
75
76 <bridgehead renderas="sect4">Required</bridgehead>
77 <para role="required">
78 <xref linkend="libxml2"/>,
79 <xref linkend="sgml-common"/>, and
80 <xref linkend="unzip"/>
81 </para>
82
83
84 </sect2>
85
86 <sect2 role="installation">
87 <title>Installation of DocBook XML DTD and Schemas 5.0</title>
88
89 <para>
90 Install <application>DocBook XML DTD and Schemas</application>
91 by running the following commands as the
92 <systemitem class="username">root</systemitem> user:
93 </para>
94
95<screen role="root"><userinput>install -vdm755 /usr/share/xml/docbook/schema/{dtd,rng,sch,xsd}/5.0 &amp;&amp;
96install -vm644 dtd/* /usr/share/xml/docbook/schema/dtd/5.0 &amp;&amp;
97install -vm644 rng/* /usr/share/xml/docbook/schema/rng/5.0 &amp;&amp;
98install -vm644 sch/* /usr/share/xml/docbook/schema/sch/5.0 &amp;&amp;
99install -vm644 xsd/* /usr/share/xml/docbook/schema/xsd/5.0</userinput></screen>
100
101 <para>
102 Create (or update) and populate the
[8558044]103 <filename>/etc/xml/docbook-5.0</filename> catalog file by running the
[f6be42d]104 following commands as the <systemitem class="username">root</systemitem>
105 user:
106 </para>
107
108<screen role="root"><?dbfo keep-together="auto"?><userinput>if [ ! -e /etc/xml/docbook-5.0 ]; then
109 xmlcatalog --noout --create /etc/xml/docbook-5.0
110fi &amp;&amp;
111
112xmlcatalog --noout --add "public" \
113 "-//OASIS//DTD DocBook XML 5.0//EN" \
114 "file:///usr/share/xml/docbook/schema/dtd/5.0/docbook.dtd" \
115 /etc/xml/docbook-5.0 &amp;&amp;
116xmlcatalog --noout --add "system" \
117 "http://www.oasis-open.org/docbook/xml/5.0/dtd/docbook.dtd" \
118 "file:///usr/share/xml/docbook/schema/dtd/5.0/docbook.dtd" \
119 /etc/xml/docbook-5.0 &amp;&amp;
120xmlcatalog --noout --add "system" \
121 "http://docbook.org/xml/5.0/dtd/docbook.dtd" \
122 "file:///usr/share/xml/docbook/schema/dtd/5.0/docbook.dtd" \
123 /etc/xml/docbook-5.0 &amp;&amp;
124
125xmlcatalog --noout --add "uri" \
126 "http://www.oasis-open.org/docbook/xml/5.0/rng/docbook.rng" \
127 "file:///usr/share/xml/docbook/schema/rng/5.0/docbook.rng" \
128 /etc/xml/docbook-5.0 &amp;&amp;
129xmlcatalog --noout --add "uri" \
130 "http://docbook.org/xml/5.0/rng/docbook.rng" \
131 "file:///usr/share/xml/docbook/schema/rng/5.0/docbook.rng" \
132 /etc/xml/docbook-5.0 &amp;&amp;
133xmlcatalog --noout --add "uri" \
134 "http://www.oasis-open.org/docbook/xml/5.0/rng/docbookxi.rng" \
135 "file:///usr/share/xml/docbook/schema/rng/5.0/docbookxi.rng" \
136 /etc/xml/docbook-5.0 &amp;&amp;
137xmlcatalog --noout --add "uri" \
138 "http://docbook.org/xml/5.0/rng/docbookxi.rng" \
139 "file:///usr/share/xml/docbook/schema/rng/5.0/docbookxi.rng" \
140 /etc/xml/docbook-5.0 &amp;&amp;
141xmlcatalog --noout --add "uri" \
142 "http://www.oasis-open.org/docbook/xml/5.0/rnc/docbook.rnc" \
143 "file:///usr/share/xml/docbook/schema/rng/5.0/docbook.rnc" \
144 /etc/xml/docbook-5.0 &amp;&amp;
145xmlcatalog --noout --add "uri" \
146 "http://docbook.org/xml/5.0/rng/docbook.rnc" \
147 "file:///usr/share/xml/docbook/schema/rng/5.0/docbook.rnc" \
148 /etc/xml/docbook-5.0 &amp;&amp;
149xmlcatalog --noout --add "uri" \
150 "http://www.oasis-open.org/docbook/xml/5.0/rnc/docbookxi.rnc" \
151 "file:///usr/share/xml/docbook/schema/rng/5.0/docbookxi.rnc" \
152 /etc/xml/docbook-5.0 &amp;&amp;
153xmlcatalog --noout --add "uri" \
154 "http://docbook.org/xml/5.0/rng/docbookxi.rnc" \
155 "file:///usr/share/xml/docbook/schema/rng/5.0/docbookxi.rnc" \
156 /etc/xml/docbook-5.0 &amp;&amp;
157
158xmlcatalog --noout --add "uri" \
159 "http://www.oasis-open.org/docbook/xml/5.0/xsd/docbook.xsd" \
160 "file:///usr/share/xml/docbook/schema/xsd/5.0/docbook.xsd" \
161 /etc/xml/docbook-5.0 &amp;&amp;
162xmlcatalog --noout --add "uri" \
163 "http://docbook.org/xml/5.0/xsd/docbook.xsd" \
164 "file:///usr/share/xml/docbook/schema/xsd/5.0/docbook.xsd" \
165 /etc/xml/docbook-5.0 &amp;&amp;
166xmlcatalog --noout --add "uri" \
167 "http://www.oasis-open.org/docbook/xml/5.0/xsd/docbookxi.xsd" \
168 "file:///usr/share/xml/docbook/schema/xsd/5.0/docbookxi.xsd" \
169 /etc/xml/docbook-5.0 &amp;&amp;
170xmlcatalog --noout --add "uri" \
171 "http://docbook.org/xml/5.0/xsd/docbookxi.xsd" \
172 "file:///usr/share/xml/docbook/schema/xsd/5.0/docbookxi.xsd" \
173 /etc/xml/docbook-5.0 &amp;&amp;
174xmlcatalog --noout --add "uri" \
175 "http://www.oasis-open.org/docbook/xml/5.0/xsd/xi.xsd" \
176 "file:///usr/share/xml/docbook/schema/xsd/5.0/xi.xsd" \
177 /etc/xml/docbook-5.0 &amp;&amp;
178xmlcatalog --noout --add "uri" \
179 "http://docbook.org/xml/5.0/xsd/xi.xsd" \
180 "file:///usr/share/xml/docbook/schema/xsd/5.0/xi.xsd" \
181 /etc/xml/docbook-5.0 &amp;&amp;
182xmlcatalog --noout --add "uri" \
183 "http://www.oasis-open.org/docbook/xml/5.0/xsd/xlink.xsd" \
184 "file:///usr/share/xml/docbook/schema/xsd/5.0/xlink.xsd" \
185 /etc/xml/docbook-5.0 &amp;&amp;
186xmlcatalog --noout --add "uri" \
187 "http://docbook.org/xml/5.0/xsd/xlink.xsd" \
188 "file:///usr/share/xml/docbook/schema/xsd/5.0/xlink.xsd" \
189 /etc/xml/docbook-5.0 &amp;&amp;
190xmlcatalog --noout --add "uri" \
191 "http://www.oasis-open.org/docbook/xml/5.0/xsd/xml.xsd" \
192 "file:///usr/share/xml/docbook/schema/xsd/5.0/xml.xsd" \
193 /etc/xml/docbook-5.0 &amp;&amp;
194xmlcatalog --noout --add "uri" \
195 "http://docbook.org/xml/5.0/xsd/xml.xsd" \
196 "file:///usr/share/xml/docbook/schema/xsd/5.0/xml.xsd" \
197 /etc/xml/docbook-5.0 &amp;&amp;
198
199xmlcatalog --noout --add "uri" \
200 "http://www.oasis-open.org/docbook/xml/5.0/sch/docbook.sch" \
201 "file:///usr/share/xml/docbook/schema/sch/5.0/docbook.sch" \
202 /etc/xml/docbook-5.0 &amp;&amp;
203xmlcatalog --noout --add "uri" \
204 "http://docbook.org/xml/5.0/sch/docbook.sch" \
205 "file:///usr/share/xml/docbook/schema/sch/5.0/docbook.sch" \
206 /etc/xml/docbook-5.0</userinput></screen>
207
208
209 <para>
210 While again as the <systemitem class="username">root</systemitem> user,
211 create the individual catalogs:
212 </para>
213
214<screen role="root"><userinput>xmlcatalog --noout --create /usr/share/xml/docbook/schema/dtd/5.0/catalog.xml &amp;&amp;
215
216xmlcatalog --noout --add "public" \
217 "-//OASIS//DTD DocBook XML 5.0//EN" \
218 "docbook.dtd" /usr/share/xml/docbook/schema/dtd/5.0/catalog.xml &amp;&amp;
219xmlcatalog --noout --add "system" \
220 "http://www.oasis-open.org/docbook/xml/5.0/dtd/docbook.dtd" \
221 "docbook.dtd" /usr/share/xml/docbook/schema/dtd/5.0/catalog.xml &amp;&amp;
222
223xmlcatalog --noout --create /usr/share/xml/docbook/schema/rng/5.0/catalog.xml &amp;&amp;
224xmlcatalog --noout --add "uri" \
225 "http://docbook.org/xml/5.0/rng/docbook.rng" \
226 "docbook.rng" /usr/share/xml/docbook/schema/rng/5.0/catalog.xml &amp;&amp;
227xmlcatalog --noout --add "uri" \
228 "http://www.oasis-open.org/docbook/xml/5.0/rng/docbook.rng" \
229 "docbook.rng" /usr/share/xml/docbook/schema/rng/5.0/catalog.xml &amp;&amp;
230xmlcatalog --noout --add "uri" \
231 "http://docbook.org/xml/5.0/rng/docbookxi.rng" \
232 "docbookxi.rng" /usr/share/xml/docbook/schema/rng/5.0/catalog.xml &amp;&amp;
233xmlcatalog --noout --add "uri" \
234 "http://www.oasis-open.org/docbook/xml/5.0/rng/docbookxi.rng" \
235 "docbookxi.rng" /usr/share/xml/docbook/schema/rng/5.0/catalog.xml &amp;&amp;
236xmlcatalog --noout --add "uri" \
237 "http://docbook.org/xml/5.0/rng/docbook.rnc" \
238 "docbook.rnc" /usr/share/xml/docbook/schema/rng/5.0/catalog.xml &amp;&amp;
239xmlcatalog --noout --add "uri" \
240 "http://www.oasis-open.org/docbook/xml/5.0/rng/docbook.rnc" \
241 "docbook.rnc" /usr/share/xml/docbook/schema/rng/5.0/catalog.xml &amp;&amp;
242xmlcatalog --noout --add "uri" \
243 "http://docbook.org/xml/5.0/rng/docbookxi.rnc" \
244 "docbookxi.rnc" /usr/share/xml/docbook/schema/rng/5.0/catalog.xml &amp;&amp;
245xmlcatalog --noout --add "uri" \
246 "http://www.oasis-open.org/docbook/xml/5.0/rng/docbookxi.rnc" \
247 "docbookxi.rnc" /usr/share/xml/docbook/schema/rng/5.0/catalog.xml &amp;&amp;
248
249xmlcatalog --noout --create /usr/share/xml/docbook/schema/sch/5.0/catalog.xml &amp;&amp;
250xmlcatalog --noout --add "uri" \
251 "http://docbook.org/xml/5.0/sch/docbook.sch" \
252 "docbook.sch" /usr/share/xml/docbook/schema/sch/5.0/catalog.xml &amp;&amp;
253xmlcatalog --noout --add "uri" \
254 "http://www.oasis-open.org/docbook/xml/5.0/sch/docbook.sch" \
255 "docbook.sch" /usr/share/xml/docbook/schema/sch/5.0/catalog.xml &amp;&amp;
256
257xmlcatalog --noout --create /usr/share/xml/docbook/schema/xsd/5.0/catalog.xml &amp;&amp;
258xmlcatalog --noout --add "uri" \
259 "http://docbook.org/xml/5.0/xsd/docbook.xsd" \
260 "docbook.xsd" /usr/share/xml/docbook/schema/xsd/5.0/catalog.xml &amp;&amp;
261xmlcatalog --noout --add "uri" \
262 "http://www.oasis-open.org/docbook/xml/5.0/xsd/docbook.xsd" \
263 "docbook.xsd" /usr/share/xml/docbook/schema/xsd/5.0/catalog.xml &amp;&amp;
264xmlcatalog --noout --add "uri" \
265 "http://docbook.org/xml/5.0/xsd/docbookxi.xsd" \
266 "docbookxi.xsd" /usr/share/xml/docbook/schema/xsd/5.0/catalog.xml &amp;&amp;
267xmlcatalog --noout --add "uri" \
268 "http://www.oasis-open.org/docbook/xml/5.0/xsd/docbookxi.xsd" \
269 "docbookxi.xsd" /usr/share/xml/docbook/schema/xsd/5.0/catalog.xml &amp;&amp;
270xmlcatalog --noout --add "uri" \
271 "http://docbook.org/xml/5.0/xsd/xlink.xsd" \
272 "xlink.xsd" /usr/share/xml/docbook/schema/xsd/5.0/catalog.xml &amp;&amp;
273xmlcatalog --noout --add "uri" \
274 "http://www.oasis-open.org/docbook/xml/5.0/xsd/xlink.xsd" \
275 "xlink.xsd" /usr/share/xml/docbook/schema/xsd/5.0/catalog.xml &amp;&amp;
276xmlcatalog --noout --add "uri" \
277 "http://docbook.org/xml/5.0/xsd/xml.xsd" \
278 "xml.xsd" /usr/share/xml/docbook/schema/xsd/5.0/catalog.xml &amp;&amp;
279xmlcatalog --noout --add "uri" \
280 "http://www.oasis-open.org/docbook/xml/5.0/xsd/xml.xsd" \
281 "xml.xsd" /usr/share/xml/docbook/schema/xsd/5.0/catalog.xml</userinput></screen>
282
283 <para>
284 Create (or update) and populate the system XML catalog
285 (<filename>/etc/xml/catalog</filename>) by running the
286 following commands as the <systemitem class="username">root</systemitem>
287 user:
288 </para>
289
290<screen role="root"><userinput>if [ ! -e /etc/xml/catalog ]; then
291 xmlcatalog --noout --create /etc/xml/catalog
292fi &amp;&amp;
293xmlcatalog --noout --add "delegatePublic" \
294 "-//OASIS//DTD DocBook XML 5.0//EN" \
295 "file:///usr/share/xml/docbook/schema/dtd/5.0/catalog.xml" \
296 /etc/xml/catalog &amp;&amp;
297xmlcatalog --noout --add "delegateSystem" \
298 "http://docbook.org/xml/5.0/dtd/" \
299 "file:///usr/share/xml/docbook/schema/dtd/5.0/catalog.xml" \
300 /etc/xml/catalog &amp;&amp;
301xmlcatalog --noout --add "delegateURI" \
302 "http://docbook.org/xml/5.0/dtd/" \
303 "file:///usr/share/xml/docbook/schema/dtd/5.0/catalog.xml" \
304 /etc/xml/catalog &amp;&amp;
305xmlcatalog --noout --add "delegateURI" \
306 "http://docbook.org/xml/5.0/rng/" \
307 "file:///usr/share/xml/docbook/schema/rng/5.0/catalog.xml" \
308 /etc/xml/catalog &amp;&amp;
309xmlcatalog --noout --add "delegateURI" \
310 "http://docbook.org/xml/5.0/sch/" \
311 "file:///usr/share/xml/docbook/schema/sch/5.0/catalog.xml" \
312 /etc/xml/catalog &amp;&amp;
313xmlcatalog --noout --add "delegateURI" \
314 "http://docbook.org/xml/5.0/xsd/" \
315 "file:///usr/share/xml/docbook/schema/xsd/5.0/catalog.xml" \
316 /etc/xml/catalog</userinput></screen>
317
318 </sect2>
319
320 <sect2 role="configuration">
321 <title>Configuring DocBook XML DTD and Schemas 5.0</title>
322
323 <sect3 id="docbook5-config">
324 <title>Config Files</title>
325
[fa3edfef]326 <para>
327 <filename>/etc/xml/catalog</filename> and
328 <filename>/etc/xml/docbook-5.0</filename>
329 </para>
[f6be42d]330
331 <indexterm zone="docbook5 docbook-config">
332 <primary sortas="e-etc-xml-docbook5">/etc/xml/docbook-5.0</primary>
333 </indexterm>
334
335 <indexterm zone="docbook5 docbook-config">
336 <primary sortas="e-etc-xml-catalog5">/etc/xml/catalog</primary>
337 </indexterm>
338
339 </sect3>
340
341 </sect2>
342
343 <sect2 role="content">
344 <title>Contents</title>
345
346 <segmentedlist>
347 <segtitle>Installed Files</segtitle>
348 <segtitle>Installed Directories</segtitle>
349
350 <seglistitem>
351 <seg>DTD, RNC, RNG, SCH and XSD files</seg>
352 <seg>/etc/xml and /usr/share/xml/docbook/schema/{dtd,rng,sch,xsd}/5.0</seg>
353 </seglistitem>
354 </segmentedlist>
355
356 <variablelist>
357 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
358 <?dbfo list-presentation="list"?>
359 <?dbhtml list-presentation="table"?>
360
361 <varlistentry id="DTD5-files">
362 <term><filename>DTD files</filename></term>
363 <listitem>
364 <para>
365 contain the DocBook 5.0 document type definitions which define the
366 element types and the attribute lists that can be used in the
[4c24eb0a]367 corresponding <filename>XML</filename> files
[f6be42d]368 </para>
369 <indexterm zone="docbook5 DTD5-files">
370 <primary sortas="g-XML-DTD-files">XML DTD Files</primary>
371 </indexterm>
372 </listitem>
373 </varlistentry>
374
375 <varlistentry id="Schema5-files">
376 <term><filename>RNC, RNG, and SCH files</filename></term>
377 <listitem>
378 <para>
379 contain the Docbook 5.0 RelaxNG, RelaxNG Compact, and Schematron
[4c24eb0a]380 schema definitions
[f6be42d]381 </para>
382 <indexterm zone="docbook5 Schema5-files">
383 <primary sortas="g-XML-Schema-files">XML Schema files</primary>
384 </indexterm>
385 </listitem>
386 </varlistentry>
387
388 <varlistentry id="XSD5-files">
389 <term><filename>XSD files</filename></term>
390 <listitem>
[fa3edfef]391 <para>
[4c24eb0a]392 files contain DocBook-5.0 Schematron rules
[fa3edfef]393 </para>
[f6be42d]394 <indexterm zone="docbook5 XSD5-files">
395 <primary sortas="g-XML-XSD5-files">XML Schematron rules</primary>
396 </indexterm>
397 </listitem>
398 </varlistentry>
399
400 </variablelist>
401
402 </sect2>
403
404</sect1>
Note: See TracBrowser for help on using the repository browser.