source: kde/kf5/kf5-intro.xml@ 3dec0a1

10.0 10.1 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 3dec0a1 was 1c8c15c, checked in by Pierre Labastie <pieere@…>, 20 months ago

Fix <para> format: kde chapter

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

  • Property mode set to 100644
File size: 7.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>
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.