glfs/lxqt/desktop/post-install.xml
2023-07-13 01:17:52 -05:00

141 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-post-install" xreflabel="LXQt-Post-Install">
<?dbhtml filename="post-install.html"?>
<title>LXQt Desktop Final Instructions</title>
<indexterm zone="lxqt-post-install">
<primary sortas="g-lxqt-post-install">LXQt-post-install</primary>
</indexterm>
<sect2 role="package">
<title>Post-Install Instructions</title>
<para>
Final steps, before starting <application>LXQt</application>.
</para>
<bridgehead renderas="sect3">Dependencies to Start LXQt</bridgehead>
<bridgehead renderas="sect4">Required</bridgehead>
<para role="required">
<xref linkend="openbox"/>, or another window manager, such as
<xref role="nodep" linkend="xfwm4"/>, or
kwin from <xref role="nodep" linkend="plasma5-build"/>.
Note that <xref role="nodep" linkend="icewm"/> is not suitable for LXQt.
</para>
<bridgehead renderas="sect4">Recommended</bridgehead>
<para role="recommended">
<xref linkend="breeze-icons"/> and
<xref linkend="desktop-file-utils"/>
</para>
<bridgehead renderas="sect4">Optional</bridgehead>
<para role="optional">
<xref linkend="lightdm"/> or another Display Manager, e.g.
<xref role="nodep" linkend="lxdm"/>, and
<xref linkend="xscreensaver"/>
</para>
</sect2>
<sect2 role="configuration">
<title>Final Configuration</title>
<sect3 id="lxqt-final-updates" xreflabel="LXQt Final Updates">
<title>LXQt Final Updates</title>
<para>
The desktop databases have to be created or updated at this point.
Run the following commands as the &root; user:
</para>
<screen role="root"><userinput>ldconfig &amp;&amp;
update-mime-database /usr/share/mime &amp;&amp;
xdg-icon-resource forceupdate &amp;&amp;
update-desktop-database -q</userinput></screen>
</sect3>
</sect2>
<sect2 role="starting">
<title>Starting LXQt</title>
<para revision="sysv">
You can start <application>LXQt</application> from runlevel 3, using
<xref linkend="xinit"/>, or from runlevel 5, using a Display Manager,
such as <xref linkend="lightdm"/>.
</para>
<para revision="systemd">
You can start <application>LXQt</application> from a TTY, using
<xref linkend="xinit"/>, or by using a graphical display manager such
as <xref linkend="lightdm"/>.
</para>
<para>
To start <application>LXQt</application> using <xref linkend="xinit"/>,
run the following commands:
</para>
<screen><userinput>cat &gt; ~/.xinitrc &lt;&lt; "EOF"
<literal>exec startlxqt</literal>
EOF
startx</userinput></screen>
<para>
The X session starts on the first unused virtual terminal, normally vt1.
You can switch to another vt<emphasis>n</emphasis> simultaneously
pressing the keys Ctrl-Alt-F<emphasis>n</emphasis>
(<emphasis>n</emphasis>=2, 3, ...). To switch back to the X session,
normally started at vt1, use Ctrl-Alt-F1. The vt where the command
<command>startx</command> was executed will display many messages,
including X starting messages, applications automatically started with
the session, and eventually, some warning and error messages, but are
hidden by the graphical interface. You may prefer to redirect those
messages to a log file, which can be used for debug purposes. This can
be done starting X with:
</para>
<screen><userinput>startx &amp;&gt; ~/.x-session-errors</userinput></screen>
</sect2>
<sect2>
<title>Initial Configuration</title>
<para>
When LXQt first starts, it will ask you for the window manager to use.
To start, the BLFS editors recomment using <application>openbox</application>.
At this point both the background and the panel will be black. Right clicking
on the backgound will bring up a menu and selecting "Desktop Preferences"
will allow you to change the background color or set a background image.
</para>
<para>
The panel will be at the bottom of the screen. Right clicking on the
panel will bring up a menu that will allow you to customize the panel
including adding widgets and setting the background color.
</para>
<note>
<para>
The user configuration files will be created in the directory
$HOME/.config/lxqt/. To get widget icons to display properly,
the lxqt.conf file may need to be manually edited to include the
line "icon_theme=oxygen".
</para>
</note>
</sect2>
</sect1>