glfs/xsoft/graphweb/qupzilla.xml

236 lines
6.9 KiB
XML
Raw Normal View History

<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
"http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
<!ENTITY % general-entities SYSTEM "../../general.ent">
%general-entities;
<!-- https://github.com/QupZilla/qupzilla/tags
https://github.com/QupZilla/qupzilla/releases/download/v2.0.0/QupZilla-2.0.0.tar.xz
-->
<!ENTITY qupzilla-download-http "https://github.com/QupZilla/qupzilla/releases/download/v&qupzilla-version;/QupZilla-&qupzilla-version;.tar.xz">
<!ENTITY qupzilla-download-ftp " ">
<!ENTITY qupzilla-md5sum "84e4b9dda1e0bb5ad96f3b87f9fc1328">
<!ENTITY qupzilla-size "2.6 MB">
<!ENTITY qupzilla-buildsize "63 MB">
<!ENTITY qupzilla-time "4.3 SBU">
]>
<sect1 id="qupzilla" xreflabel="QupZilla-&qupzilla-version;">
<?dbhtml filename="qupzilla.html"?>
<sect1info>
<othername>$LastChangedBy$</othername>
<date>$Date$</date>
</sect1info>
<title>QupZilla-&qupzilla-version;</title>
<indexterm zone="qupzilla">
<primary sortas="a-QupZilla">QupZilla</primary>
</indexterm>
<sect2 role="package">
<title>Introduction to QupZilla</title>
<para>
<application>QupZilla</application> is a fast, feature-rich and
lightweight <application>QtWebEngine</application> based browser,
originally intended only for educational purposes.
</para>
&lfs81_checked;
<bridgehead renderas="sect3">Package Information</bridgehead>
<itemizedlist spacing="compact">
<listitem>
<para>
Download (HTTP): <ulink url="&qupzilla-download-http;"/>
</para>
</listitem>
<listitem>
<para>
Download (FTP): <ulink url="&qupzilla-download-ftp;"/>
</para>
</listitem>
<listitem>
<para>
Download MD5 sum: &qupzilla-md5sum;
</para>
</listitem>
<listitem>
<para>
Download size: &qupzilla-size;
</para>
</listitem>
<listitem>
<para>
Estimated disk space required: &qupzilla-buildsize;
</para>
</listitem>
<listitem>
<para>
Estimated build time: &qupzilla-time;
</para>
</listitem>
</itemizedlist>
<bridgehead renderas="sect3">Additional Downloads</bridgehead>
<itemizedlist spacing="compact">
<listitem>
<para>
Required patch to build with OpenSSL-1.1:
<ulink url="&patch-root;/qupzilla-&qupzilla-version;-openssl1.1-1.patch"/>
</para>
</listitem>
</itemizedlist>
<bridgehead renderas="sect3">QupZilla Dependencies</bridgehead>
<bridgehead renderas="sect4">Required</bridgehead>
<para role="required">
<xref linkend="qtwebengine"/>
</para>
<bridgehead renderas="sect4">Optional</bridgehead>
<para role="optional">
<xref linkend="gdb"/>,
<!-- <xref linkend="kdelibs"/> (KWallet plugin), -->
<ulink url="http://hunspell.sourceforge.net/">Hunspell</ulink>, and
<ulink url="&gnome-download-ftp;/libgnome-keyring/">libgnome-keyring</ulink> (Gnome-Keyring plugin)
</para>
<para condition="html" role="usernotes">
User Notes: <ulink url="&blfs-wiki;/qupzilla"/>
</para>
</sect2>
<sect2 role="installation">
<title>Installation of QupZilla</title>
<para>
Install <application>QupZilla</application> by running the following
commands:
</para>
<screen><userinput>patch -p1 -i ../qupzilla-&qupzilla-version;-openssl1.1-1.patch &amp;&amp;
export QUPZILLA_PREFIX=/usr &amp;&amp;
qmake &amp;&amp;
make</userinput></screen>
<para>
The <command>export</command> command is used for configuring the build.
Alternatively, you can add the environment variable to
<filename>src/defines.pri</filename>.
</para>
<para>
This package does not come with a test suite.
</para>
<para>
Now, as the <systemitem class="username">root</systemitem> user:
</para>
<screen role="root"><userinput>make install</userinput></screen>
<para>
If <xref linkend="desktop-file-utils"/> and <xref linkend="xdg-utils"/>
are installed, run as, the <systemitem
class="username">root</systemitem> user:
</para>
<screen role="root"><userinput>xdg-icon-resource forceupdate --theme hicolor &amp;&amp;
update-desktop-database -q</userinput></screen>
</sect2>
<sect2 role="commands">
<title>Command Explanations</title>
<note>
<para>
If you wish to use any of the following variables, they need to be
exported. You can add them to the <command>export</command> block in
the main instructions. Alternatively, instead of exporting, they can
be added, one at a line, to <filename>src/defines.pri</filename>.
</para>
</note>
<para>
<envar>CONFIG += debug</envar>: Use if you want to build QupZilla with
debugging symbols.
</para>
<para>
<envar>GNOME_INTEGRATION=true</envar>: Enables Gnome integration, this
meaning the build of Gnome-Keyring Password plugin, which provides
support for storing passwords in Gnome-Keyring.
</para>
<para>
<envar>KDE_INTEGRATION=true</envar>: Enables KDE integration, this
meaning the build of KWallet Password plugin, which provides support for
storing passwords in KWallet.
</para>
</sect2>
<sect2 role="content">
<title>Contents</title>
<segmentedlist>
<segtitle>Installed Program</segtitle>
<segtitle>Installed Libraries</segtitle>
<segtitle>Installed Directory</segtitle>
<seglistitem>
<seg>
qupzilla
</seg>
<seg>
libQupZilla.so and plugins under $LXQT_PREFIX/lib/qupzilla/
</seg>
<seg>
$LXQT_PREFIX/{lib,share}/qupzilla
</seg>
</seglistitem>
</segmentedlist>
<variablelist>
<bridgehead renderas="sect3">Short Descriptions</bridgehead>
<?dbfo list-presentation="list"?>
<?dbhtml list-presentation="table"?>
<varlistentry id="qupzilla-prog">
<term><command>qupzilla</command></term>
<listitem>
<para>
is a lightweight <application>QtWebEngine</application> web browser.
</para>
<indexterm zone="qupzilla qupzilla-prog">
<primary sortas="b-qupzilla">qupzilla</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="libQupZilla">
<term><filename class="libraryfile">libQupZilla.so</filename></term>
<listitem>
<para>
contains the <application>libQupZilla</application> API functions.
</para>
<indexterm zone="qupzilla libQupZilla">
<primary sortas="c-libQupZilla">libQupZilla.so</primary>
</indexterm>
</listitem>
</varlistentry>
</variablelist>
</sect2>
</sect1>