source: lxqt/desktop/post-install.xml@ 1608f96

10.0 10.1 11.0 11.1 8.2 8.3 8.4 9.0 9.1 basic bdubbs/svn elogind lazarus perl-modules qt5new trunk upgradedb xry111/intltool xry111/test-20220226
Last change on this file since 1608f96 was 1608f96, checked in by Pierre Labastie <pieere@…>, 5 years ago

role="runtime|nodep" in lxqt

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@19227 af4574ff-66df-0310-9fd7-8a98e5e911e0

  • Property mode set to 100644
File size: 6.0 KB
Line 
1<?xml version="1.0" encoding="ISO-8859-1"?>
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 <sect1info>
12 <othername>$LastChangedBy$</othername>
13 <date>$Date$</date>
14 </sect1info>
15
16 <title>LXQt Desktop Final Instructions</title>
17
18 <indexterm zone="lxqt-post-install">
19 <primary sortas="g-lxqt-post-install">LXQt-post-install</primary>
20 </indexterm>
21
22 <sect2 role="package">
23 <title>Post-Install Instructions</title>
24
25 <para>
26 Final steps, before starting <application>LXQt</application>.
27 </para>
28
29 <bridgehead renderas="sect3">Dependencies to Start LXQt</bridgehead>
30
31 <bridgehead renderas="sect4">Required</bridgehead>
32 <para role="required">
33 <xref linkend="openbox"/>, or another window manager, such as
34 <xref role="nodep" linkend="xfwm4"/>, or
35 kwin from <xref role="nodep" linkend="plasma5-build"/>.
36 Note that <xref role="nodep" linkend="icewm"/> is not suitable for LXQt
37 </para>
38
39 <bridgehead renderas="sect4">Recommended</bridgehead>
40 <para role="recommended">
41 <phrase revision="sysv">
42 <xref linkend="consolekit"/> with
43 <xref linkend="pm-utils"/>,
44 </phrase>
45 <xref linkend="sddm"/> (recommended by <application>LXQt</application>
46 developers) or another Display Manager, e.g.
47 <xref role="nodep" linkend="lxdm"/>,
48 <xref linkend="desktop-file-utils"/>,
49 <xref linkend="shared-mime-info"/>,
50 <xref linkend="xdg-utils"/>, and
51 <xref linkend="xscreensaver"/>
52 </para>
53
54 <para condition="html" role="usernotes">
55 User Notes: <ulink url="&blfs-wiki;/post-install"/>
56 </para>
57
58 </sect2>
59
60 <sect2 role="configuration">
61 <title>Final Configuration</title>
62
63 <para>
64 If <application>LXQt</application> is installed in <filename
65 class="directory">/usr</filename>, jump directly to <xref
66 linkend="lxqt-final-updates"/>, otherwise run the commands in the
67 next section.
68 </para>
69
70 <sect3>
71 <title>Configuration needed only if installing into /opt</title>
72 <para>
73 If <application>LXQt</application> is installed into <filename
74 class="directory">/opt</filename>, some files have to be copied to
75 <filename class="directory">/usr/share</filename>, so that the system
76 can find them. Run the following commands, as the <systemitem
77 class="username">root</systemitem> user:
78 </para>
79
80<screen role="root"><userinput>ln -svfn $LXQT_PREFIX/share/lxqt /usr/share/lxqt &amp;&amp;
81
82cp -v {$LXQT_PREFIX,/usr}/share/xsessions/lxqt.desktop &amp;&amp;
83
84for i in $LXQT_PREFIX/share/applications/*
85do
86 ln -svf $i /usr/share/applications/
87done
88
89for i in $LXQT_PREFIX/share/desktop-directories/*
90do
91 ln -svf $i /usr/share/desktop-directories/
92done
93
94unset i
95
96ldconfig</userinput></screen>
97
98 </sect3>
99
100 <sect3 id="lxqt-final-updates" xreflabel="LXQt Final Updates">
101 <title>LXQt Final Updates</title>
102
103 <para>
104 The desktop databases have to be created or updated at this point.
105 Run the following commands as the <systemitem
106 class="username">root</systemitem> user:
107 </para>
108
109<screen role="root"><userinput>update-mime-database /usr/share/mime &amp;&amp;
110xdg-icon-resource forceupdate --theme hicolor &amp;&amp;
111update-desktop-database -q</userinput></screen>
112
113 </sect3>
114
115 </sect2>
116
117 <sect2 role="starting">
118 <title>Starting LXQt</title>
119
120 <para revision="sysv">
121 You can start <application>LXQt</application> from runlevel 3, using
122 <xref linkend="xinit"/>, or from runlevel 5, using a Display Manager,
123 such as <xref linkend="sddm"/>.
124 </para>
125
126 <para revision="systemd">
127 You can start <application>LXQt</application> from a TTY, using
128 <xref linkend="xinit"/>, or by using a graphical display manager such
129 as <xref linkend="sddm"/>.
130 </para>
131
132 <para>
133 To start <application>LXQt</application> using <xref linkend="xinit"/>,
134 run the following commands:
135 </para>
136
137<screen revision="sysv"><userinput>cat &gt; ~/.xinitrc &lt;&lt; "EOF"
138<literal>ck-launch-session dbus-launch --exit-with-session startlxqt</literal>
139EOF
140
141startx</userinput></screen>
142
143<screen revision="systemd"><userinput>cat &gt; ~/.xinitrc &lt;&lt; "EOF"
144<literal>dbus-launch --exit-with-session startlxqt</literal>
145EOF
146
147startx</userinput></screen>
148
149 <para>
150 The X session starts on the first unused virtual terminal, normally vt7.
151 You can switch to another vt<emphasis>n</emphasis> simultaneously
152 pressing the keys Ctrl-Alt-F<emphasis>n</emphasis>
153 (<emphasis>n</emphasis>=1, 2, ...). To switch back to the X session,
154 normally started at vt7, use Ctrl-Alt-F7. The vt where the command
155 <command>startx</command> was executed will display many messages,
156 including X starting messages, applications automatically started with
157 the session, and eventually, some warning and error messages. You may
158 prefer to redirect those messages to a log file, which not only will keep
159 the initial vt uncluttered, but can also be used for debug purposes. This
160 can be done starting X with:
161 </para>
162
163 <screen><userinput>startx &amp;&gt; ~/.x-session-errors</userinput></screen>
164
165 <note revision="sysv">
166 <para>
167 You may wish to drop consolekit and/or dbus-launch, e.g., just using
168 startlxqt in ~/.xinitrc. However some capabilities such as mounting or
169 umounting file systems from a file manager will not be possible, or the
170 reboot option will be absent or inoperative, among other problems.
171 </para>
172 </note>
173
174 <para>
175 When shutting down or rebooting, the shutdown messages appear on the vt
176 where X was running. If you wish to see those messages, simultaneously
177 press keys Alt-F7 (assuming that X was running on vt7).
178 </para>
179
180 </sect2>
181
182</sect1>
Note: See TracBrowser for help on using the repository browser.