source: pst/xml/docbook51.xml@ 3eeb0ce7

10.0 10.1 11.0 11.1 11.2 lazarus plabs/python-mods qt5new trunk upgradedb xry111/intltool xry111/soup3 xry111/test-20220226
Last change on this file since 3eeb0ce7 was 3eeb0ce7, checked in by Bruce Dubbs <bdubbs@…>, 2 years ago

Finish tagging pst packages
Archive a2ps and psutils

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

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