source: pst/xml/docbook-xsl.xml@ 4c24eb0a

10.1 11.0 11.1 11.2 11.3 12.0 12.1 kea ken/TL2024 ken/inkscape-core-mods ken/tuningfonts lazarus lxqt plabs/newcss plabs/python-mods python3.11 qt5new rahul/power-profiles-daemon renodr/vulkan-addition trunk upgradedb xry111/intltool xry111/llvm18 xry111/soup3 xry111/test-20220226 xry111/xf86-video-removal
Last change on this file since 4c24eb0a was 4c24eb0a, checked in by Pierre Labastie <pieere@…>, 3 years ago

Remove period at the end of short descriptions.
In the process, some attributes in single quotes have been changed to double
quotes, and a few attribute lists have been written on one line instead of
several lines.

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