[ab4fdfc] | 1 | <?xml version="1.0" encoding="UTF-8"?>
|
---|
[1cc6ea03] | 2 | <!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
|
---|
| 3 | "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
|
---|
| 4 | <!ENTITY % general-entities SYSTEM "../../general.ent">
|
---|
| 5 | %general-entities;
|
---|
| 6 | ]>
|
---|
| 7 |
|
---|
| 8 | <sect1 id="lxqt-post-install" xreflabel="LXQt-Post-Install">
|
---|
| 9 | <?dbhtml filename="post-install.html"?>
|
---|
| 10 |
|
---|
| 11 | <title>LXQt Desktop Final Instructions</title>
|
---|
| 12 |
|
---|
| 13 | <indexterm zone="lxqt-post-install">
|
---|
| 14 | <primary sortas="g-lxqt-post-install">LXQt-post-install</primary>
|
---|
| 15 | </indexterm>
|
---|
| 16 |
|
---|
| 17 | <sect2 role="package">
|
---|
| 18 | <title>Post-Install Instructions</title>
|
---|
| 19 |
|
---|
| 20 | <para>
|
---|
[dd01bb01] | 21 | Please follow these instructions before starting
|
---|
| 22 | <application>LXQt</application> for the first time.
|
---|
[1cc6ea03] | 23 | </para>
|
---|
| 24 |
|
---|
| 25 | <bridgehead renderas="sect3">Dependencies to Start LXQt</bridgehead>
|
---|
| 26 |
|
---|
| 27 | <bridgehead renderas="sect4">Required</bridgehead>
|
---|
| 28 | <para role="required">
|
---|
| 29 | <xref linkend="openbox"/>, or another window manager, such as
|
---|
| 30 | <xref role="nodep" linkend="xfwm4"/>, or
|
---|
[6d8eeb9] | 31 | kwin from <xref role="nodep" linkend="plasma-build"/>.
|
---|
[1cc6ea03] | 32 | Note that <xref role="nodep" linkend="icewm"/> is not suitable for LXQt.
|
---|
| 33 | </para>
|
---|
| 34 |
|
---|
| 35 | <bridgehead renderas="sect4">Recommended</bridgehead>
|
---|
| 36 | <para role="recommended">
|
---|
[32936bc] | 37 | <xref linkend="breeze-icons"/> and
|
---|
| 38 | <xref linkend="desktop-file-utils"/>
|
---|
| 39 | </para>
|
---|
| 40 |
|
---|
| 41 | <bridgehead renderas="sect4">Optional</bridgehead>
|
---|
| 42 | <para role="optional">
|
---|
[1cc6ea03] | 43 | <xref linkend="lightdm"/> or another Display Manager, e.g.
|
---|
[18958f2e] | 44 | <xref role="nodep" linkend="sddm"/>, or
|
---|
[1cc6ea03] | 45 | <xref linkend="xscreensaver"/>
|
---|
| 46 | </para>
|
---|
| 47 |
|
---|
| 48 | </sect2>
|
---|
| 49 |
|
---|
| 50 | <sect2 role="configuration">
|
---|
| 51 | <title>Final Configuration</title>
|
---|
| 52 |
|
---|
[dd01bb01] | 53 | <sect3 id="lxqt-final-updates" xreflabel="LXQt Final Database Updates">
|
---|
| 54 | <title>LXQt Final Database Updates</title>
|
---|
[1cc6ea03] | 55 |
|
---|
| 56 | <para>
|
---|
[dd01bb01] | 57 | The desktop databases need to be created or updated at this point.
|
---|
[1cc6ea03] | 58 | Run the following commands as the &root; user:
|
---|
| 59 | </para>
|
---|
| 60 |
|
---|
[5c25cbdc] | 61 | <screen role="root"><userinput>ldconfig &&
|
---|
[532405b] | 62 | update-mime-database /usr/share/mime &&
|
---|
| 63 | xdg-icon-resource forceupdate &&
|
---|
[1cc6ea03] | 64 | update-desktop-database -q</userinput></screen>
|
---|
| 65 |
|
---|
| 66 | </sect3>
|
---|
| 67 |
|
---|
| 68 | </sect2>
|
---|
| 69 |
|
---|
| 70 | <sect2 role="starting">
|
---|
| 71 | <title>Starting LXQt</title>
|
---|
| 72 |
|
---|
| 73 | <para revision="sysv">
|
---|
| 74 | You can start <application>LXQt</application> from runlevel 3, using
|
---|
| 75 | <xref linkend="xinit"/>, or from runlevel 5, using a Display Manager,
|
---|
| 76 | such as <xref linkend="lightdm"/>.
|
---|
| 77 | </para>
|
---|
| 78 |
|
---|
| 79 | <para revision="systemd">
|
---|
| 80 | You can start <application>LXQt</application> from a TTY, using
|
---|
| 81 | <xref linkend="xinit"/>, or by using a graphical display manager such
|
---|
| 82 | as <xref linkend="lightdm"/>.
|
---|
| 83 | </para>
|
---|
| 84 |
|
---|
| 85 | <para>
|
---|
| 86 | To start <application>LXQt</application> using <xref linkend="xinit"/>,
|
---|
| 87 | run the following commands:
|
---|
| 88 | </para>
|
---|
| 89 |
|
---|
[665150a] | 90 | <screen role="nodump"><userinput>cat > ~/.xinitrc << "EOF"
|
---|
[0ea82524] | 91 | <literal>exec startlxqt</literal>
|
---|
[1cc6ea03] | 92 | EOF
|
---|
| 93 |
|
---|
| 94 | startx</userinput></screen>
|
---|
| 95 |
|
---|
| 96 | <para>
|
---|
[0ea82524] | 97 | The X session starts on the first unused virtual terminal, normally vt1.
|
---|
[dd01bb01] | 98 | You can switch to another vt<emphasis>n</emphasis> by simultaneously
|
---|
[1cc6ea03] | 99 | pressing the keys Ctrl-Alt-F<emphasis>n</emphasis>
|
---|
[0ea82524] | 100 | (<emphasis>n</emphasis>=2, 3, ...). To switch back to the X session,
|
---|
| 101 | normally started at vt1, use Ctrl-Alt-F1. The vt where the command
|
---|
[1cc6ea03] | 102 | <command>startx</command> was executed will display many messages,
|
---|
| 103 | including X starting messages, applications automatically started with
|
---|
[dd01bb01] | 104 | the session, and eventually, some warning and error messages, but these
|
---|
| 105 | are hidden by the graphical interface. You may prefer to redirect those
|
---|
| 106 | messages to a log file, which can be used for debugging purposes. This
|
---|
| 107 | can be done starting X with:
|
---|
[1cc6ea03] | 108 | </para>
|
---|
| 109 |
|
---|
[665150a] | 110 | <screen role="nodump"><userinput>startx &> ~/.x-session-errors</userinput></screen>
|
---|
[1cc6ea03] | 111 |
|
---|
| 112 | </sect2>
|
---|
| 113 |
|
---|
[1c060d7] | 114 | <sect2>
|
---|
| 115 | <title>Initial Configuration</title>
|
---|
| 116 |
|
---|
| 117 | <para>
|
---|
| 118 | When LXQt first starts, it will ask you for the window manager to use.
|
---|
[4048bc73] | 119 | To start, the BLFS editors recommend using <application>openbox</application>.
|
---|
[e440af5] | 120 | At this point both the background and the panel will be black. Right clicking
|
---|
[e0f68c6] | 121 | on the background will bring up a menu and selecting "Desktop Preferences"
|
---|
[1c060d7] | 122 | will allow you to change the background color or set a background image.
|
---|
| 123 | </para>
|
---|
| 124 |
|
---|
| 125 | <para>
|
---|
[e0f68c6] | 126 | The panel will be at the bottom of the screen. Right clicking on the
|
---|
| 127 | panel will bring up a menu that will allow you to customize the panel
|
---|
[8dfea8d] | 128 | including adding widgets and setting the background color. The BLFS
|
---|
| 129 | editors recommend installing, at a minimum, the Application Manager and
|
---|
| 130 | Task Manager widgets.
|
---|
[1c060d7] | 131 | </para>
|
---|
| 132 |
|
---|
[6032048] | 133 | <para>
|
---|
| 134 | After LXQt has started for the first time, the BLFS editors recommend
|
---|
| 135 | going through the settings presented in the LXQt Configuration Center,
|
---|
| 136 | which can be found under LXQt Settings in the Preferences menu of the
|
---|
| 137 | application launcher.
|
---|
| 138 | </para>
|
---|
| 139 |
|
---|
[32936bc] | 140 | <note>
|
---|
| 141 | <para>
|
---|
| 142 | The user configuration files will be created in the directory
|
---|
| 143 | $HOME/.config/lxqt/. To get widget icons to display properly,
|
---|
[e0f68c6] | 144 | the lxqt.conf file may need to be manually edited to include the
|
---|
[32936bc] | 145 | line "icon_theme=oxygen".
|
---|
| 146 | </para>
|
---|
| 147 | </note>
|
---|
| 148 |
|
---|
[1c060d7] | 149 | </sect2>
|
---|
[1cc6ea03] | 150 | </sect1>
|
---|