source: pst/sgml/docbook-dsssl.xml@ f89fc45

10.0 10.1 11.0 11.1 7.10 7.8 7.9 8.0 8.1 8.2 8.3 8.4 9.0 9.1 basic bdubbs/svn elogind lazarus nosym perl-modules qt5new trunk upgradedb xry111/intltool xry111/test-20220226
Last change on this file since f89fc45 was f89fc45, checked in by Ken Moffat <ken@…>, 7 years ago

more tags

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

  • Property mode set to 100644
File size: 8.8 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 <!-- 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-dsssl-download-http "&sourceforge-repo;/docbook/docbook-dsssl-&docbook-dsssl-version;.tar.bz2">
20 <!ENTITY docbook-dsssl-download-ftp "&gentoo-ftp-repo;/docbook-dsssl-&docbook-dsssl-version;.tar.bz2">
21 <!ENTITY docbook-dsssl-md5sum "bc192d23266b9a664ca0aba4a7794c7c">
22 <!ENTITY docbook-dsssl-size "277 KB">
23 <!ENTITY docbook-dsssl-buildsize "14 MB">
24 <!ENTITY docbook-dsssl-time "less than 0.1 SBU">
25
26 <!ENTITY docbook-dsssl-doc-download-http "&sourceforge-repo;/docbook/docbook-dsssl-doc-&docbook-dsssl-version;.tar.bz2">
27 <!ENTITY docbook-dsssl-doc-md5sum "9a7b809a21ab7d2749bb328334c380f2">
28 <!ENTITY docbook-dsssl-doc-size "142 KB">
29]>
30
31<sect1 id="docbook-dsssl"
32xreflabel="docbook-dsssl-&docbook-dsssl-version;">
33 <?dbhtml filename="docbook-dsssl.html"?>
34
35 <sect1info>
36 <othername>$LastChangedBy$</othername>
37 <date>$Date$</date>
38 </sect1info>
39
40 <title>docbook-dsssl-&docbook-dsssl-version;</title>
41
42 <indexterm zone="docbook-dsssl">
43 <primary sortas="a-DocBook-DSSSL-Stylesheets">DocBook DSSSL
44 Stylesheets</primary>
45 </indexterm>
46
47 <sect2 role="package">
48 <title>Introduction to DocBook DSSSL Stylesheets</title>
49
50 <para>The <application>DocBook DSSSL Stylesheets</application> package
51 contains DSSSL stylesheets. These are used by
52 <application>OpenJade</application> or other tools to transform SGML
53 and XML DocBook files.</para>
54
55 &lfs77_checked; &gcc5_checked;
56
57 <bridgehead renderas="sect3">Package Information</bridgehead>
58 <itemizedlist spacing="compact">
59 <listitem>
60 <para>Download (HTTP): <ulink url="&docbook-dsssl-download-http;"/></para>
61 </listitem>
62 <listitem>
63 <para>Download (FTP): <ulink url="&docbook-dsssl-download-ftp;"/></para>
64 </listitem>
65 <listitem>
66 <para>Download MD5 sum: &docbook-dsssl-md5sum;</para>
67 </listitem>
68 <listitem>
69 <para>Download size: &docbook-dsssl-size;</para>
70 </listitem>
71 <listitem>
72 <para>Estimated disk space required: &docbook-dsssl-buildsize;</para>
73 </listitem>
74 <listitem>
75 <para>Estimated build time: &docbook-dsssl-time;</para>
76 </listitem>
77 </itemizedlist>
78
79 <bridgehead renderas="sect3">Additional Downloads</bridgehead>
80 <itemizedlist spacing='compact'>
81 <title>Documentation and test data</title>
82
83 <listitem>
84 <para>Download (HTTP):
85 <ulink url="&docbook-dsssl-doc-download-http;"/></para></listitem>
86 <listitem>
87 <para>Download MD5 sum: &docbook-dsssl-doc-md5sum;</para>
88 </listitem>
89 <listitem>
90 <para>Download size: &docbook-dsssl-doc-size;</para>
91 </listitem>
92 </itemizedlist>
93
94 <bridgehead renderas="sect3">DocBook DSSSL Stylesheets
95 Dependencies</bridgehead>
96
97 <bridgehead renderas="sect4">Required</bridgehead>
98 <para role="required"><xref linkend="sgml-common"/></para>
99
100 <bridgehead renderas="sect4">Required (to Test the DocBook SGML
101 Toolchain)</bridgehead>
102 <para role="required"><xref linkend="sgml-dtd-3"/>,
103 <xref linkend="sgml-dtd"/>,
104 <xref linkend="opensp"/> and
105 <xref linkend="openjade"/></para>
106
107 <para condition="html" role="usernotes">User Notes:
108 <ulink url="&blfs-wiki;/docbook-dsssl"/></para>
109
110 </sect2>
111
112 <sect2 role="installation">
113 <title>Installation of DocBook DSSSL Stylesheets</title>
114
115 <para>If you downloaded the documentation, run:</para>
116
117<screen><userinput>tar -xf ../docbook-dsssl-doc-1.79.tar.bz2 --strip-components=1</userinput></screen>
118
119 <para>Install <application>DocBook DSSSL Stylesheets</application> by running
120 the following commands as the <systemitem class="username">root</systemitem>
121 user:</para>
122
123<screen role="root"><userinput>install -v -m755 bin/collateindex.pl /usr/bin &amp;&amp;
124install -v -m644 bin/collateindex.pl.1 /usr/share/man/man1 &amp;&amp;
125install -v -d -m755 /usr/share/sgml/docbook/dsssl-stylesheets-&docbook-dsssl-version; &amp;&amp;
126cp -v -R * /usr/share/sgml/docbook/dsssl-stylesheets-&docbook-dsssl-version; &amp;&amp;
127
128install-catalog --add /etc/sgml/dsssl-docbook-stylesheets.cat \
129 /usr/share/sgml/docbook/dsssl-stylesheets-&docbook-dsssl-version;/catalog &amp;&amp;
130
131install-catalog --add /etc/sgml/dsssl-docbook-stylesheets.cat \
132 /usr/share/sgml/docbook/dsssl-stylesheets-&docbook-dsssl-version;/common/catalog &amp;&amp;
133
134install-catalog --add /etc/sgml/sgml-docbook.cat \
135 /etc/sgml/dsssl-docbook-stylesheets.cat</userinput></screen>
136
137 </sect2>
138
139 <sect2 role="commands">
140 <title>Command Explanations</title>
141
142 <para>The above commands create an installation script for this
143 package.</para>
144
145 </sect2>
146
147 <sect2 role="testing">
148 <title>Testing the DocBook SGML Toolchain (Optional)</title>
149
150 <para>The following commands will perform the necessary tests to confirm
151 that your installed DocBook SGML toolchain will produce desired results.
152 You must have the <xref linkend="sgml-dtd-3"/>, <xref linkend="sgml-dtd"/>,
153 <xref linkend="opensp"/> and <xref linkend="openjade"/> packages installed
154 and perform the tests as the
155 <systemitem class="username">root</systemitem> user.</para>
156
157 <para>All tests will be performed from the <filename class='directory'>
158 /usr/share/sgml/docbook/dsssl-stylesheets-&docbook-dsssl-version;/doc/testdata</filename>
159 directory as the <systemitem class="username">root</systemitem> user:</para>
160
161<screen role="root"><userinput>cd /usr/share/sgml/docbook/dsssl-stylesheets-&docbook-dsssl-version;/doc/testdata</userinput></screen>
162
163 <para>The first test should produce no output to stdout (your screen) and
164 create a file named <filename>jtest.rtf</filename> in the current
165 directory:</para>
166
167<screen role="root"><userinput>openjade -t rtf -d jtest.dsl jtest.sgm</userinput></screen>
168
169 <para>The next test should return only the following line to stdout:
170 <computeroutput>onsgmls:I: "OpenSP" version "&opensp-version;"</computeroutput></para>
171
172<screen role="root"><userinput>onsgmls -sv test.sgm</userinput></screen>
173
174 <para>The next test should produce no output to stdout and create a file
175 named <filename>test.rtf</filename> in the current directory:</para>
176
177<screen role="root"><userinput>openjade -t rtf \
178 -d /usr/share/sgml/docbook/dsssl-stylesheets-&docbook-dsssl-version;/print/docbook.dsl \
179 test.sgm</userinput></screen>
180
181 <para>The last test should produce no output to stdout and create a file
182 named <filename>c1.htm</filename> in the current directory:</para>
183
184<screen role="root"><userinput>openjade -t sgml \
185 -d /usr/share/sgml/docbook/dsssl-stylesheets-&docbook-dsssl-version;/html/docbook.dsl \
186 test.sgm</userinput></screen>
187
188 <para>Finally, clean up:</para>
189
190<screen role="root"><userinput>rm jtest.rtf test.rtf c1.htm</userinput></screen>
191
192 </sect2>
193
194 <sect2 role="content">
195 <title>Contents</title>
196
197 <segmentedlist>
198 <segtitle>Installed Program</segtitle>
199 <segtitle>Installed Libraries</segtitle>
200 <segtitle>Installed Files</segtitle>
201 <segtitle>Installed Directory</segtitle>
202
203 <seglistitem>
204 <seg>collateindex.pl</seg>
205 <seg>None</seg>
206 <seg>DSSSL stylesheets</seg>
207 <seg>/usr/share/sgml/docbook/dsssl-stylesheets-&docbook-dsssl-version;</seg>
208 </seglistitem>
209 </segmentedlist>
210
211 <variablelist>
212 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
213 <?dbfo list-presentation="list"?>
214 <?dbhtml list-presentation="table"?>
215
216 <varlistentry id="collateindex.pl">
217 <term><command>collateindex.pl</command></term>
218 <listitem>
219 <para>is a <application>Perl</application> script that creates a
220 DocBook index from raw index data.</para>
221 <indexterm zone="docbook-dsssl collateindex.pl">
222 <primary sortas="b-collateindex.pl">collateindex.pl</primary>
223 </indexterm>
224 </listitem>
225 </varlistentry>
226
227 </variablelist>
228
229 </sect2>
230
231</sect1>
Note: See TracBrowser for help on using the repository browser.