source: xsoft/graphweb/falkon.xml@ 7a9a7b26

lazarus trunk
Last change on this file since 7a9a7b26 was 7a9a7b26, checked in by Pierre Labastie <pierre.labastie@…>, 4 months ago

Remove spaces at the end of lines

  • Property mode set to 100644
File size: 7.8 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 falkon-download-http "https://download.kde.org/stable/falkon/&falkon-version;/falkon-&falkon-version;.tar.xz">
8 <!ENTITY falkon-download-ftp " ">
9 <!ENTITY falkon-md5sum "8733affc1d98770f4be1c9f587ad29b0">
10 <!ENTITY falkon-size "2.4 MB">
11 <!ENTITY falkon-buildsize "162 MB (without optional dependencies)">
12 <!ENTITY falkon-time "1.4 SBU (Using parallelism=4)">
13]>
14
15<sect1 id="falkon" xreflabel="falkon-&falkon-version;">
16 <?dbhtml filename="falkon.html"?>
17
18 <sect1info>
19 <date>$Date$</date>
20 </sect1info>
21
22 <title>Falkon-&falkon-version;</title>
23
24 <indexterm zone="falkon">
25 <primary sortas="a-falkon">falkon</primary>
26 </indexterm>
27
28 <sect2 role="package">
29 <title>Introduction to falkon</title>
30
31 <para>
32 <application>Falkon</application> is a KDE web browser using the QtWebEngine
33 rendering engine. It was previously known as <application>QupZilla</application>.
34 It aims to be a lightweight web browser available through all major platforms.
35 </para>
36
37 <para>
38 Although <application>falkon</application> is now part of KDE, it can be
39 installed without KDE (with the loss of <application>kwallet</application>
40 functionality).
41 </para>
42
43 <warning>
44 <para>
45 Falkon relies on QtWebEngine. That uses a forked copy of chromium, and
46 is therefore vulnerable to many issues found there. The Qt developers
47 have always preferred to make releases at the same time as the rest of Qt
48 (rather than adding emergency fixes). Now that they are keen to move to
49 Qt6, the 5.15.3 and later Qt-5.15 releases are initially only available
50 to paying customers. QtWebEngine is something of an exception because of
51 its LGPL licence, but getting the git sources (with the forked chromium
52 submodule) to a point where they will successfully build on a current
53 BLFS system can take a lot of effort. Be aware that future fixes for
54 vulnerabilities might be very delayed, to the extent that you might wish
55 to consider using a different browser.
56 </para>
57 </warning>
58
59 &lfs111_checked;
60
61 <bridgehead renderas="sect3">Package Information</bridgehead>
62 <itemizedlist spacing="compact">
63 <listitem>
64 <para>
65 Download (HTTP): <ulink url="&falkon-download-http;"/>
66 </para>
67 </listitem>
68 <listitem>
69 <para>
70 Download (FTP): <ulink url="&falkon-download-ftp;"/>
71 </para>
72 </listitem>
73 <listitem>
74 <para>
75 Download MD5 sum: &falkon-md5sum;
76 </para>
77 </listitem>
78 <listitem>
79 <para>
80 Download size: &falkon-size;
81 </para>
82 </listitem>
83 <listitem>
84 <para>
85 Estimated disk space required: &falkon-buildsize;
86 </para>
87 </listitem>
88 <listitem>
89 <para>
90 Estimated build time: &falkon-time;
91 </para>
92 </listitem>
93 </itemizedlist>
94
95 <bridgehead renderas="sect3">falkon Dependencies</bridgehead>
96
97 <bridgehead renderas="sect4">Required</bridgehead>
98 <para role="required">
99 <xref linkend="extra-cmake-modules"/>,
100 <xref linkend="kf5-frameworks"/> (for karchive), and
101 <xref linkend="qtwebengine"/>
102 </para>
103
104 <note>
105 <para>
106 Strictly speaking, only karchive is required to build falkon,
107 but several other packages in KF5 can be used if they are present. To
108 build only karchive, download that package from the directory specified
109 in <xref linkend="kf5-frameworks"/> and use the build instructions on
110 that page changing the $KF5_PREFIX to /usr.
111 </para>
112 </note>
113
114 <bridgehead renderas="sect4">Optional</bridgehead>
115 <para role="optional">
116 <xref linkend="gnome-keyring"/> and
117 <ulink
118 url="http://download.qt.io/official_releases/QtForPython/pyside2/">PySide2</ulink>
119 for experimental <application>Python</application> plugins (compiling this from
120 source is very slow).
121 </para>
122
123 <para condition="html" role="usernotes">
124 User Notes: <ulink url="&blfs-wiki;/falkon"/>
125 </para>
126 </sect2>
127
128 <sect2 role="installation">
129 <title>Installation of falkon</title>
130
131 <para>
132 Install <application>falkon</application> by running the following
133 commands:
134 </para>
135
136 <para>
137 Unless you have installed both PySide2 and ki18n, remove the translations
138 for the sample <command>hellopython.py</command> script:
139 </para>
140
141<screen><userinput>rm -rf po/</userinput></screen>
142<!--
143 <para>
144 Fix a missing include in Qt-5.14:
145 </para>
146
147<screen><userinput>sed -i '/#include &lt;QSettings&gt;/a#include &lt;QFile&gt;' \
148 src/plugins/VerticalTabs/verticaltabsplugin.cpp</userinput></screen>
149
150 <para>
151 Fix a build problem introduced in Qt-5.15:
152 </para>
153<screen><userinput remap="pre">sed -i '/#include &lt;QPainter&gt;/a #include &lt;QPainterPath&gt;' \
154 src/lib/tools/qztools.cpp</userinput></screen>
155-->
156 <para>
157 Now build the program:
158 </para>
159
160<screen><userinput>mkdir build &amp;&amp;
161cd build &amp;&amp;
162
163cmake -DCMAKE_INSTALL_PREFIX=/usr \
164 -DCMAKE_BUILD_TYPE=Release \
165 .. &amp;&amp;
166
167make</userinput></screen>
168
169 <para>
170 To test the results, issue: <command>make test</command>. All
171 tests should pass. If any fail, the full results will be in
172 <filename>Testing/Temporary/LastTest.log</filename>.
173 </para>
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 If you have installed <application>Pyside2</application> you will want to
183 examine the <command>hellopython.py</command> which is in the <filename
184 class="directory">scripts/</filename> directory, and perhaps copy it to
185 your home directory.
186 </para>
187
188 </sect2>
189
190 <sect2 role="commands">
191 <title>Command Explanations</title>
192
193 <para>
194 <option>-DBUILD_TESTING=OFF</option>: This will save a little time and space by
195 not building the test programs, use this if you do not wish to run the test.
196 </para>
197
198 </sect2>
199
200 <sect2 role="content">
201 <title>Contents</title>
202
203 <segmentedlist>
204 <segtitle>Installed Programs</segtitle>
205 <segtitle>Installed Library</segtitle>
206 <segtitle>Installed Directory</segtitle>
207
208 <seglistitem>
209 <seg>
210 falkon
211 </seg>
212 <seg>
213 libFalkonPrivate.so.3
214 </seg>
215 <seg>
216 ${FALKON_PREFIX}/lib/plugins, ${FALKON_PREFIX}/share/falkon.
217 </seg>
218 </seglistitem>
219 </segmentedlist>
220
221 <variablelist>
222 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
223 <?dbfo list-presentation="list"?>
224 <?dbhtml list-presentation="table"?>
225
226 <varlistentry id="falkon-prog">
227 <term><command>falkon</command></term>
228 <listitem>
229 <para>
230 is a web browser which uses qtwebengine
231 </para>
232 <indexterm zone="falkon falkon-prog">
233 <primary sortas="b-falkon">falkon</primary>
234 </indexterm>
235 </listitem>
236 </varlistentry>
237
238 <varlistentry id="libFalkonPrivate.so.3">
239 <term><filename class="libraryfile">libFalkonPrivate.so.3</filename></term>
240 <listitem>
241 <para>
242 contains functions used by falkon
243 </para>
244 <indexterm zone="falkon libFalkonPrivate.so.3">
245 <primary sortas="c-libFalkonPrivate.so.3">libFalkonPrivate.so.3</primary>
246 </indexterm>
247 </listitem>
248 </varlistentry>
249 </variablelist>
250 </sect2>
251
252</sect1>
Note: See TracBrowser for help on using the repository browser.