source: pst/xml/docbook.xml@ 879932f

10.0 10.1 11.0 8.0 8.1 8.2 8.3 8.4 9.0 9.1 basic bdubbs/svn elogind perl-modules qt5new trunk xry111/git-date xry111/git-date-for-trunk xry111/git-date-test
Last change on this file since 879932f was 879932f, checked in by Douglas R. Reno <renodr@…>, 5 years ago

Archive setuptools
Modify Python instructions to add setuptools and pip as part of the installation
Tags for the Python section + a few others

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

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