pst/sgml/docbook-dsssl.xml


1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239

<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
   "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
  <!ENTITY % general-entities SYSTEM "../../general.ent">
  %general-entities;

    <!-- Inserted as a reminder to do this. The mention of a test suite
         is usually right before the root user installation commands. Please
         delete these 12 (including one blank) lines after you are done.-->

    <!-- Use one of the two mentions below about a test suite,
         delete the line that is not applicable. Of course, if the
         test suite uses syntax other than "make check", revise the
         line to reflect the actual syntax to run the test suite -->

    <!-- <para>This package does not come with a test suite.</para> -->
    <!-- <para>To test the results, issue: <command>make check</command>.</para> -->

  <!ENTITY docbook-dsssl-download-http "http://downloads.sourceforge.net/docbook/docbook-dsssl-&docbook-dsssl-version;.tar.bz2">
  <!ENTITY docbook-dsssl-download-ftp  "ftp://ftp.fu-berlin.de/unix/linux/mirrors/gentoo/distfiles/docbook-dsssl-&docbook-dsssl-version;.tar.bz2">
  <!ENTITY docbook-dsssl-md5sum        "bc192d23266b9a664ca0aba4a7794c7c">
  <!ENTITY docbook-dsssl-size          "277 KB">
  <!ENTITY docbook-dsssl-buildsize     "14 MB">
  <!ENTITY docbook-dsssl-time          "less than 0.1 SBU">

  <!ENTITY docbook-dsssl-doc-download-http "http://downloads.sourceforge.net/docbook/docbook-dsssl-doc-&docbook-dsssl-version;.tar.bz2">
  <!ENTITY docbook-dsssl-doc-md5sum        "9a7b809a21ab7d2749bb328334c380f2">
  <!ENTITY docbook-dsssl-doc-size          "142 KB">
]>

<sect1 id="docbook-dsssl"
xreflabel="DocBook DSSSL Stylesheets-&docbook-dsssl-version;">
  <?dbhtml filename="docbook-dsssl.html"?>

  <sect1info>
    <othername>$LastChangedBy$</othername>
    <date>$Date$</date>
  </sect1info>

  <title>DocBook DSSSL Stylesheets-&docbook-dsssl-version;</title>

  <indexterm zone="docbook-dsssl">
    <primary sortas="a-DocBook-DSSSL-Stylesheets">DocBook DSSSL
    Stylesheets</primary>
  </indexterm>

  <sect2 role="package">
    <title>Introduction to DocBook DSSSL Stylesheets</title>

    <para>The <application>DocBook DSSSL Stylesheets</application> package
    contains DSSSL stylesheets. These are used by
    <application>OpenJade</application> or other tools to transform SGML
    and XML DocBook files.</para>

    <bridgehead renderas="sect3">Package Information</bridgehead>
    <itemizedlist spacing="compact">
      <listitem>
        <para>Download (HTTP): <ulink url="&docbook-dsssl-download-http;"/></para>
      </listitem>
      <listitem>
        <para>Download (FTP): <ulink url="&docbook-dsssl-download-ftp;"/></para>
      </listitem>
      <listitem>
        <para>Download MD5 sum: &docbook-dsssl-md5sum;</para>
      </listitem>
      <listitem>
        <para>Download size: &docbook-dsssl-size;</para>
      </listitem>
      <listitem>
        <para>Estimated disk space required: &docbook-dsssl-buildsize;</para>
      </listitem>
      <listitem>
        <para>Estimated build time: &docbook-dsssl-time;</para>
      </listitem>
    </itemizedlist>

    <bridgehead renderas="sect3">Additional Downloads</bridgehead>
    <itemizedlist spacing='compact'>
      <listitem>
        <para>Documentation and test data:
        <ulink url="&docbook-dsssl-doc-download-http;"/></para></listitem>
      <listitem>
        <para>Download MD5 sum: &docbook-dsssl-doc-md5sum;</para>
      </listitem>
      <listitem>
        <para>Download size: &docbook-dsssl-doc-size;</para>
      </listitem>
    </itemizedlist>

    <bridgehead renderas="sect3">DocBook DSSSL Stylesheets
    Dependencies</bridgehead>

    <bridgehead renderas="sect4">Required</bridgehead>
    <para role="required"><xref linkend="sgml-common"/></para>

    <bridgehead renderas="sect4">Required (to Test the DocBook SGML
    Toolchain)</bridgehead>
    <para role="required"><xref linkend="sgml-dtd-3"/>,
    <xref linkend="sgml-dtd"/>,
    <xref linkend="opensp"/> and
    <xref linkend="openjade"/></para>

    <para condition="html" role="usernotes">User Notes:
    <ulink url="&blfs-wiki;/docbook-dsssl"/></para>

  </sect2>

  <sect2 role="installation">
    <title>Installation of DocBook DSSSL Stylesheets</title>

    <para>Ensure you unpack both the source and documentation tarballs before
    beginning the build.</para>

    <para>Install <application>DocBook DSSSL Stylesheets</application> by running
    the following commands as the <systemitem class="username">root</systemitem>
    user:</para>

