source: pst/xml/docbook51.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@…>, 16 months ago

more SVN prop clean up

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

  • Property mode set to 100644
File size: 11.8 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 docbook51-download-http "https://docbook.org/xml/5.1/docbook-v5.1-os.zip">
8 <!ENTITY docbook51-download-ftp " ">
9 <!ENTITY docbook51-md5sum "d8bea8ddfc5743578a31cb18f9ae1f5a">
10 <!ENTITY docbook51-size "752 KB">
11 <!ENTITY docbook51-buildsize "8.5 MB">
12 <!ENTITY docbook51-time "less than 0.1 SBU">
13]>
14
15<sect1 id="docbook51" xreflabel="docbook-xml-5.1">
16 <?dbhtml filename="docbook51.html"?>
17
18 <sect1info>
19 <date>$Date$</date>
20 </sect1info>
21
22 <title>docbook-xml-5.1</title>
23
24 <indexterm zone="docbook51">
25 <primary sortas="a-DocBook51-XML-DTD">DocBook XML Schemas 5.1</primary>
26 </indexterm>
27
28 <sect2 role="package">
29 <title>Introduction to DocBook XML Schemas 5.1</title>
30
31 <para>
32 The <application>DocBook XML Schemas</application>-5.1 package
33 contains schema files and Schematron rules for verification of XML data
34 files against the DocBook rule set. These are useful for structuring books
35 and software documentation to a standard allowing you to utilize
36 transformations already written for that standard.
37 </para>
38
39 &lfs101_checked;
40
41 <bridgehead renderas="sect3">Package Information</bridgehead>
42 <itemizedlist spacing="compact">
43 <listitem>
44 <para>
45 Download (HTTP): <ulink url="&docbook51-download-http;"/>
46 </para>
47 </listitem>
48 <listitem>
49 <para>
50 Download (FTP): <ulink url="&docbook51-download-ftp;"/>
51 </para>
52 </listitem>
53 <listitem>
54 <para>
55 Download MD5 sum: &docbook51-md5sum;
56 </para>
57 </listitem>
58 <listitem>
59 <para>
60 Download size: &docbook51-size;
61 </para>
62 </listitem>
63 <listitem>
64 <para>
65 Estimated disk space required: &docbook51-buildsize;
66 </para>
67 </listitem>
68 <listitem>
69 <para>
70 Estimated build time: &docbook51-time;
71 </para>
72 </listitem>
73 </itemizedlist>
74
75 <bridgehead renderas="sect3">DocBook XML Schemas 5.1 Dependencies</bridgehead>
76
77 <bridgehead renderas="sect4">Required</bridgehead>
78 <para role="required">
79 <xref linkend="libxml2"/>,
80 <xref linkend="sgml-common"/>, and
81 <xref linkend="unzip"/>
82 </para>
83
84 <para condition="html" role="usernotes">User Notes:
85 <ulink url="&blfs-wiki;/docbook51-xml"/></para>
86
87 </sect2>
88
89 <sect2 role="installation">
90 <title>Installation of DocBook XML Schemas 5.1</title>
91
92 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
93 href="../../xincludes/use-unzip.xml"/>
94
95 <para>
96 Install <application>DocBook XML 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/{rng,sch}/5.1 &amp;&amp;
102install -m644 schemas/rng/* /usr/share/xml/docbook/schema/rng/5.1 &amp;&amp;
103install -m644 schemas/sch/* /usr/share/xml/docbook/schema/sch/5.1 &amp;&amp;
104install -m755 tools/db4-entities.pl /usr/bin &amp;&amp;
105install -vdm755 /usr/share/xml/docbook/stylesheet/docbook5 &amp;&amp;
106install -m644 tools/db4-upgrade.xsl \
107 /usr/share/xml/docbook/stylesheet/docbook5</userinput></screen>
108
109 <para>
110 Create (or update) and populate the
111 <filename>/etc/xml/docbook-5.1</filename> catalog file by running the
112 following commands as the <systemitem class="username">root</systemitem>
113 user:
114 </para>
115
116<screen role="root"><?dbfo keep-together="auto"?><userinput>if [ ! -e /etc/xml/docbook-5.1 ]; then
117 xmlcatalog --noout --create /etc/xml/docbook-5.1
118fi &amp;&amp;
119
120xmlcatalog --noout --add "uri" \
121 "http://www.oasis-open.org/docbook/xml/5.1/rng/docbook.rng" \
122 "file:///usr/share/xml/docbook/schema/rng/5.1/docbook.rng" \
123 /etc/xml/docbook-5.1 &amp;&amp;
124xmlcatalog --noout --add "uri" \
125 "http://docbook.org/xml/5.1/rng/docbook.rng" \
126 "file:///usr/share/xml/docbook/schema/rng/5.1/docbook.rng" \
127 /etc/xml/docbook-5.1 &amp;&amp;
128xmlcatalog --noout --add "uri" \
129 "http://www.oasis-open.org/docbook/xml/5.1/rng/docbookxi.rng" \
130 "file:///usr/share/xml/docbook/schema/rng/5.1/docbookxi.rng" \
131 /etc/xml/docbook-5.1 &amp;&amp;
132xmlcatalog --noout --add "uri" \
133 "http://docbook.org/xml/5.1/rng/docbookxi.rng" \
134 "file:///usr/share/xml/docbook/schema/rng/5.1/docbookxi.rng" \
135 /etc/xml/docbook-5.1 &amp;&amp;
136xmlcatalog --noout --add "uri" \
137 "http://www.oasis-open.org/docbook/xml/5.1/rnc/docbook.rnc" \
138 "file:///usr/share/xml/docbook/schema/rng/5.1/docbook.rnc" \
139 /etc/xml/docbook-5.1 &amp;&amp;
140xmlcatalog --noout --add "uri" \
141 "http://docbook.org/xml/5.1/rng/docbook.rnc" \
142 "file:///usr/share/xml/docbook/schema/rng/5.1/docbook.rnc" \
143 /etc/xml/docbook-5.1 &amp;&amp;
144xmlcatalog --noout --add "uri" \
145 "http://www.oasis-open.org/docbook/xml/5.1/rnc/docbookxi.rnc" \
146 "file:///usr/share/xml/docbook/schema/rng/5.1/docbookxi.rnc" \
147 /etc/xml/docbook-5.1 &amp;&amp;
148xmlcatalog --noout --add "uri" \
149 "http://docbook.org/xml/5.1/rng/docbookxi.rnc" \
150 "file:///usr/share/xml/docbook/schema/rng/5.1/docbookxi.rnc" \
151 /etc/xml/docbook-5.1 &amp;&amp;
152
153xmlcatalog --noout --add "uri" \
154 "http://www.oasis-open.org/docbook/xml/5.1/sch/docbook.sch" \
155 "file:///usr/share/xml/docbook/schema/sch/5.1/docbook.sch" \
156 /etc/xml/docbook-5.1 &amp;&amp;
157xmlcatalog --noout --add "uri" \
158 "http://docbook.org/xml/5.1/sch/docbook.sch" \
159 "file:///usr/share/xml/docbook/schema/sch/5.1/docbook.sch" \
160 /etc/xml/docbook-5.1</userinput></screen>
161
162
163 <para>
164 While again as the <systemitem class="username">root</systemitem> user,
165 create the individual catalogs:
166 </para>
167
168<screen role="root"><userinput>xmlcatalog --noout --create /usr/share/xml/docbook/schema/rng/5.1/catalog.xml &amp;&amp;
169
170xmlcatalog --noout --add "uri" \
171 "http://docbook.org/xml/5.1/schemas/rng/docbook.schemas/rng" \
172 "docbook.schemas/rng" /usr/share/xml/docbook/schema/rng/5.1/catalog.xml &amp;&amp;
173xmlcatalog --noout --add "uri" \
174 "http://www.oasis-open.org/docbook/xml/5.1/schemas/rng/docbook.schemas/rng" \
175 "docbook.schemas/rng" /usr/share/xml/docbook/schema/rng/5.1/catalog.xml &amp;&amp;
176xmlcatalog --noout --add "uri" \
177 "http://docbook.org/xml/5.1/schemas/rng/docbookxi.schemas/rng" \
178 "docbookxi.schemas/rng" /usr/share/xml/docbook/schema/rng/5.1/catalog.xml &amp;&amp;
179xmlcatalog --noout --add "uri" \
180 "http://www.oasis-open.org/docbook/xml/5.1/schemas/rng/docbookxi.schemas/rng" \
181 "docbookxi.schemas/rng" /usr/share/xml/docbook/schema/rng/5.1/catalog.xml &amp;&amp;
182xmlcatalog --noout --add "uri" \
183 "http://docbook.org/xml/5.1/schemas/rng/docbook.rnc" \
184 "docbook.rnc" /usr/share/xml/docbook/schema/rng/5.1/catalog.xml &amp;&amp;
185xmlcatalog --noout --add "uri" \
186 "http://www.oasis-open.org/docbook/xml/5.1/schemas/rng/docbook.rnc" \
187 "docbook.rnc" /usr/share/xml/docbook/schema/rng/5.1/catalog.xml &amp;&amp;
188xmlcatalog --noout --add "uri" \
189 "http://docbook.org/xml/5.1/schemas/rng/docbookxi.rnc" \
190 "docbookxi.rnc" /usr/share/xml/docbook/schema/rng/5.1/catalog.xml &amp;&amp;
191xmlcatalog --noout --add "uri" \
192 "http://www.oasis-open.org/docbook/xml/5.1/schemas/rng/docbookxi.rnc" \
193 "docbookxi.rnc" /usr/share/xml/docbook/schema/rng/5.1/catalog.xml
194xmlcatalog --noout --create /usr/share/xml/docbook/schema/sch/5.1/catalog.xml &amp;&amp;
195
196xmlcatalog --noout --add "uri" \
197 "http://docbook.org/xml/5.1/schemas/sch/docbook.schemas/sch" \
198 "docbook.schemas/sch" /usr/share/xml/docbook/schema/sch/5.1/catalog.xml &amp;&amp;
199xmlcatalog --noout --add "uri" \
200 "http://www.oasis-open.org/docbook/xml/5.1/schemas/sch/docbook.schemas/sch" \
201 "docbook.schemas/sch" /usr/share/xml/docbook/schema/sch/5.1/catalog.xml</userinput></screen>
202
203 <para>
204 Create (or update) and populate the system XML catalog
205 (<filename>/etc/xml/catalog</filename>) by running the
206 following commands as the <systemitem class="username">root</systemitem>
207 user:
208 </para>
209
210<screen role="root"><userinput>if [ ! -e /etc/xml/catalog ]; then
211 xmlcatalog --noout --create /etc/xml/catalog
212fi &amp;&amp;
213xmlcatalog --noout --add "delegatePublic" \
214 "-//OASIS//DTD DocBook XML 5.1//EN" \
215 "file:///usr/share/xml/docbook/schema/dtd/5.1/catalog.xml" \
216 /etc/xml/catalog &amp;&amp;
217xmlcatalog --noout --add "delegateSystem" \
218 "http://docbook.org/xml/5.1/dtd/" \
219 "file:///usr/share/xml/docbook/schema/dtd/5.1/catalog.xml" \
220 /etc/xml/catalog &amp;&amp;
221xmlcatalog --noout --add "delegateURI" \
222 "http://docbook.org/xml/5.1/dtd/" \
223 "file:///usr/share/xml/docbook/schema/dtd/5.1/catalog.xml" \
224 /etc/xml/catalog &amp;&amp;
225xmlcatalog --noout --add "delegateURI" \
226 "http://docbook.org/xml/5.1/rng/" \
227 "file:///usr/share/xml/docbook/schema/rng/5.1/catalog.xml" \
228 /etc/xml/catalog &amp;&amp;
229xmlcatalog --noout --add "delegateURI" \
230 "http://docbook.org/xml/5.1/sch/" \
231 "file:///usr/share/xml/docbook/schema/sch/5.1/catalog.xml" \
232 /etc/xml/catalog &amp;&amp;
233xmlcatalog --noout --add "delegateURI" \
234 "http://docbook.org/xml/5.1/xsd/" \
235 "file:///usr/share/xml/docbook/schema/xsd/5.1/catalog.xml" \
236 /etc/xml/catalog</userinput></screen>
237
238 </sect2>
239
240 <sect2 role="configuration">
241 <title>Configuring DocBook XML Schemas 5.1</title>
242
243 <sect3 id="docbook51-config">
244 <title>Config Files</title>
245
246 <para>
247 <filename>/etc/xml/catalog</filename> and
248 <filename>/etc/xml/docbook-5.1</filename>
249 </para>
250
251 <indexterm zone="docbook51 docbook-config">
252 <primary sortas="e-etc-xml-docbook51">/etc/xml/docbook-5.1</primary>
253 </indexterm>
254
255 <indexterm zone="docbook51 docbook-config">
256 <primary sortas="e-etc-xml-catalog51">/etc/xml/catalog</primary>
257 </indexterm>
258
259 </sect3>
260
261 </sect2>
262
263 <sect2 role="content">
264 <title>Contents</title>
265
266 <segmentedlist>
267 <segtitle>Installed Programs</segtitle>
268 <segtitle>Installed Files</segtitle>
269 <segtitle>Installed Directories</segtitle>
270
271 <seglistitem>
272 <seg>db4-entities.pl</seg>
273 <seg>RNC, RNG, SCH, and XSL files</seg>
274 <seg>/etc/xml, /usr/share/xml/docbook/stylesheets, and
275 /usr/share/xml/docbook/schema/{rng,sch}/5.1</seg>
276 </seglistitem>
277 </segmentedlist>
278
279 <variablelist>
280 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
281 <?dbfo list-presentation="list"?>
282 <?dbhtml list-presentation="table"?>
283
284 <varlistentry id="db4-entries-pl">
285 <term><filename>db4-entities.pl</filename></term>
286 <listitem>
287 <para>
288 is a script to convert DocBook 4.x filed to DocBook 5.1
289 </para>
290 <indexterm zone="docbook51 db4-entries-pl">
291 <primary sortas="b-db4-entries-pl">db4-entities.pl</primary>
292 </indexterm>
293 </listitem>
294 </varlistentry>
295
296 <varlistentry id="Schema51-files">
297 <term><filename>RNC, RNG, and SCH files</filename></term>
298 <listitem>
299 <para>
300 contain the Docbook 5.1 RelaxNG, RelaxNG Compact, and Schematron
301 schema definitions
302 </para>
303 <indexterm zone="docbook51 Schema51-files">
304 <primary sortas="g-XML-Schema-files">XML Schema files</primary>
305 </indexterm>
306 </listitem>
307 </varlistentry>
308
309 <varlistentry id="db4-upgrade-xsl">
310 <term><filename>db4-upgrade.xsl</filename></term>
311 <listitem>
312 <para>
313 is an XSL stylesheet to assist in conversion from DocBook 4.x files
314 to DocBook 5.1
315 </para>
316 <indexterm zone="docbook51 db4-upgrade-xsl">
317 <primary sortas="g-XSL-Stylesheets">XSL Stylesheets</primary>
318 </indexterm>
319 </listitem>
320 </varlistentry>
321
322 </variablelist>
323
324 </sect2>
325
326</sect1>
Note: See TracBrowser for help on using the repository browser.