source: pst/xml/docbook5.xml@ f3d413ca

10.1 11.0 11.1 11.2 11.3 12.0 12.1 kea ken/TL2024 ken/inkscape-core-mods ken/tuningfonts lazarus lxqt plabs/newcss plabs/python-mods python3.11 qt5new rahul/power-profiles-daemon renodr/vulkan-addition trunk upgradedb xry111/intltool xry111/llvm18 xry111/soup3 xry111/test-20220226 xry111/xf86-video-removal
Last change on this file since f3d413ca was f3d413ca, checked in by Bruce Dubbs <bdubbs@…>, 3 years ago

Tags for editors and typesetting

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@24268 af4574ff-66df-0310-9fd7-8a98e5e911e0

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