source: kde/kf5/kf5-intro.xml@ 45ab6c7

11.0 lazarus qt5new trunk
Last change on this file since 45ab6c7 was 45ab6c7, checked in by Xi Ruoyao <xry111@…>, 5 months ago

more SVN prop clean up

Remove "$LastChanged$" everywhere, and also some unused $Date$

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