source: kde5/plasma/plasma-workspace.xml@ ac38e9dc

systemd-13485
Last change on this file since ac38e9dc was ac38e9dc, checked in by Douglas R. Reno <renodr@…>, 9 years ago

Import back into SVN from Github

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/branches/systemd@16309 af4574ff-66df-0310-9fd7-8a98e5e911e0
  • Property mode set to 100644
File size: 9.8 KB
Line 
1<?xml version="1.0" encoding="ISO-8859-1"?>
2<!DOCTYPE sect1 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="plasma-workspace" xreflabel="Plasma-Workspace-&plasma-version;">
9 <?dbhtml filename="plasma-workspace.html"?>
10
11 <sect1info>
12 <othername>$LastChangedBy: krejzi $</othername>
13 <date>$Date: 2014-10-25 19:35:50 +0200 (Sat, 25 Oct 2014) $</date>
14 </sect1info>
15
16 <title>Plasma-Workspace-&plasma-version;</title>
17
18 <indexterm zone="plasma-workspace">
19 <primary sortas="a-Plasma-Workspace">Plasma-Workspace</primary>
20 </indexterm>
21
22 <sect2 role="package">
23 <title>Introduction to Plasma-Workspace</title>
24
25 <para>
26 The <application>Plasma-Workspace</application> package contains the
27 KDE Plasma Workspace.
28 </para>
29
30 &lfs77_checked;
31
32 <bridgehead renderas="sect3">Package Information</bridgehead>
33 <itemizedlist spacing="compact">
34 <listitem>
35 <para>
36 Download (HTTP): <ulink url="&plasma-workspace-download-http;"/>
37 </para>
38 </listitem>
39 <listitem>
40 <para>
41 Download (FTP): <ulink url="&plasma-workspace-download-ftp;"/>
42 </para>
43 </listitem>
44 <listitem>
45 <para>
46 Download MD5 sum: &plasma-workspace-md5sum;
47 </para>
48 </listitem>
49 <listitem>
50 <para>
51 Download size: &plasma-workspace-size;
52 </para>
53 </listitem>
54 <listitem>
55 <para>
56 Estimated disk space required: &plasma-workspace-buildsize;
57 </para>
58 </listitem>
59 <listitem>
60 <para>
61 Estimated build time: &plasma-workspace-time;
62 </para>
63 </listitem>
64 </itemizedlist>
65
66 <bridgehead renderas="sect3">Plasma-Workspace Dependencies</bridgehead>
67
68 <bridgehead renderas="sect4">Required</bridgehead>
69 <para role="required">
70 <xref linkend="baloo5"/>,
71 <xref linkend="kdesu"/>,
72 <xref linkend="kdewebkit"/>,
73 <xref linkend="kjsembed"/>,
74 <xref linkend="knotifyconfig"/>,
75 <xref linkend="krunner"/>,
76 <xref linkend="kwayland"/>,
77 <xref linkend="kwin5"/>,
78 <xref linkend="kxmlrpcclient"/>,
79 <xref linkend="libkscreen"/>,
80 <xref linkend="libksysguard"/> and
81 <xref linkend="networkmanager-qt"/>
82 </para>
83
84 <bridgehead renderas="sect4">Recommended</bridgehead>
85 <para role="recommended">
86 <xref linkend="ktexteditor"/>
87 </para>
88
89 <bridgehead renderas="sect4">Optional</bridgehead>
90 <para role="optional">
91 <ulink url="http://gpsd.berlios.de/">libgps</ulink>,
92 <ulink url="http://qalculate.sourceforge.net">libqalculate</ulink>,
93 <xref linkend="linux-pam"/> and
94 <ulink url="http://projects.kde.org/prison/">Prison</ulink>
95 </para>
96
97 <bridgehead renderas="sect4">Runtime Dependencies</bridgehead>
98 <para role="optional"> <!-- Because of circular deps -->
99 <xref linkend="bluedevil5"/> (Bluetooth Applet, optional),
100 <xref linkend="breeze"/>,
101 <xref linkend="kde-cli-tools"/>,
102 <xref linkend="kded"/>,
103 <xref linkend="khelpcenter"/> (Help Viewer, required for most apps' "Help" functionality, optional),
104 <xref linkend="khotkeys"/>,
105 <xref linkend="kinfocenter"/> (Hardware Information, optional),
106 <xref linkend="kio-extras"/>,
107 <xref linkend="kmenuedit"/> (Editor for Menu Entries, optional),
108 <xref linkend="kmix5"/> (Volume Control Applet, optional),
109 <xref linkend="ksysguard"/>,
110 <xref linkend="kwrited"/>,
111 <xref linkend="milou"/>,
112 <xref linkend="oxygen"/>,
113 <xref linkend="plasma-desktop"/>,
114 <xref linkend="plasma-nm"/> (Network Management Applet, optional),
115 <xref linkend="plasma-workspace-wallpapers"/> (Additional Wallpapers, optional),
116 <xref linkend="polkit-kde-agent5"/> (Polkit Authentication Agent, recommended),
117 <xref linkend="powerdevil"/>,
118 <xref linkend="systemd"/> and
119 <xref linkend="systemsettings"/>
120 </para>
121
122 <para condition="html" role="usernotes">
123 User Notes: <ulink url="&blfs-wiki;/plasma-workspace"/>
124 </para>
125 </sect2>
126
127 <sect2 role="installation">
128 <title>Installation of Plasma-Workspace</title>
129
130 <para>
131 Install <application>Plasma-Workspace</application> by running the following
132 commands:
133 </para>
134
135<screen><userinput>mkdir build &amp;&amp;
136cd build &amp;&amp;
137
138cmake -DCMAKE_INSTALL_PREFIX=$KF5_PREFIX \
139 -DCMAKE_BUILD_TYPE=Release \
140 -DLIB_INSTALL_DIR=lib \
141 -DBUILD_TESTING=OFF \
142 -DQML_INSTALL_DIR=&qt5-qml-dir; \
143 -DQT_PLUGIN_INSTALL_DIR=&qt5-plugins-dir; \
144 .. &amp;&amp;
145make</userinput></screen>
146
147 <para>
148 This package does not come with a test suite.
149 </para>
150
151 <para>
152 Now, as the <systemitem class="username">root</systemitem> user:
153 </para>
154
155<screen role="root"><userinput>make install</userinput></screen>
156
157 <para>
158 Make the startup script call <command>qtpaths-qt5</command> instead of
159 <command>qtpaths</command> in case <application>qtchooser</application>
160 is being used by running the following command as the
161 <systemitem class="username">root</systemitem> user:
162 </para>
163
164<screen role="root"><userinput>sed -i "s:qtpaths:&amp;-qt5:g" $KF5_PREFIX/bin/startkde</userinput></screen>
165
166 </sect2>
167
168 <sect2 role="commands">
169 <title>Command Explanations</title>
170
171 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
172 href="../../xincludes/cmake-release.xml"/>
173
174 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
175 href="../../xincludes/kf5-libdir.xml"/>
176
177 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
178 href="../../xincludes/kf5-tests.xml"/>
179
180 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
181 href="../../xincludes/qt5-qml-dir.xml"/>
182
183 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
184 href="../../xincludes/qt5-plugins-dir.xml"/>
185
186 </sect2>
187
188 <sect2 role="configuration">
189 <title>Configuring Plasma-Workspace</title>
190
191 <para>
192 If <application>Linux PAM</application> was present at build time,
193 create the necessary configuration file so that the Screen Locker
194 can work properly by running the following command as the
195 <systemitem class="username">root</systemitem> user:
196 </para>
197
198<screen role="root"><userinput>cat &gt; /etc/pam.d/kde &lt;&lt; "EOF"
199<literal># Begin /etc/pam.d/kde
200
201auth include system-auth
202account include system-account
203password include system-password
204session include system-session
205
206# End /etc/pam.d/kde</literal>
207EOF</userinput></screen>
208
209 <note>
210 <para>
211 The rest of this section can be skipped if <application>KDE
212 Plasma 5</application> was installed in
213 <filename class="directory">/usr</filename>
214 </para>
215 </note>
216
217 <para>
218 Create a wrapper script that will be used to start the
219 <application>KDE Plasma 5</application> by running
220 the following command as the <systemitem
221 class="username">root</systemitem> user:
222 </para>
223
224<screen role="root"><userinput>cat &gt; $KF5_PREFIX/bin/startkde-wrapper &lt;&lt; "EOF"
225<literal>#!/bin/sh -e
226
227. /etc/profile.d/kf5.sh
228
229exec $KF5_PREFIX/bin/startkde "$@"</literal>
230EOF
231chmod -v 755 $KF5_PREFIX/bin/startkde-wrapper</userinput></screen>
232
233 <para>
234 If you are using a display manager to log into your desktop
235 (such as <xref linkend="sddm"/>), let it know about the
236 <application>KDE</application> Plasma Desktop by running
237 the following command as the <systemitem
238 class="username">root</systemitem> user:
239 </para>
240
241<screen role="root"><userinput>install -v -dm755 /usr/share/xsessions
242sed -i "s:startkde:&amp;-wrapper:g" $KF5_PREFIX/share/xsessions/plasma.desktop
243ln -sfv $KF5_PREFIX/share/xsessions/plasma.desktop /usr/share/xsessions/kf5-plasma.desktop</userinput></screen>
244
245 </sect2>
246
247 <sect2 role="content">
248 <title>Contents</title>
249
250 <segmentedlist>
251 <segtitle>Installed Programs</segtitle>
252 <segtitle>Installed Libraries</segtitle>
253 <segtitle>Installed Directories</segtitle>
254
255 <seglistitem>
256 <seg>
257 kcheckrunning, kcminit, kcminit_startup, kdostartupconfig5,
258 klipper, krunner, ksmserver, ksplashqml, kstartupconfig5,
259 kuiserver5, plasmashell, plasmawindowed, startkde and
260 systemmonitor
261 </seg>
262 <seg>
263 libkdeinit5_kcminit.so, libkdeinit5_kcminit_startup.so,
264 libkdeinit5_klipper.so, libkdeinit5_ksmserver.so,
265 libkdeinit5_kuiserver5.so, libkworkspace5.so,
266 libplasma-geolocation-interface.so, libtaskmanager.so and
267 libweather_ion.so
268 </seg>
269 <seg>
270 $KF5_PREFIX/include/{KDE,kworkspace5,plasma,taskmanager},
271 $KF5_PREFIX/lib/cmake/{KRunnerAppDBusInterface,KSMServerDBusInterface},
272 $KF5_PREFIX/lib/cmake/{LibKWorkspace,LibTaskManager,ScreenSaverDBusInterface},
273 $KF5_PREFIX/&qt5-plugins-dir;/kpackage/packagestructure,
274 $KF5_PREFIX/&qt5-plugins-dir;/phonon_platform,
275 $KF5_PREFIX/&qt5-plugins-dir;/plasma/{dataengine,packagestructure},
276 $KF5_PREFIX/&qt5-qml-dir;/org/kde/plasma/private/{battery,digitalclock,icon},
277 $KF5_PREFIX/&qt5-qml-dir;/org/kde/plasma/private/{notifications,shell},
278 $KF5_PREFIX/&qt5-qml-dir;/org/kde/plasma/{wallpapers,workspace},
279 $KF5_PREFIX/&qt5-qml-dir;/org/kde/private/systemtray,
280 $KF5_PREFIX/share/doc/HTML/*/klipper,
281 $KF5_PREFIX/share/{drkonqi,ksmserver,ksplash,kstyle},
282 $KF5_PREFIX/share/plasma/kcms/screenlocker_kcm,
283 $KF5_PREFIX/share/plasma/{look-and-feel,plasmoids,services},
284 $KF5_PREFIX/share/plasma/{shareprovider,wallpapers} and
285 $KF5_PREFIX/share/{sddm,solid,xsessions}
286 </seg>
287 </seglistitem>
288 </segmentedlist>
289
290 </sect2>
291
292</sect1>
Note: See TracBrowser for help on using the repository browser.