source: pst/xml/docbook-xsl.xml@ fb0655c

10.0 10.1 11.0 11.1 11.2 8.2 8.3 8.4 9.0 9.1 basic bdubbs/svn elogind lazarus perl-modules plabs/python-mods qt5new trunk upgradedb xry111/intltool xry111/soup3 xry111/test-20220226
Last change on this file since fb0655c was fb0655c, checked in by Bruce Dubbs <bdubbs@…>, 5 years ago

Update to xine-ui-0.99.10.
Update to gnumeric-1.12.38.
Update to feh-2.3.
Update to goffice-0.10.38.
Update to bluez-5.48.
Update to docbook-xsl-1.79.2.
Update to v4l-utils-1.14.1.
Update to whois-5.2.20.

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

  • Property mode set to 100644
File size: 9.7 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 path "https://github.com/docbook/xslt10-stylesheets/releases/download/release">
8
9 <!ENTITY docbook-xsl-download-http "&path;/&docbook-xsl-version;/docbook-xsl-&docbook-xsl-version;.tar.bz2">
10 <!ENTITY docbook-xsl-download-ftp " ">
11 <!ENTITY docbook-xsl-md5sum "4a400f0264a19329c7f95f69e098744a">
12 <!ENTITY docbook-xsl-size "22 MB">
13 <!ENTITY docbook-xsl-buildsize "58 MB (includes installing optional documentation)">
14 <!ENTITY docbook-xsl-time "less than 0.1 SBU">
15
16 <!ENTITY docbook-xsl-doc-download "&path;/&docbook-xsl-version;/docbook-xsl-doc-&docbook-xsl-version;.tar.bz2">
17 <!ENTITY docbook-xsl-doc-md5sum "62375ca864fc198cb2b17d98209d0b8c">
18 <!ENTITY docbook-xsl-doc-size "1.0 MB">
19]>
20
21<sect1 id="docbook-xsl"
22xreflabel="docbook-xsl-&docbook-xsl-version;">
23 <?dbhtml filename="docbook-xsl.html"?>
24
25 <sect1info>
26 <othername>$LastChangedBy$</othername>
27 <date>$Date$</date>
28 </sect1info>
29
30 <title>docbook-xsl-&docbook-xsl-version;</title>
31
32 <indexterm zone="docbook-xsl">
33 <primary sortas="a-DocBook-XSL-Stylesheets">DocBook XSL
34 Stylesheets</primary>
35 </indexterm>
36
37 <sect2 role="package">
38 <title>Introduction to DocBook XSL Stylesheets</title>
39
40 <para>The <application>DocBook XSL Stylesheets</application>
41 package contains XSL stylesheets. These are useful for
42 performing transformations on XML DocBook files.</para>
43
44 &lfs81_checked;
45
46 <bridgehead renderas="sect3">Package Information</bridgehead>
47 <itemizedlist spacing="compact">
48 <listitem>
49 <para>Download (HTTP): <ulink url="&docbook-xsl-download-http;"/></para>
50 </listitem>
51 <listitem>
52 <para>Download (FTP): <ulink url="&docbook-xsl-download-ftp;"/></para>
53 </listitem>
54 <listitem>
55 <para>Download MD5 sum: &docbook-xsl-md5sum;</para>
56 </listitem>
57 <listitem>
58 <para>Download size: &docbook-xsl-size;</para>
59 </listitem>
60 <listitem>
61 <para>Estimated disk space required: &docbook-xsl-buildsize;</para>
62 </listitem>
63 <listitem>
64 <para>Estimated build time: &docbook-xsl-time;</para>
65 </listitem>
66 </itemizedlist>
67
68 <bridgehead renderas="sect3">Additional Downloads</bridgehead>
69 <itemizedlist spacing="compact">
70 <title>Optional documentation</title>
71 <listitem>
72 <para>Download (HTTP): <ulink url="&docbook-xsl-doc-download;"/></para>
73 </listitem>
74 <listitem>
75 <para>Download MD5 sum: &docbook-xsl-doc-md5sum;</para>
76 </listitem>
77 <listitem>
78 <para>Download size: &docbook-xsl-doc-size;</para>
79 </listitem>
80 </itemizedlist>
81
82 <bridgehead renderas="sect3">DocBook XSL Stylesheets Dependencies</bridgehead>
83
84 <bridgehead renderas="sect4">Recommended (at runtime)</bridgehead>
85 <para role="recommended"><xref role="runtime" linkend="libxml2"/></para>
86
87 <bridgehead renderas="sect4">Optional (all used at runtime)</bridgehead>
88 <para role="optional">
89 <xref role="runtime" linkend="apache-ant"/> (to produce <quote>webhelp</quote> documents),
90 <xref role="runtime" linkend="libxslt"/> (or any other XSLT processor), to process
91 Docbook documents - the <application>Python2</application> modules
92 libxml2 and libxslt can be used,
93 <xref role="runtime" linkend="python2"/> (at runtime),
94 <xref role="runtime" linkend="ruby"/> (to utilize the <quote>epub</quote> stylesheets),
95 <xref role="runtime" linkend="zip"/> (to produce <quote>epub3</quote> documents), and
96 <ulink url="http://sourceforge.net/projects/saxon/files/saxon6/">
97 Saxon6
98 </ulink> and
99 <ulink url="http://xerces.apache.org/xerces2-j/">Xerces2 Java</ulink>
100 (used with <xref role="runtime" linkend="apache-ant"/> to produce <quote>webhelp</quote>
101 documents)
102 </para>
103
104 <para condition="html" role="usernotes">User Notes:
105 <ulink url="&blfs-wiki;/docbook-xsl"/></para>
106
107 </sect2>
108
109 <sect2 role="installation">
110 <title>Installation of DocBook XSL Stylesheets</title>
111
112 <para>If you downloaded the optional documentation tarball, unpack it
113 with the following command:</para>
114
115<screen><userinput>tar -xf ../docbook-xsl-doc-&docbook-xsl-version;.tar.bz2 --strip-components=1</userinput></screen>
116
117 <para>BLFS does not install the required packages to run the test suite
118 and provide meaningful results.</para>
119
120 <para>Install <application>DocBook XSL Stylesheets</application>
121 by running the following commands as the
122 <systemitem class="username">root</systemitem> user:</para>
123
124<screen role="root"><userinput>install -v -m755 -d /usr/share/xml/docbook/xsl-stylesheets-&docbook-xsl-version; &amp;&amp;
125
126cp -v -R VERSION assembly common eclipse epub epub3 extensions fo \
127 highlighting html htmlhelp images javahelp lib manpages params \
128 profiling roundtrip slides template tests tools webhelp website \
129 xhtml xhtml-1_1 xhtml5 \
130 /usr/share/xml/docbook/xsl-stylesheets-&docbook-xsl-version; &amp;&amp;
131
132ln -s VERSION /usr/share/xml/docbook/xsl-stylesheets-&docbook-xsl-version;/VERSION.xsl &amp;&amp;
133
134install -v -m644 -D README \
135 /usr/share/doc/docbook-xsl-&docbook-xsl-version;/README.txt &amp;&amp;
136install -v -m644 RELEASE-NOTES* NEWS* \
137 /usr/share/doc/docbook-xsl-&docbook-xsl-version;</userinput></screen>
138
139 <para>If you downloaded the optional documentation tarball, install the
140 documentation by issuing the following command as the
141 <systemitem class="username">root</systemitem> user:</para>
142
143<screen role="root"><userinput>cp -v -R doc/* /usr/share/doc/docbook-xsl-&docbook-xsl-version;</userinput></screen>
144
145 </sect2>
146
147 <sect2 role="configuration">
148 <title>Configuring DocBook XSL Stylesheets</title>
149
150 <sect3 id="docbook-xsl-config">
151 <title>Config Files</title>
152
153 <para><filename>/etc/xml/catalog</filename></para>
154
155 <indexterm zone="docbook-xsl docbook-xsl-config">
156 <primary sortas="e-etc-xml-catalog">/etc/xml/catalog</primary>
157 </indexterm>
158
159 </sect3>
160
161 <sect3>
162 <title>Configuration Information</title>
163
164 <para>Create (or append) and populate the XML catalog file using the
165 following commands as the <systemitem class="username">root</systemitem>
166 user:</para>
167
168<screen role="root"><userinput>if [ ! -d /etc/xml ]; then install -v -m755 -d /etc/xml; fi &amp;&amp;
169if [ ! -f /etc/xml/catalog ]; then
170 xmlcatalog --noout --create /etc/xml/catalog
171fi &amp;&amp;
172
173xmlcatalog --noout --add "rewriteSystem" \
174 "http://docbook.sourceforge.net/release/xsl/&docbook-xsl-version;" \
175 "/usr/share/xml/docbook/xsl-stylesheets-&docbook-xsl-version;" \
176 /etc/xml/catalog &amp;&amp;
177
178xmlcatalog --noout --add "rewriteURI" \
179 "http://docbook.sourceforge.net/release/xsl/&docbook-xsl-version;" \
180 "/usr/share/xml/docbook/xsl-stylesheets-&docbook-xsl-version;" \
181 /etc/xml/catalog &amp;&amp;
182
183xmlcatalog --noout --add "rewriteSystem" \
184 "http://docbook.sourceforge.net/release/xsl/current" \
185 "/usr/share/xml/docbook/xsl-stylesheets-&docbook-xsl-version;" \
186 /etc/xml/catalog &amp;&amp;
187
188xmlcatalog --noout --add "rewriteURI" \
189 "http://docbook.sourceforge.net/release/xsl/current" \
190 "/usr/share/xml/docbook/xsl-stylesheets-&docbook-xsl-version;" \
191 /etc/xml/catalog</userinput></screen>
192
193 <para>Occasionally, you may find the need to install other versions of
194 the XSL stylesheets as some projects reference a specific version. One
195 example is BLFS-6.0, which required the 1.67.2 version. In these instances
196 you should install any other required version in its own versioned
197 directory and create catalog entries as follows (substitute the desired
198 version number for <replaceable>&lt;version&gt;</replaceable>):</para>
199
200<screen role="root"><userinput>xmlcatalog --noout --add "rewriteSystem" \
201 "http://docbook.sourceforge.net/release/xsl/<replaceable>&lt;version&gt;</replaceable>" \
202 "/usr/share/xml/docbook/xsl-stylesheets-<replaceable>&lt;version&gt;</replaceable>" \
203 /etc/xml/catalog &amp;&amp;
204
205xmlcatalog --noout --add "rewriteURI" \
206 "http://docbook.sourceforge.net/release/xsl/<replaceable>&lt;version&gt;</replaceable>" \
207 "/usr/share/xml/docbook/xsl-stylesheets-<replaceable>&lt;version&gt;</replaceable>" \
208 /etc/xml/catalog</userinput></screen>
209
210<!-- Commented uot until be sure that there is no objetions from any of the
211 {C,H}LFS editors
212
213 <para>If you will be using the stylesheets from this installation to
214 render the LFS and HLFS SVN books, then you need to create a symbolic
215 link to the stylesheets directory so that the image files will be
216 found. Create the link by issuing the following command as the
217 <systemitem class="username">root</systemitem> user:</para>
218
219<screen role="root"><userinput>ln -v -sfn xsl-stylesheets-1.69.1 \
220 /usr/share/xml/docbook/xsl-stylesheets-current</userinput></screen>
221-->
222
223 </sect3>
224
225 </sect2>
226
227 <sect2 role="content">
228 <title>Contents</title>
229
230 <segmentedlist>
231 <segtitle>Installed Programs</segtitle>
232 <segtitle>Installed Libraries</segtitle>
233 <segtitle>Installed Directories</segtitle>
234
235 <seglistitem>
236 <seg>None</seg>
237 <seg>None</seg>
238 <seg>/usr/share/xml/docbook/xsl-stylesheets-&docbook-xsl-version; and
239 /usr/share/doc/docbook-xsl-&docbook-xsl-version;</seg>
240 </seglistitem>
241 </segmentedlist>
242
243 </sect2>
244
245</sect1>
Note: See TracBrowser for help on using the repository browser.