Gentoo Archives: gentoo-commits

From: "Tomas Chvatal (scarabeus)" <scarabeus@g.o>
To: gentoo-commits@l.g.o
Subject: [gentoo-commits] gentoo commit in xml/htdocs/proj/en/desktop/kde: kde-flash.xml kde4-guide.xml
Date: Sun, 26 Oct 2008 11:15:00
Message-Id: E1Ku3aD-0005z2-HN@stork.gentoo.org
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 &amp;&amp; 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>