<!--
<screen><userinput>mkdir -p /usr/share/sgml/docbook/dsssl-stylesheets-&docbook-dsssl-version;/dtds/decls &amp;&amp;
mkdir -p /usr/share/sgml/docbook/dsssl-stylesheets-&docbook-dsssl-version;/lib &amp;&amp;
mkdir -p /usr/share/sgml/docbook/dsssl-stylesheets-&docbook-dsssl-version;/common &amp;&amp;
mkdir -p /usr/share/sgml/docbook/dsssl-stylesheets-&docbook-dsssl-version;/html &amp;&amp;
mkdir -p /usr/share/sgml/docbook/dsssl-stylesheets-&docbook-dsssl-version;/print &amp;&amp;
mkdir -p /usr/share/sgml/docbook/dsssl-stylesheets-&docbook-dsssl-version;/test &amp;&amp;
mkdir -p /usr/share/sgml/docbook/dsssl-stylesheets-&docbook-dsssl-version;/images &amp;&amp;
install bin/collateindex.pl /usr/bin &amp;&amp;
cp catalog VERSION /usr/share/sgml/docbook/dsssl-stylesheets-&docbook-dsssl-version; &amp;&amp;
cp dtds/decls/*.dcl \
    /usr/share/sgml/docbook/dsssl-stylesheets-&docbook-dsssl-version;/dtds/decls &amp;&amp;
cp lib/dblib.dsl /usr/share/sgml/docbook/dsssl-stylesheets-&docbook-dsssl-version;/lib &amp;&amp;
cp common/*.dsl /usr/share/sgml/docbook/dsssl-stylesheets-&docbook-dsssl-version;/common &amp;&amp;
cp common/*.ent /usr/share/sgml/docbook/dsssl-stylesheets-&docbook-dsssl-version;/common &amp;&amp;
cp html/*.dsl /usr/share/sgml/docbook/dsssl-stylesheets-&docbook-dsssl-version;/html &amp;&amp;
cp print/*.dsl /usr/share/sgml/docbook/dsssl-stylesheets-&docbook-dsssl-version;/print &amp;&amp;
cp images/*.gif /usr/share/sgml/docbook/dsssl-stylesheets-&docbook-dsssl-version;/images &amp;&amp;
 -->

<screen role="root"><userinput>install -v -m755 bin/collateindex.pl /usr/bin &amp;&amp;
install -v -m644 bin/collateindex.pl.1 /usr/share/man/man1 &amp;&amp;
install -v -d -m755 /usr/share/sgml/docbook/dsssl-stylesheets-&docbook-dsssl-version; &amp;&amp;
cp -v -R * /usr/share/sgml/docbook/dsssl-stylesheets-&docbook-dsssl-version; &amp;&amp;
install-catalog --add /etc/sgml/dsssl-docbook-stylesheets.cat \
    /usr/share/sgml/docbook/dsssl-stylesheets-&docbook-dsssl-version;/catalog &amp;&amp;
install-catalog --add /etc/sgml/dsssl-docbook-stylesheets.cat \
    /usr/share/sgml/docbook/dsssl-stylesheets-&docbook-dsssl-version;/common/catalog &amp;&amp;
install-catalog --add /etc/sgml/sgml-docbook.cat \
    /etc/sgml/dsssl-docbook-stylesheets.cat</userinput></screen>

  </sect2>

  <sect2 role="commands">
    <title>Command Explanations</title>

    <para>The above commands create an installation script for this
    package.</para>

  </sect2>

  <sect2 role="testing">
    <title>Testing the DocBook SGML Toolchain (Optional)</title>

    <para>The following commands will perform the necessary tests to confirm
    that your installed DocBook SGML toolchain will produce desired results.
    You must have the <xref linkend="sgml-dtd-3"/>, <xref linkend="sgml-dtd"/>,
    <xref linkend="opensp"/> and <xref linkend="openjade"/> packages installed
    and perform the tests as the
    <systemitem class="username">root</systemitem> user.</para>

    <para>All tests will be performed from the <filename class='directory'>
    /usr/share/sgml/docbook/dsssl-stylesheets-&docbook-dsssl-version;/doc/testdata</filename>
    directory:</para>

<screen role="root"><userinput>cd /usr/share/sgml/docbook/dsssl-stylesheets-&docbook-dsssl-version;/doc/testdata</userinput></screen>

    <para>The first test should produce no output to stdout (your screen) and
    create a file named <filename>jtest.rtf</filename> in the current
    directory:</para>

<screen role="root"><userinput>openjade -t rtf -d jtest.dsl jtest.sgm</userinput></screen>

    <para>The next test should return only the following line to stdout:
    <computeroutput>onsgmls:I: "OpenSP" version "1.5.1"</computeroutput></para>

<screen role="root"><userinput>onsgmls -sv test.sgm</userinput></screen>

    <para>The next test should produce no output to stdout and create a file
    named <filename>test.rtf</filename> in the current directory:</para>

<screen role="root"><userinput>openjade -t rtf \
    -d /usr/share/sgml/docbook/dsssl-stylesheets-&docbook-dsssl-version;/print/docbook.dsl \
    test.sgm</userinput></screen>

    <para>The last test should produce no output to stdout and create a file
    named <filename>c1.htm</filename> in the current directory:</para>

<screen role="root"><userinput>openjade -t sgml \
    -d /usr/share/sgml/docbook/dsssl-stylesheets-&docbook-dsssl-version;/html/docbook.dsl \
    test.sgm</userinput></screen>

  </sect2>

  <sect2 role="content">
    <title>Contents</title>

    <segmentedlist>
      <segtitle>Installed Program</segtitle>
      <segtitle>Installed Libraries</segtitle>
      <segtitle>Installed Files</segtitle>
      <segtitle>Installed Directory</segtitle>

      <seglistitem>
        <seg>collateindex.pl</seg>
        <seg>None</seg>
        <seg>DSSSL stylesheets</seg>
        <seg>/usr/share/sgml/docbook/dsssl-stylesheets-&docbook-dsssl-version;</seg>
      </seglistitem>
    </segmentedlist>

    <variablelist>
      <bridgehead renderas="sect3">Short Descriptions</bridgehead>
      <?dbfo list-presentation="list"?>
      <?dbhtml list-presentation="table"?>

      <varlistentry id="collateindex.pl">
        <term><command>collateindex.pl</command></term>
        <listitem>
          <para>is a <application>Perl</application> script that creates a
          DocBook index from raw index data.</para>
          <indexterm zone="docbook-dsssl collateindex.pl">
            <primary sortas="b-collateindex.pl">collateindex.pl</primary>
          </indexterm>
        </listitem>
      </varlistentry>

    </variablelist>

  </sect2>

</sect1>