source: kde/kf5/kf5-intro.xml@ a1836490

11.0 ken/refactor-virt lazarus qt5new trunk xry111/git-date xry111/git-date-for-trunk xry111/git-date-test
Last change on this file since a1836490 was 2e29bba, checked in by Pierre Labastie <pieere@…>, 9 months ago

Updates:
kde frameworks 5.79; with extra-cmake-modules, breeze-icons, and oxygen-icons
kde frameworks applications 20.12.2; with kate and kwave
kde plasma 5.21.0

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

  • Property mode set to 100644
File size: 8.3 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 <!ENTITY kf5-download-http "&kf5-download-http;">
8 <!ENTITY kf5-download-ftp "&kf5e-download-ftp;">
9 <!ENTITY kf5-md5sum "See Below">
10 <!ENTITY kf5-size "30 MB">
11 <!ENTITY kf5-buildsize "11.7 MB">
12 <!ENTITY kf5-time "0.4 SBU">
13]>
14
15<sect1 id="kf5-intro" xreflabel="Introduction to KF5">
16 <?dbhtml filename="kf5-intro.html"?>
17
18 <sect1info>
19 <othername>$LastChangedBy$</othername>
20 <date>$Date$</date>
21 </sect1info>
22
23 <title>KDE Frameworks 5 Pre-installation Configuration</title>
24
25 <indexterm zone="kf5-intro">
26 <primary sortas="g-kf5">KDE Frameworks Introduction</primary>
27 </indexterm>
28
29 <para>
30 KF5 can be installed in <filename class="directory">/usr</filename> or
31 <filename class="directory">/opt/kf5</filename>. The BLFS editors
32 recommend the latter in the BLFS environment.
33 </para>
34
35 <sect2>
36 <title>Installing in /usr</title>
37
38 <para>
39 One option is to install <application>KDE Frameworks 5</application>
40 into the <filename class="directory">/usr</filename> hierarchy.
41 This creates a simpler setup but makes it more difficult to try
42 multiple versions of <application>KDE Frameworks</application>.
43 </para>
44
45<screen><userinput>export KF5_PREFIX=/usr</userinput></screen>
46
47 <para>
48 It is a good idea to add the following variables to your
49 system or personal profiles:
50 </para>
51
52<screen role="root"><userinput>cat &gt;&gt; /etc/profile.d/qt5.sh &lt;&lt; "EOF"
53<literal># Begin kf5 extension for /etc/profile.d/qt5.sh
54
55pathappend /usr/lib/qt5/plugins QT_PLUGIN_PATH
56pathappend $QT5DIR/lib/plugins QT_PLUGIN_PATH
57
58pathappend /usr/lib/qt5/qml QML2_IMPORT_PATH
59pathappend $QT5DIR/lib/qml QML2_IMPORT_PATH
60
61# End extension for /etc/profile.d/qt5.sh</literal>
62EOF
63
64cat &gt; /etc/profile.d/kf5.sh &lt;&lt; "EOF"
65<literal># Begin /etc/profile.d/kf5.sh
66
67export KF5_PREFIX=/usr
68
69# End /etc/profile.d/kf5.sh</literal>
70EOF</userinput></screen>
71
72 <note>
73 <para>
74 If <application>qt5</application> was installed in <filename
75 class="directory">/usr</filename>, the <filename
76 class="directory">$QT5DIR/lib/</filename> portions of the above paths
77 may need to be changed to <filename
78 class="directory">$QT5DIR/lib/qt5/</filename>.
79 </para>
80 </note>
81
82 <para>
83 Additionally, if <xref linkend="sudo"/> is installed, these variables
84 should be available to the super user. Execute the following commands as
85 the <systemitem class="username">root</systemitem> user:
86 </para>
87
88<screen role="root"><userinput>cat &gt;&gt; /etc/sudoers.d/qt &lt;&lt; "EOF"
89<literal>Defaults env_keep += QT_PLUGIN_PATH
90Defaults env_keep += QML2_IMPORT_PATH</literal>
91EOF
92
93cat &gt;&gt; /etc/sudoers.d/kde &lt;&lt; "EOF"
94<literal>Defaults env_keep += KF5_PREFIX</literal>
95EOF</userinput></screen>
96
97 </sect2>
98
99 <sect2>
100 <title>Installing in /opt</title>
101
102 <para>
103 A method of building multiple versions installs
104 <application>KDE Frameworks 5</application> in the
105 <filename class="directory">/opt</filename> hierarchy:
106 </para>
107
108<screen><userinput>export KF5_PREFIX=/opt/kf5</userinput></screen>
109
110 <para>
111 If you are not installing <application>KDE Frameworks 5</application>
112 in <filename class="directory">/usr</filename>, you will need to
113 make some additional configuration changes. Best practice is to add
114 those to your system or personal profile:
115 </para>
116
117<screen role="root"><userinput>cat &gt; /etc/profile.d/kf5.sh &lt;&lt; "EOF"
118<literal># Begin /etc/profile.d/kf5.sh
119
120export KF5_PREFIX=/opt/kf5
121
122pathappend $KF5_PREFIX/bin PATH
123pathappend $KF5_PREFIX/lib/pkgconfig PKG_CONFIG_PATH
124
125pathappend $KF5_PREFIX/etc/xdg XDG_CONFIG_DIRS
126pathappend $KF5_PREFIX/share XDG_DATA_DIRS
127
128pathappend $KF5_PREFIX/lib/plugins QT_PLUGIN_PATH
129pathappend $KF5_PREFIX/lib/plugins/kcms QT_PLUGIN_PATH
130
131pathappend $KF5_PREFIX/lib/qml QML2_IMPORT_PATH
132
133pathappend $KF5_PREFIX/lib/python&python3-majorver;/site-packages PYTHONPATH
134
135pathappend $KF5_PREFIX/share/man MANPATH
136# End /etc/profile.d/kf5.sh</literal>
137EOF
138
139cat &gt;&gt; /etc/profile.d/qt5.sh &lt;&lt; "EOF"
140<literal># Begin Qt5 changes for KF5
141
142pathappend $QT5DIR/plugins QT_PLUGIN_PATH
143pathappend $QT5DIR/qml QML2_IMPORT_PATH
144
145# End Qt5 changes for KF5</literal>
146EOF</userinput></screen>
147
148 <para>
149 Expand your <filename>/etc/ld.so.conf</filename> file:
150 </para>
151
152<screen role="root"><userinput>cat &gt;&gt; /etc/ld.so.conf &lt;&lt; "EOF"
153<literal># Begin KF5 addition
154
155/opt/kf5/lib
156
157# End KF5 addition</literal>
158EOF</userinput></screen>
159
160 <indexterm zone="kf5-intro">
161 <primary sortas="e-etc-ld.so.conf">/etc/ld.so.conf</primary>
162 </indexterm>
163
164 <para revision="sysv">
165 Several <application>KDE Frameworks 5</application> packages install
166 files into <application>D-Bus</application> directories. When installing
167 <application>KDE Frameworks 5</application> in a location other than
168 <filename class="directory">/usr</filename>,
169 <application>D-Bus</application> needs to be able to find these files.
170 The easiest way to achieve this is to create the following symlinks (as
171 the <systemitem class="username">root</systemitem> user):
172 </para>
173
174<screen role="root"
175 revision="sysv"><userinput>install -v -dm755 $KF5_PREFIX/{etc,share} &amp;&amp;
176ln -sfv /etc/dbus-1 $KF5_PREFIX/etc &amp;&amp;
177ln -sfv /usr/share/dbus-1 $KF5_PREFIX/share</userinput></screen>
178
179 <para revision="systemd">
180 Several <application>KDE Frameworks 5</application> and
181 <application>KDE Plasma 5</application> packages install
182 files into <application>D-Bus</application> and
183 <application>systemd</application> directories. When installing
184 <application>KDE 5</application> in a location other than
185 <filename class="directory">/usr</filename>,
186 <application>D-Bus</application> and <application>systemd</application>
187 need to be able to find these files.
188 The easiest way to achieve this is to create the following symlinks (as
189 the <systemitem class="username">root</systemitem> user):
190 </para>
191
192<screen role="root"
193 revision="systemd"><userinput>install -v -dm755 $KF5_PREFIX/{etc,share} &amp;&amp;
194ln -sfv /etc/dbus-1 $KF5_PREFIX/etc &amp;&amp;
195ln -sfv /usr/share/dbus-1 $KF5_PREFIX/share &amp;&amp;
196install -v -dm755 $KF5_PREFIX/lib &amp;&amp;
197ln -sfv /usr/lib/systemd $KF5_PREFIX/lib</userinput></screen>
198
199 <para>
200 Some packages may also install icons from the "hicolor" icon set. Since that
201 icon set is used by many packages, it is a good idea to create a
202 symlink to the one in <filename class="directory">/usr/share</filename>
203 to avoid having multiple installations of <xref linkend="hicolor-icon-theme"/>.
204 Run the following commands as the <systemitem class="username">root</systemitem>
205 user:
206 </para>
207
208<screen role="root"><userinput>install -v -dm755 $KF5_PREFIX/share/icons &amp;&amp;
209ln -sfv /usr/share/icons/hicolor $KF5_PREFIX/share/icons</userinput></screen>
210
211 <tip>
212 <para>
213 Sometimes, the installation paths are hardcoded into installed files.
214 This is the reason why <filename class="directory">/opt/kf5</filename>
215 is used as installation prefix instead of <filename
216 class="directory">/opt/kf5-&kf5-version;</filename>. After installing
217 <application>KDE Frameworks</application>, you may rename the directory
218 and create a symlink:
219 </para>
220
221<screen role="root"><userinput>mv /opt/kf5{,-&kf5-version;}
222ln -sfv kf5-&kf5-version; /opt/kf5</userinput></screen>
223
224 <para>
225 Later on, you may want to install other versions of
226 <application>KDE Frameworks 5</application>. To do that, just remove
227 the symlink and use <filename class="directory">/opt/kf5</filename>
228 as the prefix again. Which version of
229 <application>KDE Frameworks 5</application> you use depends only on
230 where the symlink points. No other reconfiguration will be needed.
231 </para>
232 </tip>
233
234 </sect2>
235
236</sect1>
237
238
Note: See TracBrowser for help on using the repository browser.