source: x/lib/qtwebkit5.xml@ 6d5acf3

<?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;

  <!ENTITY qtwebkit-major "5.8">
  <!ENTITY qtwebkit-url   "http://download.qt.io/community_releases/&qtwebkit-major;/&qtwebkit-version;-final">

  <!ENTITY qtwebkit-download-http "&qtwebkit-url;/qtwebkit-opensource-src-&qtwebkit-version;.tar.xz">
  <!ENTITY qtwebkit-download-ftp  " ">
  <!ENTITY qtwebkit-md5sum        "60a6935aca4a7c553d0ec4646ceed3b4">
  <!ENTITY qtwebkit-size          "34 MB">
  <!ENTITY qtwebkit-buildsize     "766 MB (50 MB installed)">
  <!ENTITY qtwebkit-time          "11 SBU (using parallelism=4)">
]>

<sect1 id="qtwebkit5" xreflabel="QtWebkit-&qtwebkit-version;">
  <?dbhtml filename="qtwebkit5.html" ?>

  <sect1info>
    <othername>$LastChangedBy$</othername>
    <date>$Date$</date>
  </sect1info>

  <title>QtWebkit-&qtwebkit-version;</title>

  <indexterm zone="qtwebkit5">
    <primary sortas="a-QtWebkit">QtWebkit</primary>
  </indexterm>

  <sect2 role="package">
    <title>Introduction to QtWebkit</title>

    <para>
      <application>Qtwebkit</application> is a Qt based web browser engine.
    </para>

    &lfs80_checked;

    <bridgehead renderas="sect3">Package Information</bridgehead>
    <itemizedlist spacing="compact">
      <listitem>
        <para>
          Download (HTTP): <ulink url="&qtwebkit-download-http;"/>
        </para>
      </listitem>
      <listitem>
        <para>
          Download (FTP): <ulink url="&qtwebkit-download-ftp;"/>
        </para>
      </listitem>
      <listitem>
        <para>
          Download MD5 sum: &qtwebkit-md5sum;
        </para>
      </listitem>
      <listitem>
        <para>
          Download size: &qtwebkit-size;
        </para>
      </listitem>
      <listitem>
        <para>
          Estimated disk space required: &qtwebkit-buildsize;
        </para>
      </listitem>
      <listitem>
        <para>
          Estimated build time: &qtwebkit-time;
        </para>
      </listitem>
    </itemizedlist>

    <bridgehead renderas="sect3">Qtwebkit Dependencies</bridgehead>

    <bridgehead renderas="sect4">Required</bridgehead>
    <para role="required">
      <xref linkend="icu"/>,
      <xref linkend="libjpeg"/>,
      <xref linkend="libpng"/>,
      <xref linkend="libwebp"/>,
      <xref linkend="libxslt"/>,
      <xref linkend="qt5"/>,
      <xref linkend="ruby"/>, and
      <xref linkend="sqlite"/>
    </para>

    <bridgehead renderas="sect4">Recommended</bridgehead>
    <para role="recommended">
      <xref linkend="gst10-plugins-base"/> (HTML5 Video Support)
    </para>

    <para condition="html" role="usernotes">User Notes:
      <ulink url="&blfs-wiki;/qtwebkit"/>
    </para>
  </sect2>

  <sect2 role="installation">
    <title>Installation of Qtwebkit</title>

    <para>
      First, fix a build issue with <application>ICU</application> &gt;= 59:
    </para>

<screen><userinput>sed -i 's/unsigned short/char16_t/'            \
       Source/JavaScriptCore/API/JSStringRef.h \
       Source/WebKit2/Shared/API/c/WKString.h  &amp;&amp;

sed -i '/stdbool.h/ a#include &lt;uchar.h&gt;' \
       Source/JavaScriptCore/API/JSBase.h</userinput></screen>

    <para>
      Install <application>Qtwebkit</application> by running the following commands:
    </para>

<screen><userinput>SAVEPATH=$PATH             &amp;&amp;
export PATH=$PWD/bin:$PATH &amp;&amp;

mkdir -p build        &amp;&amp;
cd       build        &amp;&amp;

qmake ../WebKit.pro   &amp;&amp;
make                  &amp;&amp;

export PATH=$SAVEPATH &amp;&amp;
unset SAVEPATH </userinput></screen>

    <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>

    <note><para>The installation is automatically made to the
    $QT5DIR directory tree.</para></note>

    <para>
      Remove references to the build directory from the installed
      <filename class="extension">.pc</filename> files by running
      the following command as the
      <systemitem class="username">root</systemitem> user:
    </para>

<screen role="root"><userinput>find $QT5DIR/lib/pkgconfig -name "*.pc" -exec perl -pi -e "s, -L$PWD/?\S+,,g" {} \;</userinput></screen>

    <para>
      Remove references to the build directory from installed library
      dependency (prl) and profile include (pri) files by running the following
      commands as the <systemitem class="username">root</systemitem> user:
    </para>

<screen role="root"><userinput>find $QT5DIR/ -name qt_lib_bootstrap_private.pri \
   -exec sed -i -e "s:$PWD/qtbase:/$QT5DIR/lib/:g" {} \; &amp;&amp;

find $QT5DIR/ -name \*.prl \
   -exec sed -i -e '/^QMAKE_PRL_BUILD_DIR/d' {} \;</userinput></screen>

  </sect2>

  <sect2 role="commands">
    <title>Command Explanations</title>

    <para>
      <command>export PATH=$PWD/bin:$PATH</command>: sets a temporary path needed
      to complete the build and install process.
    </para>

    <para>
      <command>qmake</command>: is a Qt tool that automates the generation of 
      Makefiles.
    </para>

  </sect2>

  <sect2 role="content">
    <title>Contents</title>

    <segmentedlist>
      <segtitle>Installed Programs</segtitle>
      <segtitle>Installed Libraries</segtitle>
      <segtitle>Installed Directories</segtitle>

      <seglistitem>
        <seg>
          None
        </seg>

        <seg>
          libQt5WebKit.so and
          libQt5WebKitWidgets.so
        </seg>
        
        <seg>
          $QT5PREFIX/qml/QtWebKit,
          $QT5PREFIX/lib/cmake/Qt5WebKit{,Widgets},
          $QT5PREFIX/include/QtWebKit{,Widgets), and
          $QT5PREFIX/plugins/webkit
        </seg>
      </seglistitem>
    </segmentedlist>

  </sect2>

</sect1>