source: lxqt/desktop/pre-install.xml@ 7add59a9

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

<sect1 id="lxqt-pre-install" xreflabel="LXQt Pre-Install">
  <?dbhtml filename="pre-install.html"?>

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

  <title>LXQt Desktop Pre-Install Instructions</title>

  <indexterm zone="lxqt-pre-install">
    <primary sortas="g-lxqt-pre-install">LXQt Pre-Install</primary>
  </indexterm>

  <caution>
    <para>
      Due to recent changes in <command>grep</command> it is essential that
      the installing system be set to a UTF-8 locale. An example
      is <command>export LANG=en_US.utf8</command>, but any UTF-8 locale is
      sufficient. Failure to do this will result in a faulty installation.
    </para>
  </caution>

    <para>
      LXQt can be installed in /usr or /opt/lxqt.
    </para>

  <sect2>
    <title>Installing in /usr</title>

    <para>
      Installing in <filename class="directory">/usr</filename> creates
      a simpler setup.  Run:
    </para>

<screen><userinput>export LXQT_PREFIX=/usr</userinput></screen>

    <para>
      Either add that to your own <filename>.bash_profile</filename>
      so that it will still be set if you build the packages over a
      period of time, or else add it to the system profile as the
      <systemitem class="username">root</systemitem> user:
    </para>

<screen role="root"><userinput>cat &gt; /etc/profile.d/lxqt.sh &lt;&lt; "EOF"
<literal># Begin LXQt profile

export LXQT_PREFIX=/usr

# End LXQt profile</literal>
EOF</userinput></screen>

    <para>
      There is no other configuration needed to install LXQt in 
      <filename class="directory">/usr</filename>.
    </para>

  </sect2>

  <sect2>
    <title>Installing in /opt/lxqt</title>

    <para>
      Installing in <filename class="directory">/opt/lxqt</filename> may
      simplify upgrading to a later version of LXQt.
    </para>

    <para>
      Some variables need to be defined in your system profile, as the
      <systemitem class="username">root</systemitem> user:
    </para>

<screen role="root"><userinput>install -vdm755 /opt/lxqt/{bin,lib,share/man}

cat &gt; /etc/profile.d/lxqt.sh &lt;&lt; "EOF"
<literal># Begin LXQt profile

export LXQT_PREFIX=/opt/lxqt

pathappend /opt/lxqt/bin           PATH
pathappend /opt/lxqt/share/man/    MANPATH
pathappend /opt/lxqt/lib/pkgconfig PKG_CONFIG_PATH
pathappend /opt/lxqt/lib/plugins   QT_PLUGIN_PATH

# End LXQt profile</literal>
EOF

cat &gt;&gt; /etc/profile.d/qt5.sh &lt;&lt; "EOF"
<literal>
# Begin Qt5 changes for LXQt

pathappend $QT5DIR/plugins         QT_PLUGIN_PATH

# End Qt5 changes for LXQt</literal>
EOF</userinput></screen>

    <para>
      Expand your <filename>/etc/ld.so.conf</filename> file:
    </para>

<screen role="root"><userinput>cat &gt;&gt; /etc/ld.so.conf &lt;&lt; "EOF"
<literal>
# Begin LXQt addition

/opt/lxqt/lib

# End LXQt addition
</literal>
EOF</userinput></screen>

    <para>
      Before starting to install the packages in the following pages, remember
      to execute:
    </para>

<screen><userinput>source /etc/profile</userinput></screen>

    <para>
      Some packages from the KDE Frameworks 5 bundle install files into D-Bus
      directories. In order to have D-Bus find those files, the easiest
      way is to create the following symlink (as the <systemitem
      class="username">root</systemitem> user):
    </para>

<screen role="root"><userinput>ln -sfv /usr/share/dbus-1 $LXQT_PREFIX/share</userinput></screen>

    <para>
      Some packages may also install icons from the <quote>hicolor</quote>
      icon set. Since that icon set is used by many packages, it is a good
      idea to create a symlink to the one in <filename
      class="directory">/usr/share</filename> to avoid having multiple
      installations of <xref linkend="hicolor-icon-theme"/>.  Run the
      following commands as the <systemitem class="username">root</systemitem>
      user:
    </para>

<screen role="root"><userinput>source /etc/profile                                       &amp;&amp;
install -v -dm755                $LXQT_PREFIX/share/icons &amp;&amp;
ln -sfv /usr/share/icons/hicolor $LXQT_PREFIX/share/icons</userinput></screen>


    <tip>
      <para>
        Sometimes, the installation paths are hardcoded into installed files.
        This is the reason why <filename class="directory">/opt/lxqt</filename>
        is used as installation prefix instead of <filename
        class="directory">/opt/lxqt-&lxqt-version;</filename>. After installing
        <application>LXQt Desktop</application>, you may rename the directory
        and create a symlink:
      </para>

<screen role="root"><userinput>mv /opt/lxqt{,-&lxqt-version;}
ln -sfv lxqt-&lxqt-version; /opt/lxqt</userinput></screen>

      <para>
        Later on, you may want to install other versions of <application>LXQt
        Desktop</application>. To do that, just remove the symlink and use
        <filename class="directory">/opt/lxqt</filename> as the prefix again.
        Which version of <application>LXQt Desktop</application> you use
        depends only on where the symlink points. No other reconfiguration will
        be needed.
      </para>
    </tip>

  </sect2>

</sect1>