source: pst/xml/docbook.xml@ f1c4e895

10.0 10.1 11.0 11.1 11.2 11.3 12.0 12.1 6.2 6.2.0 6.2.0-rc1 6.2.0-rc2 6.3 6.3-rc1 6.3-rc2 6.3-rc3 7.10 7.4 7.5 7.6 7.6-blfs 7.6-systemd 7.7 7.8 7.9 8.0 8.1 8.2 8.3 8.4 9.0 9.1 basic bdubbs/svn elogind gnome kde5-13430 kde5-14269 kde5-14686 kea ken/TL2024 ken/inkscape-core-mods ken/tuningfonts krejzi/svn lazarus lxqt nosym perl-modules plabs/newcss plabs/python-mods python3.11 qt5new rahul/power-profiles-daemon renodr/vulkan-addition systemd-11177 systemd-13485 trunk upgradedb xry111/intltool xry111/llvm18 xry111/soup3 xry111/test-20220226 xry111/xf86-video-removal
Last change on this file since f1c4e895 was f1c4e895, checked in by Randy McMurchy <randy@…>, 19 years ago

Fixed typo in DocBook XML DTD instructions

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@4986 af4574ff-66df-0310-9fd7-8a98e5e911e0
  • Property mode set to 100644
File size: 10.7 KB
Line 
1<?xml version="1.0" encoding="ISO-8859-1"?>
2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
3 "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
4 <!ENTITY % general-entities SYSTEM "../../general.ent">
5 %general-entities;
6
7 <!ENTITY DocBook-download-http "http://www.docbook.org/xml/&DocBook-version;/docbook-xml-&DocBook-version;.zip">
8 <!ENTITY DocBook-download-ftp "ftp://ftp.fu-berlin.de/unix/linux/mirrors/gentoo/distfiles/docbook-xml-&DocBook-version;.zip">
9 <!ENTITY DocBook-md5sum "cbb04e9a700955d88c50962ef22c1634">
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 DTD-&DocBook-version;">
16 <?dbhtml filename="DocBook.html"?>
17
18 <sect1info>
19 <othername>$LastChangedBy$</othername>
20 <date>$Date$</date>
21 </sect1info>
22
23 <title>DocBook XML DTD-&DocBook-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 XML DTD</title>
31
32 <para>The <application>DocBook XML DTD</application>-&DocBook-version;
33 package contains document type definitions 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.</para>
37
38 <bridgehead renderas="sect3">Package Information</bridgehead>
39 <itemizedlist spacing="compact">
40 <listitem>
41 <para>Download (HTTP): <ulink url="&DocBook-download-http;"/></para>
42 </listitem>
43 <listitem>
44 <para>Download (FTP): <ulink url="&DocBook-download-ftp;"/></para>
45 </listitem>
46 <listitem>
47 <para>Download MD5 sum: &DocBook-md5sum;</para>
48 </listitem>
49 <listitem>
50 <para>Download size: &DocBook-size;</para>
51 </listitem>
52 <listitem>
53 <para>Estimated disk space required: &DocBook-buildsize;</para>
54 </listitem>
55 <listitem>
56 <para>Estimated build time: &DocBook-time;</para>
57 </listitem>
58 </itemizedlist>
59
60 <bridgehead renderas="sect3">DocBook XML DTD Dependencies</bridgehead>
61
62 <bridgehead renderas="sect4">Required</bridgehead>
63 <para><xref linkend="libxml2"/> and <xref linkend="unzip"/></para>
64
65 </sect2>
66
67 <sect2 role="installation">
68 <title>Installation of DocBook XML DTD</title>
69
70 <xi:include xmlns:xi="http://www.w3.org/2003/XInclude"
71 href="../../use-unzip.xml"/>
72
73 <para>Install <application>DocBook XML DTD</application> by running the
74 following commands as the <systemitem class="username">root</systemitem>
75 user:</para>
76
77<screen role="root"><userinput>install -v -d -m755 /usr/share/xml/docbook/xml-dtd-&DocBook-version; &amp;&amp;
78install -v -d -m755 /etc/xml &amp;&amp;
79chown -R root:root . &amp;&amp;
80cp -v -af docbook.cat *.dtd ent/ *.mod \
81 /usr/share/xml/docbook/xml-dtd-&DocBook-version;</userinput></screen>
82
83 <para>Create (or update) and populate the
84 <filename>/etc/xml/docbook</filename> catalog file by running the following
85 commands as the <systemitem class="username">root</systemitem> user:</para>
86
87<screen role="root"><userinput>if [ ! -e /etc/xml/docbook ]; then
88 xmlcatalog --noout --create /etc/xml/docbook
89fi &amp;&amp;
90xmlcatalog --noout --add "public" \
91 "-//OASIS//DTD DocBook XML V&DocBook-version;//EN" \
92 "http://www.oasis-open.org/docbook/xml/&DocBook-version;/docbookx.dtd" \
93 /etc/xml/docbook &amp;&amp;
94xmlcatalog --noout --add "public" \
95 "-//OASIS//DTD DocBook XML CALS Table Model V&DocBook-version;//EN" \
96 "file:///usr/share/xml/docbook/xml-dtd-&DocBook-version;/calstblx.dtd" \
97 /etc/xml/docbook &amp;&amp;
98xmlcatalog --noout --add "public" \
99 "-//OASIS//DTD XML Exchange Table Model 19990315//EN" \
100 "file:///usr/share/xml/docbook/xml-dtd-&DocBook-version;/soextblx.dtd" \
101 /etc/xml/docbook &amp;&amp;
102xmlcatalog --noout --add "public" \
103 "-//OASIS//ELEMENTS DocBook XML Information Pool V&DocBook-version;//EN" \
104 "file:///usr/share/xml/docbook/xml-dtd-&DocBook-version;/dbpoolx.mod" \
105 /etc/xml/docbook &amp;&amp;
106xmlcatalog --noout --add "public" \
107 "-//OASIS//ELEMENTS DocBook XML Document Hierarchy V&DocBook-version;//EN" \
108 "file:///usr/share/xml/docbook/xml-dtd-&DocBook-version;/dbhierx.mod" \
109 /etc/xml/docbook &amp;&amp;
110xmlcatalog --noout --add "public" \
111 "-//OASIS//ELEMENTS DocBook XML HTML Tables V&DocBook-version;//EN" \
112 "file:///usr/share/xml/docbook/xml-dtd-&DocBook-version;/htmltblx.mod" \
113 /etc/xml/docbook
114xmlcatalog --noout --add "public" \
115 "-//OASIS//ENTITIES DocBook XML Notations V&DocBook-version;//EN" \
116 "file:///usr/share/xml/docbook/xml-dtd-&DocBook-version;/dbnotnx.mod" \
117 /etc/xml/docbook &amp;&amp;
118xmlcatalog --noout --add "public" \
119 "-//OASIS//ENTITIES DocBook XML Character Entities V&DocBook-version;//EN" \
120 "file:///usr/share/xml/docbook/xml-dtd-&DocBook-version;/dbcentx.mod" \
121 /etc/xml/docbook &amp;&amp;
122xmlcatalog --noout --add "public" \
123 "-//OASIS//ENTITIES DocBook XML Additional General Entities V&DocBook-version;//EN" \
124 "file:///usr/share/xml/docbook/xml-dtd-&DocBook-version;/dbgenent.mod" \
125 /etc/xml/docbook &amp;&amp;
126xmlcatalog --noout --add "rewriteSystem" \
127 "http://www.oasis-open.org/docbook/xml/&DocBook-version;" \
128 "file:///usr/share/xml/docbook/xml-dtd-&DocBook-version;" \
129 /etc/xml/docbook &amp;&amp;
130xmlcatalog --noout --add "rewriteURI" \
131 "http://www.oasis-open.org/docbook/xml/&DocBook-version;" \
132 "file:///usr/share/xml/docbook/xml-dtd-&DocBook-version;" \
133 /etc/xml/docbook</userinput></screen>
134
135 <para>Create (or update) and populate the
136 <filename>/etc/xml/catalog</filename> catalog file by running the following
137 commands as the <systemitem class="username">root</systemitem> user:</para>
138
139<screen role="root"><userinput>if [ ! -e /etc/xml/catalog ]; then
140 xmlcatalog --noout --create /etc/xml/catalog
141fi &amp;&amp;
142xmlcatalog --noout --add "delegatePublic" \
143 "-//OASIS//ENTITIES DocBook XML" \
144 "file:///etc/xml/docbook" \
145 /etc/xml/catalog &amp;&amp;
146xmlcatalog --noout --add "delegatePublic" \
147 "-//OASIS//DTD DocBook XML" \
148 "file:///etc/xml/docbook" \
149 /etc/xml/catalog &amp;&amp;
150xmlcatalog --noout --add "delegateSystem" \
151 "http://www.oasis-open.org/docbook/" \
152 "file:///etc/xml/docbook" \
153 /etc/xml/catalog &amp;&amp;
154xmlcatalog --noout --add "delegateURI" \
155 "http://www.oasis-open.org/docbook/" \
156 "file:///etc/xml/docbook" \
157 /etc/xml/catalog</userinput></screen>
158
159 </sect2>
160
161 <sect2 role="configuration">
162 <title>Configuring DocBook XML DTD</title>
163
164 <sect3 id="docbook-config">
165 <title>Config Files</title>
166
167 <para><filename>/etc/xml/catalog</filename>,
168 <filename>/etc/xml/docbook</filename></para>
169
170 <indexterm zone="DocBook docbook-config">
171 <primary sortas="e-etc-xml-docbook">/etc/xml/docbook</primary>
172 </indexterm>
173
174 <indexterm zone="DocBook docbook-config">
175 <primary sortas="e-etc-xml-catalog">/etc/xml/catalog</primary>
176 </indexterm>
177
178 </sect3>
179
180 <sect3>
181 <title>Configuration Information</title>
182
183 <para>The above installation creates the files and updates the catalogs.
184 In order to install <application>ScrollKeeper</application> or to
185 utilize <application>DocBook XML DTD</application> V&DocBook-version;
186 when any version 4.x is requested in the System Identifier, you need to
187 add additional statements to the catalog files. If you have any of the
188 <application>DocBook XML DTD</application>'s referenced below already
189 installed on your system, remove those entries from the
190 <command>for</command> command below (issue the commands as the
191 <systemitem class="username">root</systemitem> user):</para>
192
193<screen role="root"><userinput>for DTDVERSION in 4.1.2 4.2 4.3
194do
195 xmlcatalog --noout --add "public" \
196 "-//OASIS//DTD DocBook XML V$DTDVERSION//EN" \
197 "http://www.oasis-open.org/docbook/xml/$DTDVERSION/docbookx.dtd" \
198 /etc/xml/docbook
199 xmlcatalog --noout --add "rewriteSystem" \
200 "http://www.oasis-open.org/docbook/xml/$DTDVERSION" \
201 "file:///usr/share/xml/docbook/xml-dtd-&DocBook-version;" \
202 /etc/xml/docbook
203 xmlcatalog --noout --add "rewriteURI" \
204 "http://www.oasis-open.org/docbook/xml/$DTDVERSION" \
205 "file:///usr/share/xml/docbook/xml-dtd-&DocBook-version;" \
206 /etc/xml/docbook
207 xmlcatalog --noout --add "delegateSystem" \
208 "http://www.oasis-open.org/docbook/xml/$DTDVERSION/" \
209 "file:///etc/xml/docbook" \
210 /etc/xml/catalog
211 xmlcatalog --noout --add "delegateURI" \
212 "http://www.oasis-open.org/docbook/xml/$DTDVERSION/" \
213 "file:///etc/xml/docbook" \
214 /etc/xml/catalog
215done</userinput></screen>
216
217 </sect3>
218
219 </sect2>
220
221 <sect2 role="content">
222 <title>Contents</title>
223
224 <segmentedlist>
225 <segtitle>Installed Programs</segtitle>
226 <segtitle>Installed Libraries</segtitle>
227 <segtitle>Installed Files</segtitle>
228 <segtitle>Installed Directories</segtitle>
229
230 <seglistitem>
231 <seg>None</seg>
232 <seg>None</seg>
233 <seg>DTD, MOD and ENT files</seg>
234 <seg>/etc/xml and /usr/share/xml/docbook/xml-dtd-&DocBook-version;</seg>
235 </seglistitem>
236 </segmentedlist>
237
238 <variablelist>
239 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
240 <?dbfo list-presentation="list"?>
241 <?dbhtml list-presentation="table"?>
242
243 <varlistentry id="DTD-files">
244 <term><filename>DTD files</filename></term>
245 <listitem>
246 <para>contain a document type definition which defines the element
247 types and the attribute lists that can be used in the corresponding
248 <filename>XML</filename> files.</para>
249 <indexterm zone="DocBook DTD-files">
250 <primary sortas="g-DTD-files">DTD Files</primary>
251 </indexterm>
252 </listitem>
253 </varlistentry>
254
255 <varlistentry id="MOD-files">
256 <term><filename>MOD files</filename></term>
257 <listitem>
258 <para>files contain components of the document type definition that
259 are sourced into the <filename>DTD</filename> files.</para>
260 <indexterm zone="DocBook MOD-files">
261 <primary sortas="g-MOD-files">MOD files</primary>
262 </indexterm>
263 </listitem>
264 </varlistentry>
265
266 <varlistentry id="ENT-files">
267 <term><filename>ENT files</filename></term>
268 <listitem>
269 <para>files contain lists of named character entities allowed in
270 HTML.</para>
271 <indexterm zone="DocBook ENT-files">
272 <primary sortas="g-ENT-files">ENT-files</primary>
273 </indexterm>
274 </listitem>
275 </varlistentry>
276
277 </variablelist>
278
279 </sect2>
280
281</sect1>
Note: See TracBrowser for help on using the repository browser.