source: pst/xml/docbook5.xml@ f862f7c0

12.0 12.1 kea ken/TL2024 ken/tuningfonts lazarus lxqt plabs/newcss python3.11 qt5new rahul/power-profiles-daemon renodr/vulkan-addition trunk xry111/llvm18 xry111/xf86-video-removal
Last change on this file since f862f7c0 was d0caf17a, checked in by Bruce Dubbs <bdubbs@…>, 15 months ago

Still more tags

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