glfs/lxqt/desktop/pre-install.xml
Bruce Dubbs 3368ef44e8 Add caution to LXQt Desktop Pre-Install Instructions to
ensure a UTF-8 locale is set.

Make KF5/Plasma packages needed for lxqt explicit.


git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@17079 af4574ff-66df-0310-9fd7-8a98e5e911e0
2016-03-07 19:09:56 +00:00

150 lines
4.7 KiB
XML

<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE chapter 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>
The rest of this page is for people who wish to use the alternative
prefix.
</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}</userinput></screen>
<screen role="root"><userinput>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
# End LXQt profile</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 may also install icons from the "hicolor" 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>