source: pst/xml/docbook-xsl.xml@ 07499ecc

10.0 10.1 11.0 8.3 8.4 9.0 9.1 basic bdubbs/svn elogind ken/refactor-virt lazarus perl-modules qt5new trunk xry111/git-date xry111/git-date-for-trunk xry111/git-date-test
Last change on this file since 07499ecc was 07499ecc, checked in by Bruce Dubbs <bdubbs@…>, 3 years ago

Archive udisks
Tags for general/progs

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

  • Property mode set to 100644
File size: 9.6 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 &lfs83_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 <listitem>
71 <para>Required patch: <ulink
72 url="&patch-root;/docbook-xsl-&docbook-xsl-version;-stack_fix-1.patch"/>
73 </para>
74 </listitem>
75 </itemizedlist>
76
77 <itemizedlist spacing="compact">
78 <title>Optional documentation</title>
79 <listitem>
80 <para>Download (HTTP): <ulink url="&docbook-xsl-doc-download;"/></para>
81 </listitem>
82 <listitem>
83 <para>Download MD5 sum: &docbook-xsl-doc-md5sum;</para>
84 </listitem>
85 <listitem>
86 <para>Download size: &docbook-xsl-doc-size;</para>
87 </listitem>
88 </itemizedlist>
89
90 <bridgehead renderas="sect3">DocBook XSL Stylesheets Dependencies</bridgehead>
91
92 <bridgehead renderas="sect4">Recommended (at runtime)</bridgehead>
93 <para role="recommended"><xref role="runtime" linkend="libxml2"/></para>
94
95 <bridgehead renderas="sect4">Optional (all used at runtime)</bridgehead>
96 <para role="optional">
97 <xref role="runtime" linkend="apache-ant"/>
98 (to produce <quote>webhelp</quote> documents),
99 <xref role="runtime" linkend="libxslt"/>
100 (or any other XSLT processor), to process
101 Docbook documents - the <application>Python2</application> modules
102 libxml2 and libxslt can be used,
103 <xref role="runtime" linkend="python2"/> (at runtime),
104 <xref role="runtime" linkend="ruby"/>
105 (to utilize the <quote>epub</quote> stylesheets),
106 <xref role="runtime" linkend="zip"/>
107 (to produce <quote>epub3</quote> documents), and
108 <ulink url="http://sourceforge.net/projects/saxon/files/saxon6/">
109 Saxon6
110 </ulink> and
111 <ulink url="http://xerces.apache.org/xerces2-j/">Xerces2 Java</ulink>
112 (used with <xref role="runtime" linkend="apache-ant"/>
113 to produce <quote>webhelp</quote> documents)
114 </para>
115
116 <para condition="html" role="usernotes">User Notes:
117 <ulink url="&blfs-wiki;/docbook-xsl"/></para>
118
119 </sect2>
120
121 <sect2 role="installation">
122 <title>Installation of DocBook XSL Stylesheets</title>
123
124 <para>First, fix a problem that causes stack overflows when doing recursion:</para>
125
126<screen><userinput>patch -Np1 -i ../docbook-xsl-&docbook-xsl-version;-stack_fix-1.patch</userinput></screen>
127
128 <para>If you downloaded the optional documentation tarball, unpack it
129 with the following command:</para>
130
131<screen><userinput>tar -xf ../docbook-xsl-doc-&docbook-xsl-version;.tar.bz2 --strip-components=1</userinput></screen>
132
133 <para>BLFS does not install the required packages to run the test suite
134 and provide meaningful results.</para>
135
136 <para>Install <application>DocBook XSL Stylesheets</application>
137 by running the following commands as the
138 <systemitem class="username">root</systemitem> user:</para>
139
140<screen role="root"><userinput>install -v -m755 -d /usr/share/xml/docbook/xsl-stylesheets-&docbook-xsl-version; &amp;&amp;
141
142cp -v -R VERSION assembly common eclipse epub epub3 extensions fo \
143 highlighting html htmlhelp images javahelp lib manpages params \
144 profiling roundtrip slides template tests tools webhelp website \
145 xhtml xhtml-1_1 xhtml5 \
146 /usr/share/xml/docbook/xsl-stylesheets-&docbook-xsl-version; &amp;&amp;
147
148ln -s VERSION /usr/share/xml/docbook/xsl-stylesheets-&docbook-xsl-version;/VERSION.xsl &amp;&amp;
149
150install -v -m644 -D README \
151 /usr/share/doc/docbook-xsl-&docbook-xsl-version;/README.txt &amp;&amp;
152install -v -m644 RELEASE-NOTES* NEWS* \
153 /usr/share/doc/docbook-xsl-&docbook-xsl-version;</userinput></screen>
154
155 <para>If you downloaded the optional documentation tarball, install the
156 documentation by issuing the following command as the
157 <systemitem class="username">root</systemitem> user:</para>
158
159<screen role="root"><userinput>cp -v -R doc/* /usr/share/doc/docbook-xsl-&docbook-xsl-version;</userinput></screen>
160
161 </sect2>
162
163 <sect2 role="configuration">
164 <title>Configuring DocBook XSL Stylesheets</title>
165
166 <sect3 id="docbook-xsl-config">
167 <title>Config Files</title>
168
169 <para><filename>/etc/xml/catalog</filename></para>
170
171 <indexterm zone="docbook-xsl docbook-xsl-config">
172 <primary sortas="e-etc-xml-catalog">/etc/xml/catalog</primary>
173 </indexterm>
174
175 </sect3>
176
177 <sect3>
178 <title>Configuration Information</title>
179
180 <para>Create (or append) and populate the XML catalog file using the
181 following commands as the <systemitem class="username">root</systemitem>
182 user:</para>
183
184<screen role="root"><userinput>if [ ! -d /etc/xml ]; then install -v -m755 -d /etc/xml; fi &amp;&amp;
185if [ ! -f /etc/xml/catalog ]; then
186 xmlcatalog --noout --create /etc/xml/catalog
187fi &amp;&amp;
188
189xmlcatalog --noout --add "rewriteSystem" \
190 "http://docbook.sourceforge.net/release/xsl/&docbook-xsl-version;" \
191 "/usr/share/xml/docbook/xsl-stylesheets-&docbook-xsl-version;" \
192 /etc/xml/catalog &amp;&amp;
193
194xmlcatalog --noout --add "rewriteURI" \
195 "http://docbook.sourceforge.net/release/xsl/&docbook-xsl-version;" \
196 "/usr/share/xml/docbook/xsl-stylesheets-&docbook-xsl-version;" \
197 /etc/xml/catalog &amp;&amp;
198
199xmlcatalog --noout --add "rewriteSystem" \
200 "http://docbook.sourceforge.net/release/xsl/current" \
201 "/usr/share/xml/docbook/xsl-stylesheets-&docbook-xsl-version;" \
202 /etc/xml/catalog &amp;&amp;
203
204xmlcatalog --noout --add "rewriteURI" \
205 "http://docbook.sourceforge.net/release/xsl/current" \
206 "/usr/share/xml/docbook/xsl-stylesheets-&docbook-xsl-version;" \
207 /etc/xml/catalog</userinput></screen>
208
209 <para>Occasionally, you may find the need to install other versions of
210 the XSL stylesheets as some projects reference a specific version. One
211 example is BLFS-6.0, which required the 1.67.2 version. In these instances
212 you should install any other required version in its own versioned
213 directory and create catalog entries as follows (substitute the desired
214 version number for <replaceable>&lt;version&gt;</replaceable>):</para>
215
216<screen role="nodump"><userinput>xmlcatalog --noout --add "rewriteSystem" \
217 "http://docbook.sourceforge.net/release/xsl/<replaceable>&lt;version&gt;</replaceable>" \
218 "/usr/share/xml/docbook/xsl-stylesheets-<replaceable>&lt;version&gt;</replaceable>" \
219 /etc/xml/catalog &amp;&amp;
220
221xmlcatalog --noout --add "rewriteURI" \
222 "http://docbook.sourceforge.net/release/xsl/<replaceable>&lt;version&gt;</replaceable>" \
223 "/usr/share/xml/docbook/xsl-stylesheets-<replaceable>&lt;version&gt;</replaceable>" \
224 /etc/xml/catalog</userinput></screen>
225
226 </sect3>
227
228 </sect2>
229
230 <sect2 role="content">
231 <title>Contents</title>
232
233 <segmentedlist>
234 <segtitle>Installed Programs</segtitle>
235 <segtitle>Installed Libraries</segtitle>
236 <segtitle>Installed Directories</segtitle>
237
238 <seglistitem>
239 <seg>None</seg>
240 <seg>None</seg>
241 <seg>/usr/share/xml/docbook/xsl-stylesheets-&docbook-xsl-version; and
242 /usr/share/doc/docbook-xsl-&docbook-xsl-version;</seg>
243 </seglistitem>
244 </segmentedlist>
245
246 </sect2>
247
248</sect1>
Note: See TracBrowser for help on using the repository browser.