source: pst/xml/docbook-45-xml.xml@ 9873d1ea

10.0 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 9873d1ea was 9873d1ea, checked in by Pierre Labastie <pieere@…>, 4 years ago

Vim-8.2.1361
boost-1.74.0
libreoffice-6.4.6.2
a few tags

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@23547 af4574ff-66df-0310-9fd7-8a98e5e911e0
  • Property mode set to 100644
File size: 11.4 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 DocBook-download-http "http://www.docbook.org/xml/&docBook-45-xml-version;/docbook-xml-&docBook-45-xml-version;.zip">
8 <!ENTITY DocBook-download-ftp " ">
9 <!ENTITY DocBook-md5sum "03083e288e87a7e829e437358da7ef9e">
10 <!ENTITY DocBook-size "96 KB">
11 <!ENTITY DocBook-buildsize "1.2 MB">
12 <!ENTITY DocBook-time "less than 0.1 SBU">
13]>
14
15<sect1 id="DocBook" xreflabel="docbook-xml-&docBook-45-xml-version;">
16 <?dbhtml filename="docbook.html"?>
17
18 <sect1info>
19 <othername>$LastChangedBy$</othername>
20 <date>$Date$</date>
21 </sect1info>
22
23 <title>docbook-xml-&docBook-45-xml-version;</title>
24
25 <indexterm zone="DocBook">
26 <primary sortas="a-DocBook-XML-DTD">DocBook XML DTD</primary>
27 </indexterm>
28
29 <sect2 role="package">
30 <title>Introduction to DocBook-4.5 XML DTD</title>
31
32 <para>
33 The <application>DocBook-4.5 XML DTD</application>-&docBook-45-xml-version;
34 package contains document type definitions for verification of XML data
35 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.
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="&DocBook-download-http;"/>
47 </para>
48 </listitem>
49 <listitem>
50 <para>
51 Download (FTP): <ulink url="&DocBook-download-ftp;"/>
52 </para>
53 </listitem>
54 <listitem>
55 <para>
56 Download MD5 sum: &DocBook-md5sum;
57 </para>
58 </listitem>
59 <listitem>
60 <para>
61 Download size: &DocBook-size;
62 </para>
63 </listitem>
64 <listitem>
65 <para>
66 Estimated disk space required: &DocBook-buildsize;
67 </para>
68 </listitem>
69 <listitem>
70 <para>
71 Estimated build time: &DocBook-time;
72 </para>
73 </listitem>
74 </itemizedlist>
75
76 <bridgehead renderas="sect3">DocBook-4.5 XML DTD 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;/docbook-xml"/></para>
87
88 </sect2>
89
90 <sect2 role="installation">
91 <title>Installation of DocBook-4.5 XML DTD</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 DTD</application> by running the
98 following commands as the <systemitem class="username">root</systemitem>
99 user:
100 </para>
101
102<screen role="root"><userinput>install -v -d -m755 /usr/share/xml/docbook/xml-dtd-&docBook-45-xml-version; &amp;&amp;
103install -v -d -m755 /etc/xml &amp;&amp;
104chown -R root:root . &amp;&amp;
105cp -v -af docbook.cat *.dtd ent/ *.mod \
106 /usr/share/xml/docbook/xml-dtd-&docBook-45-xml-version;</userinput></screen>
107
108 <para>
109 Create (or update) and populate the <filename>/etc/xml/docbook</filename>
110 catalog file by running the following
111 commands as the <systemitem class="username">root</systemitem> user:
112 </para>
113
114<screen role="root"><?dbfo keep-together="auto"?><userinput>if [ ! -e /etc/xml/docbook ]; then
115 xmlcatalog --noout --create /etc/xml/docbook
116fi &amp;&amp;
117xmlcatalog --noout --add "public" \
118 "-//OASIS//DTD DocBook XML V&docBook-45-xml-version;//EN" \
119 "http://www.oasis-open.org/docbook/xml/&docBook-45-xml-version;/docbookx.dtd" \
120 /etc/xml/docbook &amp;&amp;
121xmlcatalog --noout --add "public" \
122 "-//OASIS//DTD DocBook XML CALS Table Model V&docBook-45-xml-version;//EN" \
123 "file:///usr/share/xml/docbook/xml-dtd-&docBook-45-xml-version;/calstblx.dtd" \
124 /etc/xml/docbook &amp;&amp;
125xmlcatalog --noout --add "public" \
126 "-//OASIS//DTD XML Exchange Table Model 19990315//EN" \
127 "file:///usr/share/xml/docbook/xml-dtd-&docBook-45-xml-version;/soextblx.dtd" \
128 /etc/xml/docbook &amp;&amp;
129xmlcatalog --noout --add "public" \
130 "-//OASIS//ELEMENTS DocBook XML Information Pool V&docBook-45-xml-version;//EN" \
131 "file:///usr/share/xml/docbook/xml-dtd-&docBook-45-xml-version;/dbpoolx.mod" \
132 /etc/xml/docbook &amp;&amp;
133xmlcatalog --noout --add "public" \
134 "-//OASIS//ELEMENTS DocBook XML Document Hierarchy V&docBook-45-xml-version;//EN" \
135 "file:///usr/share/xml/docbook/xml-dtd-&docBook-45-xml-version;/dbhierx.mod" \
136 /etc/xml/docbook &amp;&amp;
137xmlcatalog --noout --add "public" \
138 "-//OASIS//ELEMENTS DocBook XML HTML Tables V&docBook-45-xml-version;//EN" \
139 "file:///usr/share/xml/docbook/xml-dtd-&docBook-45-xml-version;/htmltblx.mod" \
140 /etc/xml/docbook &amp;&amp;
141xmlcatalog --noout --add "public" \
142 "-//OASIS//ENTITIES DocBook XML Notations V&docBook-45-xml-version;//EN" \
143 "file:///usr/share/xml/docbook/xml-dtd-&docBook-45-xml-version;/dbnotnx.mod" \
144 /etc/xml/docbook &amp;&amp;
145xmlcatalog --noout --add "public" \
146 "-//OASIS//ENTITIES DocBook XML Character Entities V&docBook-45-xml-version;//EN" \
147 "file:///usr/share/xml/docbook/xml-dtd-&docBook-45-xml-version;/dbcentx.mod" \
148 /etc/xml/docbook &amp;&amp;
149xmlcatalog --noout --add "public" \
150 "-//OASIS//ENTITIES DocBook XML Additional General Entities V&docBook-45-xml-version;//EN" \
151 "file:///usr/share/xml/docbook/xml-dtd-&docBook-45-xml-version;/dbgenent.mod" \
152 /etc/xml/docbook &amp;&amp;
153xmlcatalog --noout --add "rewriteSystem" \
154 "http://www.oasis-open.org/docbook/xml/&docBook-45-xml-version;" \
155 "file:///usr/share/xml/docbook/xml-dtd-&docBook-45-xml-version;" \
156 /etc/xml/docbook &amp;&amp;
157xmlcatalog --noout --add "rewriteURI" \
158 "http://www.oasis-open.org/docbook/xml/&docBook-45-xml-version;" \
159 "file:///usr/share/xml/docbook/xml-dtd-&docBook-45-xml-version;" \
160 /etc/xml/docbook</userinput></screen>
161
162 <para>
163 Create (or update) and populate the
164 <filename>/etc/xml/catalog</filename> catalog file by running the
165 following commands as the <systemitem class="username">root</systemitem>
166 user:
167 </para>
168
169<screen role="root"><userinput>if [ ! -e /etc/xml/catalog ]; then
170 xmlcatalog --noout --create /etc/xml/catalog
171fi &amp;&amp;
172xmlcatalog --noout --add "delegatePublic" \
173 "-//OASIS//ENTITIES DocBook XML" \
174 "file:///etc/xml/docbook" \
175 /etc/xml/catalog &amp;&amp;
176xmlcatalog --noout --add "delegatePublic" \
177 "-//OASIS//DTD DocBook XML" \
178 "file:///etc/xml/docbook" \
179 /etc/xml/catalog &amp;&amp;
180xmlcatalog --noout --add "delegateSystem" \
181 "http://www.oasis-open.org/docbook/" \
182 "file:///etc/xml/docbook" \
183 /etc/xml/catalog &amp;&amp;
184xmlcatalog --noout --add "delegateURI" \
185 "http://www.oasis-open.org/docbook/" \
186 "file:///etc/xml/docbook" \
187 /etc/xml/catalog</userinput></screen>
188
189 </sect2>
190
191 <sect2 role="configuration">
192 <title>Configuring DocBook-4.5 XML DTD</title>
193
194 <sect3 id="docbook-config">
195 <title>Config Files</title>
196
197 <para>
198 <filename>/etc/xml/catalog</filename> and
199 <filename>/etc/xml/docbook</filename>
200 </para>
201
202 <indexterm zone="DocBook docbook-config">
203 <primary sortas="e-etc-xml-docbook">/etc/xml/docbook</primary>
204 </indexterm>
205
206 <indexterm zone="DocBook docbook-config">
207 <primary sortas="e-etc-xml-catalog">/etc/xml/catalog</primary>
208 </indexterm>
209
210 </sect3>
211
212 <sect3>
213 <title>Configuration Information</title>
214
215 <para>
216 The above installation creates the files and updates the catalogs.
217 In order to utilize <application>DocBook XML DTD</application>
218 V&docBook-45-xml-version; when any version 4.x is requested in the System
219 Identifier, you need to add additional statements to the catalog
220 files. If you have any of the <application>DocBook XML
221 DTD</application>'s referenced below already installed on your
222 system, remove those entries from the <command>for</command> command
223 below (issue the commands as the <systemitem
224 class="username">root</systemitem> user):
225 </para>
226
227<screen role="root"><userinput>for DTDVERSION in 4.1.2 4.2 4.3 4.4
228do
229 xmlcatalog --noout --add "public" \
230 "-//OASIS//DTD DocBook XML V$DTDVERSION//EN" \
231 "http://www.oasis-open.org/docbook/xml/$DTDVERSION/docbookx.dtd" \
232 /etc/xml/docbook
233 xmlcatalog --noout --add "rewriteSystem" \
234 "http://www.oasis-open.org/docbook/xml/$DTDVERSION" \
235 "file:///usr/share/xml/docbook/xml-dtd-&docBook-45-xml-version;" \
236 /etc/xml/docbook
237 xmlcatalog --noout --add "rewriteURI" \
238 "http://www.oasis-open.org/docbook/xml/$DTDVERSION" \
239 "file:///usr/share/xml/docbook/xml-dtd-&docBook-45-xml-version;" \
240 /etc/xml/docbook
241 xmlcatalog --noout --add "delegateSystem" \
242 "http://www.oasis-open.org/docbook/xml/$DTDVERSION/" \
243 "file:///etc/xml/docbook" \
244 /etc/xml/catalog
245 xmlcatalog --noout --add "delegateURI" \
246 "http://www.oasis-open.org/docbook/xml/$DTDVERSION/" \
247 "file:///etc/xml/docbook" \
248 /etc/xml/catalog
249done</userinput></screen>
250
251 </sect3>
252
253 </sect2>
254
255 <sect2 role="content">
256 <title>Contents</title>
257
258 <segmentedlist>
259 <segtitle>Installed Programs</segtitle>
260 <segtitle>Installed Libraries</segtitle>
261 <segtitle>Installed Files</segtitle>
262 <segtitle>Installed Directories</segtitle>
263
264 <seglistitem>
265 <seg>None</seg>
266 <seg>None</seg>
267 <seg>DTD, MOD and ENT files</seg>
268 <seg>/etc/xml and /usr/share/xml/docbook/xml-dtd-&docBook-45-xml-version;</seg>
269 </seglistitem>
270 </segmentedlist>
271
272 <variablelist>
273 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
274 <?dbfo list-presentation="list"?>
275 <?dbhtml list-presentation="table"?>
276
277 <varlistentry id="DTD-files">
278 <term><filename>DTD files</filename></term>
279 <listitem>
280 <para>
281 contain a document type definition which defines the element
282 types and the attribute lists that can be used in the corresponding
283 <filename>XML</filename> files.
284 </para>
285 <indexterm zone="DocBook DTD-files">
286 <primary sortas="g-XML-DTD-files">XML DTD Files</primary>
287 </indexterm>
288 </listitem>
289 </varlistentry>
290
291 <varlistentry id="MOD-files">
292 <term><filename>MOD files</filename></term>
293 <listitem>
294 <para>
295 contain components of the document type definition that
296 are sourced into the <filename>DTD</filename> files.
297 </para>
298 <indexterm zone="DocBook MOD-files">
299 <primary sortas="g-XML-MOD-files">XML MOD files</primary>
300 </indexterm>
301 </listitem>
302 </varlistentry>
303
304 <varlistentry id="ENT-files">
305 <term><filename>ENT files</filename></term>
306 <listitem>
307 <para>
308 contain lists of named character entities allowed in HTML.
309 </para>
310 <indexterm zone="DocBook ENT-files">
311 <primary sortas="g-XML-ENT-files">XML entity files</primary>
312 </indexterm>
313 </listitem>
314 </varlistentry>
315
316 </variablelist>
317
318 </sect2>
319
320</sect1>
Note: See TracBrowser for help on using the repository browser.