source: pst/sgml/docbook-3.1-dtd.xml@ f429481

11.1 lazarus qt5new trunk upgradedb xry111/intltool xry111/test-20220226
Last change on this file since f429481 was c93c620c, checked in by Bruce Dubbs <bdubbs@…>, 9 months ago

Tags

  • Property mode set to 100644
File size: 7.2 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 sgml-dtd-3-download-http "https://www.docbook.org/sgml/&docbook-3.1-dtd-version;/docbk31.zip">
8 <!ENTITY sgml-dtd-3-download-ftp " ">
9 <!ENTITY sgml-dtd-3-md5sum "432749c0c806dbae81c8bcb70da3b5d3">
10 <!ENTITY sgml-dtd-3-size "55 KB">
11 <!ENTITY sgml-dtd-3-buildsize "676 KB">
12 <!ENTITY sgml-dtd-3-time "less than 0.1 SBU">
13]>
14
15<sect1 id="sgml-dtd-3" xreflabel="docbook-&docbook-3.1-dtd-version;-dtd">
16 <?dbhtml filename="docbook-3.1-dtd.html"?>
17
18 <sect1info>
19 <date>$Date$</date>
20 </sect1info>
21
22 <title>docbook-&docbook-3.1-dtd-version;-dtd</title>
23
24 <indexterm zone="sgml-dtd-3">
25 <primary sortas="a-DocBook-SGML-DTD-&docbook-3.1-dtd-version;">DocBook SGML
26 DTD-&docbook-3.1-dtd-version;</primary>
27 </indexterm>
28
29 <sect2 role="package">
30 <title>Introduction to DocBook-3.1 SGML DTD</title>
31
32 <para>
33 The <application>DocBook SGML DTD</application> package contains
34 document type definitions for verification of SGML data files against
35 the DocBook rule set. These are useful for structuring books and software
36 documentation to a standard allowing you to utilize transformations
37 already written for that standard.
38 </para>
39
40 &lfs110a_checked;
41
42 <bridgehead renderas="sect3">Package Information</bridgehead>
43 <itemizedlist spacing="compact">
44 <listitem>
45 <para>
46 Download (HTTP): <ulink url="&sgml-dtd-3-download-http;"/>
47 </para>
48 </listitem>
49 <listitem>
50 <para>
51 Download (FTP): <ulink url="&sgml-dtd-3-download-ftp;"/>
52 </para>
53 </listitem>
54 <listitem>
55 <para>
56 Download MD5 sum: &sgml-dtd-3-md5sum;
57 </para>
58 </listitem>
59 <listitem>
60 <para>
61 Download size: &sgml-dtd-3-size;
62 </para>
63 </listitem>
64 <listitem>
65 <para>
66 Estimated disk space required: &sgml-dtd-3-buildsize;
67 </para>
68 </listitem>
69 <listitem>
70 <para>
71 Estimated build time: &sgml-dtd-3-time;
72 </para>
73 </listitem>
74 </itemizedlist>
75
76 <bridgehead renderas="sect3">DocBook-3.1 SGML DTD Dependencies</bridgehead>
77
78 <bridgehead renderas="sect4">Required</bridgehead>
79 <para role="required">
80 <xref linkend="sgml-common"/> and
81 <xref linkend="unzip"/>
82 </para>
83
84 <para condition="html" role="usernotes">User Notes:
85 <ulink url="&blfs-wiki;/sgml-dtd-3"/></para>
86
87 </sect2>
88
89 <sect2 role="installation">
90 <title>Installation of DocBook-3.1 SGML DTD</title>
91
92 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
93 href="../../xincludes/use-unzip.xml"/>
94
95 <para>
96 Install <application>DocBook-3.1 SGML DTD</application> by running
97 the following commands:
98 </para>
99
100<screen><userinput>sed -i -e '/ISO 8879/d' \
101 -e 's|DTDDECL "-//OASIS//DTD DocBook V&docbook-3.1-dtd-version;//EN"|SGMLDECL|g' \
102 docbook.cat</userinput></screen>
103
104 <para>
105 This package does not come with a test suite.
106 </para>
107
108 <para>
109 Now, as the <systemitem class="username">root</systemitem> user:
110 </para>
111
112<screen role="root"><userinput>install -v -d -m755 /usr/share/sgml/docbook/sgml-dtd-&docbook-3.1-dtd-version; &amp;&amp;
113chown -R root:root . &amp;&amp;
114install -v docbook.cat /usr/share/sgml/docbook/sgml-dtd-&docbook-3.1-dtd-version;/catalog &amp;&amp;
115cp -v -af *.dtd *.mod *.dcl /usr/share/sgml/docbook/sgml-dtd-&docbook-3.1-dtd-version; &amp;&amp;
116
117install-catalog --add /etc/sgml/sgml-docbook-dtd-&docbook-3.1-dtd-version;.cat \
118 /usr/share/sgml/docbook/sgml-dtd-&docbook-3.1-dtd-version;/catalog &amp;&amp;
119
120install-catalog --add /etc/sgml/sgml-docbook-dtd-&docbook-3.1-dtd-version;.cat \
121 /etc/sgml/sgml-docbook.cat</userinput></screen>
122
123 </sect2>
124
125 <sect2 role="commands">
126 <title>Command Explanations</title>
127
128 <para>
129 <command>sed -i -e '/ISO 8879/d' docbook.cat</command>: This command
130 removes the ENT definitions from the catalog file.
131 </para>
132
133 <para>
134 <command>sed -i -e 's|DTDDECL
135 "-//OASIS//DTD Docbook V&docbook-3.1-dtd-version;//EN"|SGMLDECL|g'
136 docbook.cat</command>: This command replaces the DTDDECL catalog entry,
137 which is not supported by Linux SGML tools, with the SGMLDECL catalog
138 entry.
139 </para>
140
141 </sect2>
142
143 <sect2 role="configuration">
144 <title>Configuring DocBook-3.1 SGML DTD</title>
145
146 <sect3 id="sgml-dtd-3-config">
147 <title>Config Files</title>
148
149 <para>
150 <filename>/etc/sgml/catalog</filename>
151 </para>
152
153 <indexterm zone="sgml-dtd-3 sgml-dtd-3-config">
154 <primary sortas="e-etc-sgml-catalog">/etc/sgml/catalog</primary>
155 </indexterm>
156
157 </sect3>
158
159 <sect3>
160 <title>Configuration Information</title>
161
162 <para>
163 The above installation script updates the catalog.
164 </para>
165
166 <para>
167 Using only the most current 3.x version of <application>DocBook
168 SGML DTD</application> requires the following (perform as the
169 <systemitem class="username">root</systemitem> user):
170 </para>
171
172<screen role="root"><userinput>cat &gt;&gt; /usr/share/sgml/docbook/sgml-dtd-&docbook-3.1-dtd-version;/catalog &lt;&lt; "EOF"
173<literal> -- Begin Single Major Version catalog changes --
174
175PUBLIC "-//Davenport//DTD DocBook V3.0//EN" "docbook.dtd"
176
177 -- End Single Major Version catalog changes --</literal>
178EOF</userinput></screen>
179
180 </sect3>
181
182 </sect2>
183
184 <sect2 role="content">
185 <title>Contents</title>
186
187 <segmentedlist>
188 <segtitle>Installed Programs</segtitle>
189 <segtitle>Installed Libraries</segtitle>
190 <segtitle>Installed Files</segtitle>
191 <segtitle>Installed Directory</segtitle>
192
193 <seglistitem>
194 <seg>None</seg>
195 <seg>None</seg>
196 <seg>SGML DTD and MOD files</seg>
197 <seg>/usr/share/sgml/docbook/sgml-dtd-&docbook-3.1-dtd-version;</seg>
198 </seglistitem>
199 </segmentedlist>
200
201 <variablelist>
202 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
203 <?dbfo list-presentation="list"?>
204 <?dbhtml list-presentation="table"?>
205
206 <varlistentry id="SGML-DTD-files">
207 <term><filename>SGML DTD files</filename></term>
208 <listitem>
209 <para>
210 contains a document type definition which defines the element
211 types and the attribute lists that can be used in the corresponding
212 SGML files
213 </para>
214 <indexterm zone="sgml-dtd-3 SGML-DTD-files">
215 <primary sortas="g-SGML-DTD-files">SGML DTD files</primary>
216 </indexterm>
217 </listitem>
218 </varlistentry>
219
220 <varlistentry id="SGML-MOD-files">
221 <term><filename>SGML MOD files</filename></term>
222 <listitem>
223 <para>
224 contains components of the document type definition that are
225 sourced into the <filename>DTD</filename> files
226 </para>
227 <indexterm zone="sgml-dtd-3 SGML-MOD-files">
228 <primary sortas="g-SGML-MOD-files">SGML MOD files</primary>
229 </indexterm>
230 </listitem>
231 </varlistentry>
232
233 </variablelist>
234
235 </sect2>
236
237</sect1>
Note: See TracBrowser for help on using the repository browser.