source: archive/webkitgtk2.xml

trunk
Last change on this file was 45ab6c7, checked in by Xi Ruoyao <xry111@…>, 3 months ago

more SVN prop clean up

Remove "$LastChanged$" everywhere, and also some unused $Date$

  • Property mode set to 100644
File size: 13.0 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 webkitgtk2-download-http "http://webkitgtk.org/releases/webkitgtk-&webkitgtk2-version;.tar.xz">
8 <!ENTITY webkitgtk2-download-ftp " ">
9 <!ENTITY webkitgtk2-md5sum "1b3f18d4087dfc648e8060c14e16e202">
10 <!ENTITY webkitgtk2-size "9.4 MB">
11 <!ENTITY webkitgtk2-buildsize "1.5 GB (both built)">
12 <!ENTITY webkitgtk2-time "50 SBU (using parallelism=4, both built, webkitgtk-3.0 takes a little longer than webkitgtk-1.0)">
13]>
14
15<sect1 id="webkitgtk2" xreflabel="WebKitGTK+-&webkitgtk2-version;">
16 <?dbhtml filename="webkitgtk2.html"?>
17
18 <sect1info>
19 <date>$Date$</date>
20 </sect1info>
21
22 <title>WebKitGTK+-&webkitgtk2-version;</title>
23
24 <indexterm zone="webkitgtk2">
25 <primary sortas="a-WebKitGTK+">WebKitGTK+</primary>
26 </indexterm>
27
28 <sect2 role="package">
29 <title>Introduction to WebKitGTK+</title>
30
31 <para>
32 The <application>WebKitGTK+</application> is the port of the portable web
33 rendering engine <application>WebKit</application> to the
34 <application>GTK+ 3</application> and/or <application>GTK+
35 2</application> platforms.
36 </para>
37
38 &lfs79_checked;
39
40 <bridgehead renderas="sect3">Package Information</bridgehead>
41 <itemizedlist spacing="compact">
42 <listitem>
43 <para>
44 Download (HTTP): <ulink url="&webkitgtk2-download-http;"/>
45 </para>
46 </listitem>
47 <listitem>
48 <para>
49 Download (FTP): <ulink url="&webkitgtk2-download-ftp;"/>
50 </para>
51 </listitem>
52 <listitem>
53 <para>
54 Download MD5 sum: &webkitgtk2-md5sum;
55 </para>
56 </listitem>
57 <listitem>
58 <para>
59 Download size: &webkitgtk2-size;
60 </para>
61 </listitem>
62 <listitem>
63 <para>
64 Estimated disk space required: &webkitgtk2-buildsize;
65 </para>
66 </listitem>
67 <listitem>
68 <para>
69 Estimated build time: &webkitgtk2-time;
70 </para>
71 </listitem>
72 </itemizedlist>
73
74 <bridgehead renderas="sect3">WebKitGTK+ Dependencies</bridgehead>
75
76 <bridgehead renderas="sect4">Required</bridgehead>
77 <para role="required">
78 <xref linkend="gst10-plugins-base"/>,
79 <xref linkend="gtk2"/> or
80 <xref linkend="gtk3"/>,
81 <xref linkend="icu"/>,
82 <xref linkend="libgudev"/>,
83 <xref linkend="libsecret"/>,
84 <xref linkend="libsoup"/>,
85 <xref linkend="libwebp"/>,
86 <xref linkend="mesa"/>,
87 <xref linkend="ruby"/>,
88 <xref linkend="sqlite"/> and
89 <xref linkend="which"/>
90 </para>
91
92 <note><para>
93 <application>WebKit2</application> links against<application>GTK+
94 2</application> (even if <application>GTK+ 3</application> is being
95 used), in order to be able to use NPAPI plugins such as Adobe Flash.
96 </para></note>
97
98
99 <bridgehead renderas="sect4">Recommended</bridgehead>
100 <para role="recommended">
101 <xref linkend="enchant"/>,
102 <xref linkend="geoclue"/>,
103 <xref linkend="gobject-introspection"/>,
104 <xref linkend="hicolor-icon-theme"/>
105 </para>
106
107 <bridgehead renderas="sect4">Optional</bridgehead>
108 <para role="optional">
109 <xref linkend="gtk-doc"/>,
110 <xref linkend="harfbuzz"/>,
111 <xref linkend="llvm"/>,
112 <ulink url="http://freedesktop.org/wiki/Software/GeoClue/">GeoClue2</ulink>, and
113 <ulink url="http://xsltml.sourceforge.net/">MathML</ulink>
114 </para>
115
116 <para condition="html" role="usernotes">
117 User Notes: <ulink url="&blfs-wiki;/webkitgtk"/>
118 </para>
119 </sect2>
120
121 <sect2 role="installation">
122 <title>Installation of WebKitGTK+</title>
123
124 <para>
125 If you have not installed <xref linkend="gtk-doc"/>, fix a bug that will
126 cause <command>make install</command> to fail:
127 </para>
128
129<screen><userinput>sed -e '/generate-gtkdoc --rebase/s:^:# :' \
130 -i GNUmakefile.in</userinput></screen>
131
132 <para>
133 Upstream standard now is to link this package against <application>GTK+
134 3</application>. However, for backward compatibility, many users need
135 also another instance, linked to <application>GTK+ 2</application>. Both
136 can be installed in the same system, without any problems. However, some
137 packages can alternatively be linked to either one. Here, both build
138 methods are presented and recommended to be built, but if you know which
139 one you need, just jump to the respective part.
140 </para>
141
142<!-- ==== WebKitGTK+ against GTK+ 3 ====== -->
143 <bridgehead renderas="sect3">Build and install
144 <application>WebKitGTK+</application> against <application>GTK+
145 3</application></bridgehead>
146
147 <para>
148 Install <application>WebKitGTK+</application> by running the
149 following commands:
150 </para>
151
152<screen><userinput>mkdir -vp build-3 &amp;&amp;
153cp -a Documentation build-3 &amp;&amp;
154cd build-3 &amp;&amp;
155
156../configure --prefix=/usr --enable-introspection &amp;&amp;
157make</userinput></screen>
158
159 <para>
160 This package does not have a working testsuite. However, there are two
161 useable basic graphical web browsers in the build directory,
162 <application>Programs/GtkLauncher</application> and
163 <application>Programs/MiniBrowser</application>. If launching any one
164 fails, there is a problem with the build.
165 </para>
166
167 <note><para>
168 When installing, the Makefile does some additional compiling and linking.
169 If you do not have Xorg in /usr, the LIBRARY_PATH and PKG_CONFIG_PATH
170 variables need to be defined for the root user. If using sudo to assume
171 root, use the -E option to pass your current environment variables for the
172 install process.
173 </para></note>
174
175 <para>
176 Now, as the <systemitem class="username">root</systemitem> user:
177 </para>
178
179<screen role="root"><userinput>make install</userinput></screen>
180
181 <para>
182 Finally, leave the buid directory:
183 </para>
184
185<screen><userinput>cd ..</userinput></screen>
186
187<!-- ==== WebKitGTK+ against GTK+ 2 ====== -->
188 <bridgehead renderas="sect3">Build and install
189 <application>WebKitGTK+</application> against <application>GTK+
190 2</application></bridgehead>
191
192 <para>
193 Install <application>WebKitGTK+</application> by running the
194 following commands:
195 </para>
196
197<screen><userinput>mkdir -vp build-1</userinput></screen>
198
199 <para>
200 If you have built and installed the package against <application>GTK+
201 3</application>. skip the following command, because the previous
202 docummentation also applies here:
203 </para>
204
205<screen><userinput>cp -a Documentation build-1</userinput></screen>
206
207 <para>
208 Now, change into the build directory and effectively start the build and
209 install:
210 </para>
211
212<screen><userinput>cd build-1 &amp;&amp;
213
214../configure --prefix=/usr \
215 --with-gtk=2.0 \
216 --disable-webkit2 &amp;&amp;
217make</userinput></screen>
218
219 <para>
220 This package does not have a working testsuite. However, there is one
221 useable basic graphical web browser in the build directory,
222 <application>Programs/GtkLauncher</application>. If launching it
223 fails, there is a problem with the build.
224 </para>
225
226 <note><para>
227 When installing, the Makefile does some additional compiling and linking.
228 If you do not have Xorg in /usr, the LIBRARY_PATH and PKG_CONFIG_PATH
229 variables need to be defined for the root user. If using sudo to assume
230 root, use the -E option to pass your current environment variables for the
231 install process.
232 </para></note>
233
234 <para>
235 Now, as the <systemitem class="username">root</systemitem> user:
236 </para>
237
238<screen role="root"><userinput>make install</userinput></screen>
239
240 <para>
241 Finally, leave the buid directory:
242 </para>
243
244<screen><userinput>cd ..</userinput></screen>
245
246 </sect2>
247
248 <sect2 role="commands">
249 <title>Command Explanations</title>
250
251 <para>
252 <option>--enable-introspection</option>: This switch enables support for
253 <application>Gobject Introspection</application> and is required for a
254 <application>GNOME</application> Desktop. Remove if you don't have
255 <application>Gobject Introspection</application> installed or you don't
256 want to install <application>GNOME</application>.
257 </para>
258
259 <para>
260 <option>--disable-geolocation</option>: Use this option if you did not
261 install <xref linkend="geoclue"/> or <command>configure</command> will
262 fail.
263 </para>
264
265 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
266 href="../../xincludes/gtk-doc-rebuild.xml"/>
267
268 </sect2>
269
270 <sect2 role="content">
271 <title>Contents</title>
272
273 <segmentedlist>
274 <segtitle>Installed Programs</segtitle>
275 <segtitle>Installed Libraries</segtitle>
276 <segtitle>Installed Directories</segtitle>
277
278 <seglistitem>
279 <seg>
280 jsc-1 and jsc-3
281 </seg>
282 <seg>
283 libjavascriptcoregtk-{1,3}.0.so,
284 libwebkit2gtk-3.0.so, and
285 libwebkitgtk-{1,3}.0.so
286 </seg>
287 <seg>
288 /usr/include/webkitgtk-{1,3}.0,
289 /usr/lib/webkit2gtk-3.0,
290 /usr/share/gtk-doc/html/webkit{2,dom,}gtk, and
291 /usr/share/webkitgtk-{1,3}.0
292 </seg>
293 </seglistitem>
294 </segmentedlist>
295
296 <variablelist>
297 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
298 <?dbfo list-presentation="list"?>
299 <?dbhtml list-presentation="table"?>
300
301 <varlistentry id="jsc-1">
302 <term><command>jsc-1</command></term>
303 <listitem>
304 <para>
305 is a command-line utility that allows you to run JavaScript programs
306 outside of the context of a web browser.
307 </para>
308 <indexterm zone="webkitgtk2 jsc-1">
309 <primary sortas="b-jsc-1">jsc-1</primary>
310 </indexterm>
311 </listitem>
312 </varlistentry>
313
314 <varlistentry id="jsc-3">
315 <term><command>jsc-3</command></term>
316 <listitem>
317 <para>
318 is a command-line utility that allows you to run JavaScript programs
319 outside of the context of a web browser.
320 </para>
321 <indexterm zone="webkitgtk2 jsc-3">
322 <primary sortas="b-jsc-3">jsc-3</primary>
323 </indexterm>
324 </listitem>
325 </varlistentry>
326
327 <varlistentry id="libjavascriptcoregtk-1">
328 <term><filename
329 class="libraryfile">libjavascriptcoregtk-1.0.so</filename></term>
330 <listitem>
331 <para>
332 contains core JavaScript API functions used by
333 <command>jsc-1</command> and <filename
334 class="libraryfile">libwebkitgtk-1.0.so</filename>.
335 </para>
336 <indexterm zone="webkitgtk2 libjavascriptcoregtk-1">
337 <primary sortas="c-libjavascriptcoregtk-1">libjavascriptcoregtk-1.0.so</primary>
338 </indexterm>
339 </listitem>
340 </varlistentry>
341
342 <varlistentry id="libjavascriptcoregtk-3">
343 <term><filename
344 class="libraryfile">libjavascriptcoregtk-3.0.so</filename></term>
345 <listitem>
346 <para>
347 contains core JavaScript API functions used by
348 <command>jsc-3</command> and <filename
349 class="libraryfile">libwebkitgtk-3.0.so</filename>.
350 </para>
351 <indexterm zone="webkitgtk2 libjavascriptcoregtk-3">
352 <primary sortas="c-libjavascriptcoregtk-3">libjavascriptcoregtk-3.0.so</primary>
353 </indexterm>
354 </listitem>
355 </varlistentry>
356
357 <varlistentry id="libwebkitgtk-1">
358 <term><filename class="libraryfile">libwebkitgtk-1.0.so</filename></term>
359 <listitem>
360 <para>
361 contains the <application>WebKitGTK+</application> API functions for
362 <application>GTK+ 2</application>.
363 </para>
364 <indexterm zone="webkitgtk2 libwebkitgtk-1">
365 <primary sortas="c-libwebkitgtk-1">libwebkitgtk-1.0.so</primary>
366 </indexterm>
367 </listitem>
368 </varlistentry>
369
370 <varlistentry id="libwebkitgtk-3">
371 <term><filename class="libraryfile">libwebkitgtk-3.0.so</filename></term>
372 <listitem>
373 <para>
374 contains the <application>WebKitGTK+</application> API functions for
375 <application>GTK+ 3</application>.
376 </para>
377 <indexterm zone="webkitgtk2 libwebkitgtk-3">
378 <primary sortas="c-libwebkitgtk-3">libwebkitgtk-3.0.so</primary>
379 </indexterm>
380 </listitem>
381 </varlistentry>
382
383 <varlistentry id="libwebkit2gtk-3">
384 <term><filename class="libraryfile">libwebkit2gtk-3.0.so</filename></term>
385 <listitem>
386 <para>
387 contains the <application>WebKit2</application> API functions.
388 </para>
389 <indexterm zone="webkitgtk2 libwebkit2gtk-3">
390 <primary sortas="c-libwebkit2gtk-3">libwebkit2gtk-3.0.so</primary>
391 </indexterm>
392 </listitem>
393 </varlistentry>
394
395 </variablelist>
396
397 </sect2>
398
399</sect1>
Note: See TracBrowser for help on using the repository browser.