source: pst/xml/docbook-xsl.xml

trunk
Last change on this file was 8558044, checked in by Pierre Labastie <pierre.labastie@…>, 3 months ago

Remove spaces at the end of lines

I know it is somewhat useless, but I don't like them for
two reasons: first they cannot be seen, and I do not like things I
cannot see. Second, git highlights them, and this is disturbing...

  • Property mode set to 100644
File size: 11.3 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-nons-&docbook-xsl-version;.tar.bz2">
10 <!ENTITY docbook-xsl-download-ftp " ">
11 <!ENTITY docbook-xsl-md5sum "2666d1488d6ced1551d15f31d7ed8c38">
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 "522 KB">
19]>
20
21<sect1 id="docbook-xsl"
22xreflabel="docbook-xsl-&docbook-xsl-version;">
23 <?dbhtml filename="docbook-xsl.html"?>
24
25 <sect1info>
26 <date>$Date$</date>
27 </sect1info>
28
29 <title>docbook-xsl-nons-&docbook-xsl-version;</title>
30
31 <indexterm zone="docbook-xsl">
32 <primary sortas="a-DocBook-XSL-Stylesheets">DocBook XSL
33 Stylesheets</primary>
34 </indexterm>
35
36 <sect2 role="package">
37 <title>Introduction to DocBook XSL Stylesheets</title>
38
39 <para>
40 The <application>DocBook XSL Stylesheets</application>
41 package contains XSL stylesheets. These are useful for
42 performing transformations on XML DocBook files.
43 </para>
44
45 &lfs110a_checked;
46
47 <bridgehead renderas="sect3">Package Information</bridgehead>
48 <itemizedlist spacing="compact">
49 <listitem>
50 <para>
51 Download (HTTP): <ulink url="&docbook-xsl-download-http;"/>
52 </para>
53 </listitem>
54 <listitem>
55 <para>
56 Download (FTP): <ulink url="&docbook-xsl-download-ftp;"/>
57 </para>
58 </listitem>
59 <listitem>
60 <para>
61 Download MD5 sum: &docbook-xsl-md5sum;
62 </para>
63 </listitem>
64 <listitem>
65 <para>
66 Download size: &docbook-xsl-size;
67 </para>
68 </listitem>
69 <listitem>
70 <para>
71 Estimated disk space required: &docbook-xsl-buildsize;
72 </para>
73 </listitem>
74 <listitem>
75 <para>
76 Estimated build time: &docbook-xsl-time;
77 </para>
78 </listitem>
79 </itemizedlist>
80
81 <bridgehead renderas="sect3">Additional Downloads</bridgehead>
82 <itemizedlist spacing='compact'>
83 <listitem>
84 <para>
85 Required patch: <ulink url=
86 "&patch-root;/docbook-xsl-nons-&docbook-xsl-version;-stack_fix-1.patch"/>
87 </para>
88 </listitem>
89 </itemizedlist>
90
91 <itemizedlist spacing="compact">
92 <title>Optional documentation</title>
93 <listitem>
94 <para>
95 Download (HTTP): <ulink url="&docbook-xsl-doc-download;"/>
96 </para>
97 </listitem>
98 <listitem>
99 <para>
100 Download MD5 sum: &docbook-xsl-doc-md5sum;
101 </para>
102 </listitem>
103 <listitem>
104 <para>
105 Download size: &docbook-xsl-doc-size;
106 </para>
107 </listitem>
108 </itemizedlist>
109
110 <bridgehead renderas="sect3">DocBook XSL Stylesheets Dependencies</bridgehead>
111
112 <bridgehead renderas="sect4">Recommended (at runtime)</bridgehead>
113 <para role="recommended">
114 <xref role="runtime" linkend="libxml2"/>
115 </para>
116
117 <bridgehead renderas="sect4">Optional (all used at runtime)</bridgehead>
118 <para role="optional">
119 <xref role="runtime" linkend="apache-ant"/>
120 (to produce <quote>webhelp</quote> documents),
121 <xref role="runtime" linkend="libxslt"/>
122 (or any other XSLT processor), to process
123 Docbook documents - the <application>Python2</application> modules
124 libxml2 and libxslt can be used,
125 <xref role="runtime" linkend="python2"/> (at runtime),
126 <xref role="runtime" linkend="ruby"/>
127 (to utilize the <quote>epub</quote> stylesheets),
128 <xref role="runtime" linkend="zip"/>
129 (to produce <quote>epub3</quote> documents), and
130 <ulink url="https://sourceforge.net/projects/saxon/files/saxon6/">
131 Saxon6
132 </ulink> and
133 <ulink url="http://xerces.apache.org/xerces2-j/">Xerces2 Java</ulink>
134 (used with <xref role="runtime" linkend="apache-ant"/>
135 to produce <quote>webhelp</quote> documents)
136 </para>
137
138 <para condition="html" role="usernotes">User Notes:
139 <ulink url="&blfs-wiki;/docbook-xsl"/></para>
140
141 </sect2>
142
143 <sect2 role="installation">
144 <title>Installation of DocBook XSL Stylesheets</title>
145
146 <para>
147 First, fix a problem that causes stack overflows when doing recursion:
148 </para>
149
150<screen><userinput>patch -Np1 -i ../docbook-xsl-nons-&docbook-xsl-version;-stack_fix-1.patch</userinput></screen>
151
152 <para>
153 If you downloaded the optional documentation tarball, unpack it
154 with the following command:
155 </para>
156
157<screen><userinput>tar -xf ../docbook-xsl-doc-&docbook-xsl-version;.tar.bz2 --strip-components=1</userinput></screen>
158
159 <para>
160 BLFS does not install the required packages to run the test suite
161 and provide meaningful results.
162 </para>
163
164 <para>
165 Install <application>DocBook XSL Stylesheets</application>
166 by running the following commands as the
167 <systemitem class="username">root</systemitem> user:
168 </para>
169
170<screen role="root"><userinput>install -v -m755 -d /usr/share/xml/docbook/xsl-stylesheets-nons-&docbook-xsl-version; &amp;&amp;
171
172cp -v -R VERSION assembly common eclipse epub epub3 extensions fo \
173 highlighting html htmlhelp images javahelp lib manpages params \
174 profiling roundtrip slides template tests tools webhelp website \
175 xhtml xhtml-1_1 xhtml5 \
176 /usr/share/xml/docbook/xsl-stylesheets-nons-&docbook-xsl-version; &amp;&amp;
177
178ln -s VERSION /usr/share/xml/docbook/xsl-stylesheets-nons-&docbook-xsl-version;/VERSION.xsl &amp;&amp;
179
180install -v -m644 -D README \
181 /usr/share/doc/docbook-xsl-nons-&docbook-xsl-version;/README.txt &amp;&amp;
182install -v -m644 RELEASE-NOTES* NEWS* \
183 /usr/share/doc/docbook-xsl-nons-&docbook-xsl-version;</userinput></screen>
184
185 <para>
186 If you downloaded the optional documentation tarball, install the
187 documentation by issuing the following command as the
188 <systemitem class="username">root</systemitem> user:
189 </para>
190
191<screen role="root"><userinput>cp -v -R doc/* /usr/share/doc/docbook-xsl-nons-&docbook-xsl-version;</userinput></screen>
192
193 </sect2>
194
195 <sect2 role="configuration">
196 <title>Configuring DocBook XSL Stylesheets</title>
197
198 <sect3 id="docbook-xsl-config">
199 <title>Config Files</title>
200
201 <para>
202 <filename>/etc/xml/catalog</filename>
203 </para>
204
205 <indexterm zone="docbook-xsl docbook-xsl-config">
206 <primary sortas="e-etc-xml-catalog">/etc/xml/catalog</primary>
207 </indexterm>
208
209 </sect3>
210
211 <sect3>
212 <title>Configuration Information</title>
213
214 <note>
215 <para>
216 If you are installing the current version of docbook-xsl-nons
217 over a previous version of docbook-xsl, then remove the old
218 rewrite entries in the catalog as the <systemitem
219 class="username">root</systemitem> user:
220 </para>
221
222<screen role="nodump"><userinput>sed -i '/rewrite/d' /etc/xml/catalog</userinput></screen>
223 </note>
224
225 <para>
226 Create (or append) and populate the XML catalog file using the
227 following commands as the <systemitem
228 class="username">root</systemitem> user:
229 </para>
230
231<screen role="root"><userinput>if [ ! -d /etc/xml ]; then install -v -m755 -d /etc/xml; fi &amp;&amp;
232if [ ! -f /etc/xml/catalog ]; then
233 xmlcatalog --noout --create /etc/xml/catalog
234fi &amp;&amp;
235
236xmlcatalog --noout --add "rewriteSystem" \
237 "https://cdn.docbook.org/release/xsl-nons/&docbook-xsl-version;" \
238 "/usr/share/xml/docbook/xsl-stylesheets-nons-&docbook-xsl-version;" \
239 /etc/xml/catalog &amp;&amp;
240
241xmlcatalog --noout --add "rewriteURI" \
242 "https://cdn.docbook.org/release/xsl-nons/&docbook-xsl-version;" \
243 "/usr/share/xml/docbook/xsl-stylesheets-nons-&docbook-xsl-version;" \
244 /etc/xml/catalog &amp;&amp;
245
246xmlcatalog --noout --add "rewriteSystem" \
247 "https://cdn.docbook.org/release/xsl-nons/current" \
248 "/usr/share/xml/docbook/xsl-stylesheets-nons-&docbook-xsl-version;" \
249 /etc/xml/catalog &amp;&amp;
250
251xmlcatalog --noout --add "rewriteURI" \
252 "https://cdn.docbook.org/release/xsl-nons/current" \
253 "/usr/share/xml/docbook/xsl-stylesheets-nons-&docbook-xsl-version;" \
254 /etc/xml/catalog &amp;&amp;
255
256xmlcatalog --noout --add "rewriteSystem" \
257 "http://docbook.sourceforge.net/release/xsl/current" \
258 "/usr/share/xml/docbook/xsl-stylesheets-nons-&docbook-xsl-version;" \
259 /etc/xml/catalog &amp;&amp;
260
261xmlcatalog --noout --add "rewriteURI" \
262 "http://docbook.sourceforge.net/release/xsl/current" \
263 "/usr/share/xml/docbook/xsl-stylesheets-nons-&docbook-xsl-version;" \
264 /etc/xml/catalog</userinput></screen>
265
266 <para>
267 Occasionally, you may find the need to install other versions of the
268 XSL stylesheets as some projects reference a specific version. One
269 example is BLFS-6.0, which required the 1.67.2 version. In these
270 instances you should install any other required version in its own
271 versioned directory and create catalog entries as follows (substitute
272 the desired version number for
273 <replaceable>&lt;version&gt;</replaceable>):
274 </para>
275
276<screen role="nodump"><userinput>xmlcatalog --noout --add "rewriteSystem" \
277 "http://docbook.sourceforge.net/release/xsl/<replaceable>&lt;version&gt;</replaceable>" \
278 "/usr/share/xml/docbook/xsl-stylesheets-<replaceable>&lt;version&gt;</replaceable>" \
279 /etc/xml/catalog &amp;&amp;
280
281xmlcatalog --noout --add "rewriteURI" \
282 "http://docbook.sourceforge.net/release/xsl/<replaceable>&lt;version&gt;</replaceable>" \
283 "/usr/share/xml/docbook/xsl-stylesheets-<replaceable>&lt;version&gt;</replaceable>" \
284 /etc/xml/catalog</userinput></screen>
285
286 </sect3>
287
288 </sect2>
289
290 <sect2 role="content">
291 <title>Contents</title>
292
293 <segmentedlist>
294 <segtitle>Installed Files</segtitle>
295 <segtitle>Installed Directories</segtitle>
296
297 <seglistitem>
298 <seg>/usr/share/xml/docbook/xsl-stylesheets-&docbook-xsl-version;/*/*.xsl</seg>
299 <seg>/usr/share/xml/docbook/xsl-stylesheets-&docbook-xsl-version; and
300 /usr/share/doc/docbook-xsl-&docbook-xsl-version;</seg>
301 </seglistitem>
302 </segmentedlist>
303
304 <variablelist>
305 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
306 <?dbfo list-presentation="list"?>
307 <?dbhtml list-presentation="table"?>
308
309 <varlistentry id="xsl-stylesheets">
310 <term><filename>XSL Stylesheets</filename></term>
311 <listitem>
312 <para>
313 are used for performing transformations on XML files
314 </para>
315 <indexterm zone="docbook-xsl xsl-stylesheets">
316 <primary sortas="g-XSL-Stylesheets">XSL Stylesheets</primary>
317 </indexterm>
318 </listitem>
319 </varlistentry>
320
321 </variablelist>
322
323 </sect2>
324
325</sect1>
Note: See TracBrowser for help on using the repository browser.