source: pst/xml/docbook.xml@ 9f12e36

10.0 10.1 11.0 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 ken/refactor-virt krejzi/svn lazarus nosym perl-modules qt5new systemd-11177 systemd-13485 trunk xry111/git-date xry111/git-date-for-trunk xry111/git-date-test
Last change on this file since 9f12e36 was 9f12e36, checked in by Randy McMurchy <randy@…>, 15 years ago

Removed 'keywordset' blocks and extra spaces from the XML files (note this was by accident as I meant to do just in the gnome directory but I was in the root of BOOK when I ran the script, but this was going to happen anyway so I don't think it is a big deal)

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

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