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

10.0 10.1 11.0 9.0 9.1 ken/refactor-virt lazarus qt5new trunk upgradedb xry111/git-date xry111/git-date-for-trunk xry111/git-date-test
Last change on this file since 8992526 was 8992526, checked in by Pierre Labastie <pieere@…>, 3 years ago

Make an optional instructions "nodump"

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

  • Property mode set to 100644
File size: 10.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 "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-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>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 &lfs84_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-nons-&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-nons-&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-nons-&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-nons-&docbook-xsl-version; &amp;&amp;
147
148ln -s VERSION /usr/share/xml/docbook/xsl-stylesheets-nons-&docbook-xsl-version;/VERSION.xsl &amp;&amp;
149
150install -v -m644 -D README \
151 /usr/share/doc/docbook-xsl-nons-&docbook-xsl-version;/README.txt &amp;&amp;
152install -v -m644 RELEASE-NOTES* NEWS* \
153 /usr/share/doc/docbook-xsl-nons-&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-nons-&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 <note>
181 <para>If you are installing the current version of docbook-xsl-nons
182 over a previous version of docbook-xsl, then remove the old
183 rewrite entries in the catalog as the <systemitem
184 class="username">root</systemitem> user:</para>
185
186<screen role="nodump"><userinput>sed -i '/rewrite/d' /etc/xml/catalog</userinput></screen>
187 </note>
188
189 <para>Create (or append) and populate the XML catalog file using the
190 following commands as the <systemitem class="username">root</systemitem>
191 user:</para>
192
193<screen role="root"><userinput>if [ ! -d /etc/xml ]; then install -v -m755 -d /etc/xml; fi &amp;&amp;
194if [ ! -f /etc/xml/catalog ]; then
195 xmlcatalog --noout --create /etc/xml/catalog
196fi &amp;&amp;
197
198xmlcatalog --noout --add "rewriteSystem" \
199 "https://cdn.docbook.org/release/xsl-nons/&docbook-xsl-version;" \
200 "/usr/share/xml/docbook/xsl-stylesheets-nons-&docbook-xsl-version;" \
201 /etc/xml/catalog &amp;&amp;
202
203xmlcatalog --noout --add "rewriteURI" \
204 "https://cdn.docbook.org/release/xsl-nons/&docbook-xsl-version;" \
205 "/usr/share/xml/docbook/xsl-stylesheets-nons-&docbook-xsl-version;" \
206 /etc/xml/catalog &amp;&amp;
207
208xmlcatalog --noout --add "rewriteSystem" \
209 "https://cdn.docbook.org/release/xsl-nons/current" \
210 "/usr/share/xml/docbook/xsl-stylesheets-nons-&docbook-xsl-version;" \
211 /etc/xml/catalog &amp;&amp;
212
213xmlcatalog --noout --add "rewriteURI" \
214 "https://cdn.docbook.org/release/xsl-nons/current" \
215 "/usr/share/xml/docbook/xsl-stylesheets-nons-&docbook-xsl-version;" \
216 /etc/xml/catalog &amp;&amp;
217
218xmlcatalog --noout --add "rewriteSystem" \
219 "http://docbook.sourceforge.net/release/xsl/current" \
220 "/usr/share/xml/docbook/xsl-stylesheets-nons-&docbook-xsl-version;" \
221 /etc/xml/catalog &amp;&amp;
222
223xmlcatalog --noout --add "rewriteURI" \
224 "http://docbook.sourceforge.net/release/xsl/current" \
225 "/usr/share/xml/docbook/xsl-stylesheets-nons-&docbook-xsl-version;" \
226 /etc/xml/catalog</userinput></screen>
227
228 <para>Occasionally, you may find the need to install other versions of
229 the XSL stylesheets as some projects reference a specific version. One
230 example is BLFS-6.0, which required the 1.67.2 version. In these instances
231 you should install any other required version in its own versioned
232 directory and create catalog entries as follows (substitute the desired
233 version number for <replaceable>&lt;version&gt;</replaceable>):</para>
234
235<screen role="nodump"><userinput>xmlcatalog --noout --add "rewriteSystem" \
236 "http://docbook.sourceforge.net/release/xsl/<replaceable>&lt;version&gt;</replaceable>" \
237 "/usr/share/xml/docbook/xsl-stylesheets-<replaceable>&lt;version&gt;</replaceable>" \
238 /etc/xml/catalog &amp;&amp;
239
240xmlcatalog --noout --add "rewriteURI" \
241 "http://docbook.sourceforge.net/release/xsl/<replaceable>&lt;version&gt;</replaceable>" \
242 "/usr/share/xml/docbook/xsl-stylesheets-<replaceable>&lt;version&gt;</replaceable>" \
243 /etc/xml/catalog</userinput></screen>
244
245 </sect3>
246
247 </sect2>
248
249 <sect2 role="content">
250 <title>Contents</title>
251
252 <segmentedlist>
253 <segtitle>Installed Programs</segtitle>
254 <segtitle>Installed Libraries</segtitle>
255 <segtitle>Installed Directories</segtitle>
256
257 <seglistitem>
258 <seg>None</seg>
259 <seg>None</seg>
260 <seg>/usr/share/xml/docbook/xsl-stylesheets-&docbook-xsl-version; and
261 /usr/share/doc/docbook-xsl-&docbook-xsl-version;</seg>
262 </seglistitem>
263 </segmentedlist>
264
265 </sect2>
266
267</sect1>
Note: See TracBrowser for help on using the repository browser.