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

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