source: pst/xml/docbook5.xml@ 6e1336bb

12.2 trunk
Last change on this file since 6e1336bb was 84e2517b, checked in by Xi Ruoyao <xry111@…>, 4 weeks ago

docbook-xml-*: Remove dependencies on sgml-common

I cannot see why they need sgml-common. They install fine without
sgml-common (so at least sgml-common should be demoted to "runtime") and
both LFS and BLFS (based on docbook-xml-4.5) render fine without
sgml-common.

Per Arch no versions of docbook-xml need sgml-common.

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