1 |
scarabeus 08/10/26 11:14:57 |
2 |
|
3 |
Modified: kde4-guide.xml |
4 |
Added: kde-flash.xml |
5 |
Log: |
6 |
Update kde4-guide and add kde flash to doc files. |
7 |
|
8 |
Revision Changes Path |
9 |
1.9 xml/htdocs/proj/en/desktop/kde/kde4-guide.xml |
10 |
|
11 |
file : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/proj/en/desktop/kde/kde4-guide.xml?rev=1.9&view=markup |
12 |
plain: http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/proj/en/desktop/kde/kde4-guide.xml?rev=1.9&content-type=text/plain |
13 |
diff : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/proj/en/desktop/kde/kde4-guide.xml?r1=1.8&r2=1.9 |
14 |
|
15 |
Index: kde4-guide.xml |
16 |
=================================================================== |
17 |
RCS file: /var/cvsroot/gentoo/xml/htdocs/proj/en/desktop/kde/kde4-guide.xml,v |
18 |
retrieving revision 1.8 |
19 |
retrieving revision 1.9 |
20 |
diff -u -r1.8 -r1.9 |
21 |
--- kde4-guide.xml 11 Oct 2008 10:11:43 -0000 1.8 |
22 |
+++ kde4-guide.xml 26 Oct 2008 11:14:57 -0000 1.9 |
23 |
@@ -1,12 +1,12 @@ |
24 |
<?xml version="1.0" encoding="UTF-8"?> |
25 |
<!DOCTYPE guide SYSTEM "/dtd/guide.dtd"> |
26 |
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/proj/en/desktop/kde/kde4-guide.xml,v 1.8 2008/10/11 10:11:43 jmbsvicetto Exp $ --> |
27 |
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/proj/en/desktop/kde/kde4-guide.xml,v 1.9 2008/10/26 11:14:57 scarabeus Exp $ --> |
28 |
|
29 |
<guide link="/proj/en/desktop/kde/kde4-guide.xml" lang="en"> |
30 |
<title>Gentoo KDE 4.1 Guide</title> |
31 |
|
32 |
<author title="Author"> |
33 |
- <mail link="tomas.chvatal@×××××.com">Tomáš Chvátal</mail> |
34 |
+ <mail link="scarabeus" /> |
35 |
</author> |
36 |
<author title="Author"> |
37 |
<mail link="jmbsvicetto"/> |
38 |
@@ -27,8 +27,8 @@ |
39 |
<!-- See http://creativecommons.org/licenses/by-sa/2.5 --> |
40 |
<license/> |
41 |
|
42 |
-<version>0.2</version> |
43 |
-<date>2008-09-28</date> |
44 |
+<version>0.3</version> |
45 |
+<date>2008-10-23</date> |
46 |
|
47 |
<chapter> |
48 |
<title>Cleaning up</title> |
49 |
@@ -66,41 +66,108 @@ |
50 |
</section> |
51 |
</chapter> |
52 |
<chapter> |
53 |
+<title>Grabbing overlay</title> |
54 |
+<section> |
55 |
+<title>Using layman</title> |
56 |
+<body> |
57 |
+ |
58 |
+<pre caption="layman command"> |
59 |
+# <i>layman -fS; layman -a kde-testing</i> |
60 |
+</pre> |
61 |
+ |
62 |
+</body> |
63 |
+</section> |
64 |
+<section> |
65 |
+<title>Using git</title> |
66 |
+<body> |
67 |
+ |
68 |
+<pre caption="git command"> |
69 |
+# <i>git clone git://git.overlays.gentoo.org/proj/kde.git /PATH/WHERE/TO/PUT/OVERLAY</i> |
70 |
+</pre> |
71 |
+ |
72 |
+</body> |
73 |
+</section> |
74 |
+<section> |
75 |
+<body> |
76 |
+ |
77 |
+<note> |
78 |
+The KDE 4.1 ebuilds make use of EAPI 2. Please use portage-2.2_rc11 or greater, if you |
79 |
+run an otherwise stable profile then you must add portage to your package.keywords file. |
80 |
+</note> |
81 |
+ |
82 |
+<note> |
83 |
+Don't forget to modify /etc/make.conf to add the overlay path to PORTDIR_OVERLAY, or |
84 |
+to add the support for layman as required. |
85 |
+</note> |
86 |
+ |
87 |
+</body> |
88 |
+</section> |
89 |
+</chapter> |
90 |
+ |
91 |
+<chapter> |
92 |
<title>Unmasking/Keywording</title> |
93 |
<section> |
94 |
-<title>Using the package.keywords/kde file from the kde-testing overlay</title> |
95 |
+<title>Using the bundled package.keywords/kde file</title> |
96 |
<body> |
97 |
|
98 |
<p> |
99 |
-The KDE 4.1 ebuilds are no longer masked so you won't need to use a package.unmask |
100 |
-file to be able to install them. If you're running ~arch and don't to update to 4.1, |
101 |
-you can use a package.mask file from under <uri |
102 |
-link="http://git.overlays.gentoo.org/gitweb/?p=proj/kde.git;a=blob_plain;f=Documentation/package.mask/kde;hb=master">Documentation/package.mask</uri>. |
103 |
+The KDE 4.1 ebuilds are no longer masked so you won't need to use the package.unmask |
104 |
+file to be able to install them. If you're running ~arch and don't want to update to 4.1, |
105 |
+you can use the package.mask file from Documentation/package.mask/kde. |
106 |
If you are running the stable tree you will need to keyword the ebuilds, |
107 |
otherwise skip this step. For those running the stable tree in Gentoo: |
108 |
</p> |
109 |
|
110 |
+<note> |
111 |
+This is the recomended way of keywording the KDE packages. |
112 |
+</note> |
113 |
+ |
114 |
<p> |
115 |
-Get the appropriate package.keywords file from the <c>kde-testing</c> |
116 |
-overlay that can be used in your package.keywords file/directory. You |
117 |
-can find this file under <uri |
118 |
-link="http://git.overlays.gentoo.org/gitweb/?p=proj/kde.git;a=blob_plain;f=Documentation/package.keywords/kde;hb=master">Documentation/package.keywords</uri>. |
119 |
+This overlay provides an appropriate package.keywords file that can be |
120 |
+used in your package.keywords file/directory. You can find this file in |
121 |
+"Documentation/package.keywords" directory. Copy it to the correct |
122 |
+location "/etc/portage/package.keywords/" (preferably make a symlink to |
123 |
+it), or add it to your "/etc/portage/package.keywords" file. |
124 |
Perform one of the following steps, depending on whether your |
125 |
/etc/portage/package.keywords is a directory or a file: |
126 |
</p> |
127 |
|
128 |
<pre caption="Adding the file to the package.keywords directory"> |
129 |
# <i>cd /etc/portage/package.keywords</i> |
130 |
-# <i>cp /path/to/keywords/file .</i> |
131 |
+# <i>ln -s /path/to/overlay/Documentation/package.keywords/kde .</i> |
132 |
</pre> |
133 |
|
134 |
<pre caption="Adding the file to the package.keywords file"> |
135 |
# <i>cd /etc/portage/</i> |
136 |
-# <i>cat /path/to/keywords/file >> package.keywords</i> |
137 |
+# <i>cat /path/to/overlay/Documentation/package.keywords/kde >> package.keywords </i> |
138 |
</pre> |
139 |
|
140 |
</body> |
141 |
</section> |
142 |
+<section> |
143 |
+<title>Creating the file from the packages in the overlay</title> |
144 |
+<body> |
145 |
+ |
146 |
+<pre caption="Adding keywords to the package.keywords directory"> |
147 |
+# <i>cd /path/to/our/overlay/</i> |
148 |
+# <i>find ./ -name \*.ebuild |sed -e "s:.ebuild::" -e "s:./::" |awk -F'/' '{print $1"/"$2}' >> /etc/portage/package.keywords/kde4x</i> |
149 |
+# <i>cd /usr/portage/</i> |
150 |
+# <i>find ./x11-libs/qt-* -type d |sed -e "s:./::" |awk -F'/' '{print $1"/"$2}' | uniq >> /etc/portage/package.keywords/kde4x</i> |
151 |
+</pre> |
152 |
+ |
153 |
+<pre caption="Adding keywords to the package.keywords file"> |
154 |
+# <i>cd /path/to/our/overlay/</i> |
155 |
+# <i>find ./ -name \*.ebuild |sed -e "s:.ebuild::" -e "s:./::" |awk -F'/' '{print $1"/"$2}' >> /etc/portage/package.keywords</i> |
156 |
+# <i>cd /usr/portage/</i> |
157 |
+# <i>find ./x11-libs/qt-* -type d |sed -e "s:./::" |awk -F'/' '{print $1"/"$2}' | uniq >> /etc/portage/package.keywords</i> |
158 |
+</pre> |
159 |
+ |
160 |
+<note> |
161 |
+There are some dependencies which require keywording that are not in this list. Keyword them as necessary. |
162 |
+</note> |
163 |
+ |
164 |
+</body> |
165 |
+</section> |
166 |
</chapter> |
167 |
<chapter> |
168 |
<title>Installation</title> |
169 |
@@ -225,6 +292,25 @@ |
170 |
|
171 |
</body> |
172 |
</section> |
173 |
+<section> |
174 |
+<title>Localization/Internationalization</title> |
175 |
+<body> |
176 |
+ |
177 |
+<p> |
178 |
+With new KDE there is new translators effort in Localization instead of |
179 |
+Internationalization. This cause some confusion but dont worry your translation |
180 |
+is shiped to you, just name has been changed so now for getting translations use |
181 |
+theese comands. |
182 |
+</p> |
183 |
+<pre caption="emerge translations for kde4 packages"> |
184 |
+# <i>emerge kde-l10n</i> |
185 |
+</pre> |
186 |
+<pre caption="emerge translations for kde3 packages"> |
187 |
+# <i>emerge kde-i18n</i> |
188 |
+</pre> |
189 |
+ |
190 |
+</body> |
191 |
+</section> |
192 |
</chapter> |
193 |
<chapter> |
194 |
<title>Configuration</title> |
195 |
@@ -354,17 +440,34 @@ |
196 |
|
197 |
</body> |
198 |
</section> |
199 |
+<section> |
200 |
+<title>Missing icons in KDE4</title> |
201 |
+<body> |
202 |
+ |
203 |
+<p> |
204 |
+When you occur with this bug try first this command before opening bug. |
205 |
+</p> |
206 |
+<pre caption="emerge command"> |
207 |
+# <i>emerge -1 kdebase-data && emerge -1 hicolor-icon-theme kdebase-data</i> |
208 |
+</pre> |
209 |
+ |
210 |
+</body> |
211 |
+</section> |
212 |
</chapter> |
213 |
<chapter> |
214 |
<title>Hints</title> |
215 |
<section> |
216 |
-<title>kde-misc/plasmoids</title> |
217 |
+<title>Plasmoids</title> |
218 |
<body> |
219 |
|
220 |
<p> |
221 |
-This ebuild contains various plasmoids that were requested by users (if you find |
222 |
-others that would be useful to our user community please contact us, SVN version |
223 |
-will not be added and it must work with KDE 4.1). |
224 |
+Plasmoids are new plasma tools which can enhance your desktop experience |
225 |
+to brand new level. We created kde-plasma/ section where we place every plasmoid |
226 |
+on which we get our nasty hands and find it workable enought. If you find out |
227 |
+that your favorite one is missing create bug and somebody might create it for |
228 |
+you. |
229 |
+If you are plasma person "want them all can't live without them" we have set |
230 |
+@plasmoids which contains all plasmoids currently availible. |
231 |
</p> |
232 |
|
233 |
</body> |
234 |
@@ -421,6 +524,18 @@ |
235 |
</body> |
236 |
</section> |
237 |
|
238 |
+<section> |
239 |
+<title>Flash in konqueror</title> |
240 |
+<body> |
241 |
+ |
242 |
+<p> |
243 |
+If you are interested in getting flash working in konqueror point your mind |
244 |
+to <uri link="kde-flash.xml" >guide</uri> which describes necessary steps for |
245 |
+getting it done. |
246 |
+</p> |
247 |
+ |
248 |
+</body> |
249 |
+</section> |
250 |
</chapter> |
251 |
<chapter> |
252 |
<title>Uninstalling KDE 4.x</title> |
253 |
|
254 |
|
255 |
|
256 |
1.1 xml/htdocs/proj/en/desktop/kde/kde-flash.xml |
257 |
|
258 |
file : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/proj/en/desktop/kde/kde-flash.xml?rev=1.1&view=markup |
259 |
plain: http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/proj/en/desktop/kde/kde-flash.xml?rev=1.1&content-type=text/plain |
260 |
|
261 |
Index: kde-flash.xml |
262 |
=================================================================== |
263 |
<?xml version="1.0" encoding="UTF-8"?> |
264 |
<!DOCTYPE guide SYSTEM "/dtd/guide.dtd"> |
265 |
<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/proj/en/desktop/kde/kde-flash.xml,v 1.1 2008/10/26 11:14:57 scarabeus Exp $ --> |
266 |
|
267 |
<guide link="/~lack/index.xml" lang="en"> |
268 |
<title>HowTo: Make Adobe's Flash player work with Konqueror</title> |
269 |
|
270 |
<author title="Author"> |
271 |
<mail link="lack"/> |
272 |
</author> |
273 |
<author title="Editor"> |
274 |
<mail link="scarabeus" /> |
275 |
</author> |
276 |
|
277 |
<abstract> |
278 |
A guide for Gentoo users who want to use Adobe's flash player in Konqueror. |
279 |
</abstract> |
280 |
|
281 |
<!-- The content of this document is licensed under the CC-BY-SA license --> |
282 |
<!-- See http://creativecommons.org/licenses/by-sa/2.5 --> |
283 |
<license/> |
284 |
|
285 |
<version>1.0</version> |
286 |
<date>2008-10-17</date> |
287 |
|
288 |
<chapter> |
289 |
<title>Steps</title> |
290 |
<section> |
291 |
<body> |
292 |
<p>You can use kmplayer's XEmbed to run Adobe's flash player under Konqueror. |
293 |
</p> |
294 |
<p> |
295 |
1. Install <b>media-video/kmplayer</b>, and ensure you have <b>USE="npp" |
296 |
</b> set. Make sure you have the proper version installed:</p> |
297 |
<table> |
298 |
<tr><th>kde Version</th><th>kmplayer Version</th></tr> |
299 |
<tr><ti>3</ti><ti>>=media-video/kmplayer-0.10.0c</ti></tr> |
300 |
<tr><ti>4</ti><ti>>=media-video/kmplayer-0.11</ti></tr> |
301 |
</table> |
302 |
<p> |
303 |
2. For amd64 machines, you will also need to install |
304 |
<b>net-www/nspluginwrapper</b> |
305 |
</p> |
306 |
<p> |
307 |
3. Run the following commands, depending on what arch you are running:</p> |
308 |
<pre caption="x86">$ kwriteconfig --file kmplayerrc --group "application/x-shockwave-flash" --key player npp |
309 |
$ kwriteconfig --file kmplayerrc --group "application/x-shockwave-flash" --key plugin /usr/lib/nsbrowser/plugins/libflashplayer.so</pre> |
310 |
<pre caption="amd64">$ kwriteconfig --file kmplayerrc --group "application/x-shockwave-flash" --key player npp |
311 |
$ kwriteconfig --file kmplayerrc --group "application/x-shockwave-flash" --key plugin /usr/lib64/nsbrowser/plugins/npwrapper.libflashplayer.so</pre> |
312 |
<p> |
313 |
4. Open Konqueror and click <b>Settings > Configure Konqueror</b>. In the |
314 |
new window navigate to <b>File Associations</b> in the left-hand panel and |
315 |
select <b>application/x-shockwave-flash</b>. Click the <b>Embedding</b> |
316 |
tab and click <b>Add..</b>. Select <b>Embedded MPlayer for KDE</b> from the |
317 |
new window. If it is not there then you may need to run <b>kbuildsycoca</b> |
318 |
from a terminal. Close all the opened windows. |
319 |
</p> |
320 |
</body> |
321 |
</section> |
322 |
</chapter> |
323 |
|
324 |
<chapter> |
325 |
<title>Known Issues</title> |
326 |
<section> |
327 |
<body> |
328 |
<p>Keyboard support is somewhat patchy, so some games may not function properly. |
329 |
</p> |
330 |
</body> |
331 |
</section> |
332 |
</chapter> |
333 |
|
334 |
<chapter> |
335 |
<title>Credits</title> |
336 |
<section> |
337 |
<body> |
338 |
<p>Shamelessly adapted from |
339 |
<uri>http://mikearthur.co.uk/2007/12/konqueror-with-latest-adobe-flash-howto/</uri> |
340 |
.</p> |
341 |
</body> |
342 |
</section> |
343 |
</chapter> |
344 |
</guide> |