source: pst/xml/docbook-xsl.xml@ 6c73ed0

12.1 ken/TL2024 ken/tuningfonts lazarus plabs/newcss python3.11 rahul/power-profiles-daemon renodr/vulkan-addition trunk xry111/llvm18
Last change on this file since 6c73ed0 was 2778259, checked in by Xi Ruoyao <xry111@…>, 10 months ago

docbook-xsl: Drop reference to Python 2

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