source: pst/xml/docbook5.xml@ 63a0217

11.0 11.1 lazarus qt5new trunk upgradedb xry111/intltool xry111/test-20220226
Last change on this file since 63a0217 was 45ab6c7, checked in by Xi Ruoyao <xry111@…>, 13 months ago

more SVN prop clean up

Remove "$LastChanged$" everywhere, and also some unused $Date$

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