source: kde/kf5/kf5-intro.xml@ 5652a81

10.0 10.1 11.0 7.10 7.9 8.0 8.1 8.2 8.3 8.4 9.0 9.1 basic bdubbs/svn elogind ken/refactor-virt lazarus nosym perl-modules qt5new trunk upgradedb xry111/git-date xry111/git-date-for-trunk xry111/git-date-test
Last change on this file since 5652a81 was 5652a81, checked in by Bruce Dubbs <bdubbs@…>, 6 years ago

Clarify qt5 setup when installing in /usr

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

  • Property mode set to 100644
File size: 7.4 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">
26 <primary sortas="a-kf5">KDE Frameworks</primary>
27 </indexterm>
28
29 <para>KF5 can be installed in /usr or /opt/kf5. The BLFS editors
30 recommend the latter in the BLFS environment.
31 </para>
32
33 <sect2>
34 <title>Installing in /usr</title>
35
36 <para>
37 One option is to install <application>KDE Frameworks 5</application>
38 into the <filename class="directory">/usr</filename> hierarchy.
39 This creates a simpler setup but makes it more difficult to try
40 multiple versions of <application>KDE Frameworks</application>.
41 </para>
42
43<screen><userinput>export KF5_PREFIX=/usr</userinput></screen>
44
45 <para>
46 It is a good idea to add the following variables to your
47 system or personal profiles:
48 </para>
49
50<screen role="root"><userinput>cat &gt;&gt; /etc/profile.d/qt5.sh &lt;&lt; "EOF"
51<literal># Begin kf5 extention for /etc/profile.d/qt5.sh
52
53pathappend /usr/lib/qt5/plugins QT_PLUGIN_PATH
54pathappend $QT5DIR/lib/plugins QT_PLUGIN_PATH
55
56pathappend /usr/lib/qt5/qml QML_IMPORT_PATH
57pathappend $QT5DIR/lib/qml QML_IMPORT_PATH
58
59pathappend /usr/lib/qt5/qml QML2_IMPORT_PATH
60pathappend $QT5DIR/lib/qml QML2_IMPORT_PATH
61
62# End extention for /etc/profile.d/qt5.sh</literal>
63EOF
64
65cat &gt; /etc/profile.d/kf5.sh &lt;&lt; "EOF"
66<literal># Begin /etc/profile.d/kf5.sh
67
68export KF5_PREFIX=/usr
69
70# End /etc/profile.d/kf5.sh</literal>
71EOF</userinput></screen>
72
73 <note><para>If <application>qt5</application> was installed in /usr, the
74 $QT5DIR/lib/ portions of the above paths may need to be changed to
75 $QT5DIR/lib/qt5/.</para></note>
76
77 <warning>
78 <para>
79 If <application>KDE4</application> is installed in
80 <filename class="directory">/usr</filename>, some packages
81 from this chapter might overwrite some programs installed
82 by <application>KDE4</application> packages.
83 </para>
84 </warning>
85
86 </sect2>
87
88 <sect2>
89 <title>Installing in /opt</title>
90
91 <para>
92 A method of building multiple versions installs
93 <application>KDE Frameworks 5</application> in the
94 <filename class="directory">/opt</filename> hierarchy:
95 </para>
96
97<screen><userinput>export KF5_PREFIX=/opt/kf5</userinput></screen>
98
99 <para>
100 If you are not installing <application>KDE Frameworks 5</application>
101 in <filename class="directory">/usr</filename>, you will need to
102 make some additional configuration changes. Best practice is to add
103 those to your system or personal profile:
104 </para>
105
106<screen role="root"><userinput>cat &gt; /etc/profile.d/kf5.sh &lt;&lt; "EOF"
107<literal># Begin /etc/profile.d/kf5.sh
108
109. /etc/profile.d/qt5.sh
110
111export KF5_PREFIX=/opt/kf5
112
113pathappend $KF5_PREFIX/bin PATH
114pathappend $KF5_PREFIX/lib/pkgconfig PKG_CONFIG_PATH
115
116pathappend /etc/xdg XDG_CONFIG_DIRS
117pathappend $KF5_PREFIX/etc/xdg XDG_CONFIG_DIRS
118pathappend /usr/share XDG_DATA_DIRS
119pathappend $KF5_PREFIX/share XDG_DATA_DIRS
120
121pathappend /usr/lib/qt5/plugins QT_PLUGIN_PATH
122pathappend $QT5DIR/plugins QT_PLUGIN_PATH
123pathappend $KF5_PREFIX/lib/plugins QT_PLUGIN_PATH
124
125pathappend /usr/lib/qt5/qml QML_IMPORT_PATH
126pathappend $QT5DIR/qml QML_IMPORT_PATH
127pathappend $KF5_PREFIX/lib/qml QML_IMPORT_PATH
128
129pathappend /usr/lib/qt5/qml QML2_IMPORT_PATH
130pathappend $QT5DIR/qml QML2_IMPORT_PATH
131pathappend $KF5_PREFIX/lib/qml QML2_IMPORT_PATH
132
133pathappend $KF5_PREFIX/lib/python&python2-majorver;/site-packages PYTHONPATH
134# End /etc/profile.d/kf5.sh</literal>
135EOF
136
137cat &gt; /etc/profile.d/qt5.sh &lt;&lt; "EOF"
138<literal># Begin /etc/profile.d/kf5.sh
139# Begin Qt5 changes for KF5
140
141pathappend $QT5DIR/plugins QT_PLUGIN_PATH
142pathappend $QT5DIR/qml QML_IMPORT_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>
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"><userinput>install -v -dm755 $KF5_PREFIX/{etc,share} &amp;&amp;
175ln -sfv /etc/dbus-1 $KF5_PREFIX/etc &amp;&amp;
176ln -sfv /usr/share/dbus-1 $KF5_PREFIX/share</userinput></screen>
177
178 <para>
179 Some packages may also install icons from the "hicolor" icon set. Since that
180 icon set is used by many packages, it is a good idea to create a
181 symlink to the one in <filename class="directory">/usr/share</filename>
182 to avoid having multiple installations of <xref linkend="hicolor-icon-theme"/>.
183 Run the following commands as the <systemitem class="username">root</systemitem>
184 user:
185 </para>
186
187<screen role="root"><userinput>install -v -dm755 $KF5_PREFIX/share/icons &amp;&amp;
188ln -sfv /usr/share/icons/hicolor $KF5_PREFIX/share/icons</userinput></screen>
189
190 <tip>
191 <para>
192 Sometimes, the installation paths are hardcoded into installed files.
193 This is the reason why <filename class="directory">/opt/kf5</filename>
194 is used as installation prefix instead of <filename
195 class="directory">/opt/kf5-&kf5-version;</filename>. After installing
196 <application>KDE Frameworks</application>, you may rename the directory
197 and create a symlink:
198 </para>
199
200<screen role="root"><userinput>mv /opt/kf5{,-&kf5-version;}
201ln -sfv kf5-&kf5-version; /opt/kf5</userinput></screen>
202
203 <para>
204 Later on, you may want to install other versions of
205 <application>KDE Frameworks 5</application>. To do that, just remove
206 the symlink and use <filename class="directory">/opt/kf5</filename>
207 as the prefix again. Which version of
208 <application>KDE Frameworks 5</application> you use depends only on
209 where the symlink points. No other reconfiguration will be needed.
210 </para>
211 </tip>
212
213 </sect2>
214
215</sect1>
216
217
Note: See TracBrowser for help on using the repository browser.