1 |
nightmorph 09/12/29 19:23:09 |
2 |
|
3 |
Modified: openbox.xml |
4 |
Log: |
5 |
Lots of updates for bug 256693. I also went through the guide and made several other changes, including adding packages that are finally marked stable, such as all the LXDE applications, to the recommended packages lists. |
6 |
|
7 |
Revision Changes Path |
8 |
1.6 xml/htdocs/doc/en/openbox.xml |
9 |
|
10 |
file : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/openbox.xml?rev=1.6&view=markup |
11 |
plain: http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/openbox.xml?rev=1.6&content-type=text/plain |
12 |
diff : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/openbox.xml?r1=1.5&r2=1.6 |
13 |
|
14 |
Index: openbox.xml |
15 |
=================================================================== |
16 |
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/openbox.xml,v |
17 |
retrieving revision 1.5 |
18 |
retrieving revision 1.6 |
19 |
diff -u -r1.5 -r1.6 |
20 |
--- openbox.xml 12 Nov 2009 22:55:43 -0000 1.5 |
21 |
+++ openbox.xml 29 Dec 2009 19:23:08 -0000 1.6 |
22 |
@@ -1,6 +1,6 @@ |
23 |
<?xml version="1.0" encoding="UTF-8"?> |
24 |
<!DOCTYPE guide SYSTEM "/dtd/guide.dtd"> |
25 |
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/openbox.xml,v 1.5 2009/11/12 22:55:43 nightmorph Exp $ --> |
26 |
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/openbox.xml,v 1.6 2009/12/29 19:23:08 nightmorph Exp $ --> |
27 |
|
28 |
<guide> |
29 |
<title>The Openbox Configuration HOWTO</title> |
30 |
@@ -21,8 +21,8 @@ |
31 |
<!-- See http://creativecommons.org/licenses/by-sa/2.5 --> |
32 |
<license/> |
33 |
|
34 |
-<version>1.3</version> |
35 |
-<date>2009-11-12</date> |
36 |
+<version>1.4</version> |
37 |
+<date>2009-12-29</date> |
38 |
|
39 |
<chapter> |
40 |
<title>Introduction</title> |
41 |
@@ -56,7 +56,7 @@ |
42 |
very quickly, even on older hardware. Whether your hardware is old or new, |
43 |
Openbox also provides a highly customisable and unobtrusive working |
44 |
environment. That means that if you don't want or need a panel, taskbar, clock, |
45 |
-or any other program, those choices are yours! |
46 |
+or any other program, those choices are yours to make! |
47 |
</p> |
48 |
|
49 |
</body> |
50 |
@@ -170,7 +170,7 @@ |
51 |
</p> |
52 |
|
53 |
<pre caption="Overwriting the default system-wide menu.xml files"> |
54 |
-$ <i>cp .config/openbox/menu.xml /etc/xdg/openbox/menu.xml</i> |
55 |
+# <i>cp .config/openbox/menu.xml /etc/xdg/openbox/menu.xml</i> |
56 |
</pre> |
57 |
|
58 |
<impo> |
59 |
@@ -188,13 +188,12 @@ |
60 |
</p> |
61 |
|
62 |
<pre caption="Editing the menu.xml file"> |
63 |
-<?xml version="1.0" encoding="UTF-8"?7gt; |
64 |
+<?xml version="1.0" encoding="UTF-8"?> |
65 |
<openbox_menu> |
66 |
<separator label="NAME_OF_SEPARATOR" /> |
67 |
<menu id="IDENTIFIER" label="NAME_OF_MENU"> |
68 |
<item label="NAME_OF_PROGRAM"> |
69 |
- <action |
70 |
- name="execute"><execute>/LOCATION/OF/BINARY</execute></action> |
71 |
+ <action name="execute"><execute>/LOCATION/OF/BINARY</execute></action> |
72 |
</item> |
73 |
</menu> |
74 |
</openbox_menu> |
75 |
@@ -261,11 +260,11 @@ |
76 |
<?xml version="1.0" encoding="UTF-8"?> |
77 |
<openbox_menu> |
78 |
<menu id="1" label="Configuration"> |
79 |
- <item label="OpenBox Config> |
80 |
+ <item label="OpenBox Config"> |
81 |
<action name="execute"><execute>/usr/bin/obconf</execute></action> |
82 |
</item> |
83 |
</menu> |
84 |
-</openbox_menu>> |
85 |
+</openbox_menu> |
86 |
</pre> |
87 |
|
88 |
</body> |
89 |
@@ -311,9 +310,10 @@ |
90 |
<p> |
91 |
Adding your own programs to the <path>autostart.sh</path> script is as easy as |
92 |
writing in the program name for many applications. For instance, if you have |
93 |
-Conky (a lightweight system monitor) installed, and want it to start |
94 |
-automatically with your Openbox session, you simply add the following line to |
95 |
-your <path>autostart.sh</path>: |
96 |
+<uri link="http://packages.gentoo.org/package/app-admin/conky">Conky</uri> (a |
97 |
+lightweight system monitor) installed, and want it to start automatically with |
98 |
+your Openbox session, you simply add the following line to your |
99 |
+<path>autostart.sh</path>: |
100 |
</p> |
101 |
|
102 |
<pre caption="Adding Conky to your autostart.sh"> |
103 |
@@ -338,10 +338,12 @@ |
104 |
Some things that you might take for granted in bigger desktop environments are |
105 |
not included by default in Openbox. One such thing is setting your desktop |
106 |
background. In order to place an image as your wallpaper, you will need to |
107 |
-emerge a program like feh or nitrogen. Feh is a simple image viewer that can |
108 |
-also set the background, <e>and</e> it can easily be put into the autostart |
109 |
-script. Once you have emerged feh, you can issue the following command to set |
110 |
-the background: |
111 |
+emerge a program like <uri |
112 |
+link="http://packages.gentoo.org/package/media-gfx/feh">feh</uri> or <uri |
113 |
+link="http://packages.gentoo.org/package/x11-misc/nitrogen">nitrogen</uri>. |
114 |
+<c>feh</c> is a simple image viewer that can also set the background, <e>and</e> |
115 |
+it can easily be put into the autostart script. Once you have emerged |
116 |
+<c>feh</c>, you can issue the following command to set the background: |
117 |
</p> |
118 |
|
119 |
<pre caption="Using feh to set the background image"> |
120 |
@@ -365,30 +367,27 @@ |
121 |
</pre> |
122 |
|
123 |
<p> |
124 |
-If you don't particularly care for the idea of having to issue a command in the |
125 |
-terminal in order to set your background, you can alternatively use nitrogen. It |
126 |
-will allow you to set a folder for your background images, view thumbnails of |
127 |
-those images, and fit, stretch, or tile them to your desktop. |
128 |
+If you don't particularly care for the idea of having to issue a command in the |
129 |
+terminal in order to set your background, you can alternatively use |
130 |
+<c>nitrogen</c>. It will allow you to set a folder for your background images, |
131 |
+view thumbnails of those images, and fit, stretch, or tile them to your |
132 |
+desktop. |
133 |
</p> |
134 |
|
135 |
<p> |
136 |
-Installing nitrogen and getting it into your Openbox menu requires a few more |
137 |
-steps than are readily apparent. Firstly, and most obviously, you need to |
138 |
-<c>emerge nitrogen</c>. Due to <uri |
139 |
-link="http://bugs.gentoo.org/show_bug.cgi?id=267231">this library dependency |
140 |
-bug</uri>, you may also need to <c>emerge --oneshot librsvg</c> to avoid a |
141 |
-runtime termination error. Secondly, you need to run nitrogen with your |
142 |
-backgrounds folder appended: |
143 |
+Installing <c>nitrogen</c> and getting it into your Openbox menu requires a few |
144 |
+more steps than are readily apparent. First, you need to <c>emerge nitrogen</c>. |
145 |
+Second, you need to run <c>nitrogen</c> with your backgrounds folder appended: |
146 |
</p> |
147 |
|
148 |
<pre caption="Starting nitrogen with your image folder"> |
149 |
-nitrogen /path/to/your/backgrounds/folder |
150 |
+$ <i>nitrogen /path/to/your/backgrounds/folder</i> |
151 |
</pre> |
152 |
|
153 |
<p> |
154 |
-Thirdly, you can set your background image, but it will not be there after you |
155 |
-logout. Just as with feh, you need to restore your background by editing your |
156 |
-<path>autostart.sh</path> script to have the following line: |
157 |
+Third, you can set your background image, but it will not be there after you |
158 |
+logout. Just as with <c>feh</c>, you need to restore your background by editing |
159 |
+your <path>autostart.sh</path> script to have the following line: |
160 |
</p> |
161 |
|
162 |
<pre caption="Restoring your background with nitrogen"> |
163 |
@@ -424,16 +423,14 @@ |
164 |
<body> |
165 |
|
166 |
<ul> |
167 |
-<!-- still ~arch |
168 |
<li> |
169 |
<uri |
170 |
link="http://packages.gentoo.org/package/lxde-base/lxterminal">LXterminal</uri> |
171 |
- is the default terminal emulator for LXDE. It is very lightweight, and |
172 |
- based on VTE. While EvilVTE offers many more customisation options |
173 |
- (including transparency), LXterminal has a graphical interface for some of the |
174 |
- more common options (font, colors, et cetera). |
175 |
+ is the default terminal emulator for LXDE. It is very lightweight, and based |
176 |
+ on VTE. While EvilVTE offers many more customisation options (including |
177 |
+ transparency), LXterminal has a graphical interface for some of the more |
178 |
+ common options (font, colors, et cetera). |
179 |
</li> |
180 |
---> |
181 |
<li> |
182 |
<uri |
183 |
link="http://packages.gentoo.org/package/x11-terms/evilvte">EvilVTE</uri> is |
184 |
@@ -468,28 +465,25 @@ |
185 |
link="http://packages.gentoo.org/package/x11-terms/terminal">Terminal</uri> |
186 |
is the VTE-based default for the Xfce desktop environment, so it does |
187 |
require some Xfce libraries to run. However, it is still fairly speedy, and |
188 |
- supports transparency and is easily customized. |
189 |
+ supports transparency and is easily customised. |
190 |
</li> |
191 |
</ul> |
192 |
|
193 |
</body> |
194 |
</section> |
195 |
- |
196 |
<section> |
197 |
<title>File managers</title> |
198 |
<body> |
199 |
|
200 |
<ul> |
201 |
-<!-- still ~arch |
202 |
<li> |
203 |
<uri |
204 |
link="http://packages.gentoo.org/package/x11-misc/pcmanfm">PCManFM</uri> is |
205 |
the lightweight filemanager from LXDE. It supports tabbed browsing, drag and |
206 |
drop, thumnails for images, bookmarks, volume management, searching, and |
207 |
- more. It also provides supports for managing the desktop background and |
208 |
+ more. It also provides supports for managing the desktop background and |
209 |
drawing desktop icons (both optionally). |
210 |
</li> |
211 |
---> |
212 |
<li> |
213 |
<uri link="http://packages.gentoo.org/package/xfce-base/thunar">Thunar</uri> |
214 |
is the standard file manager from Xfce. It features a bulk renamer, |
215 |
@@ -504,7 +498,8 @@ |
216 |
is the powerful file manager from the GNOME desktop environment. It features |
217 |
volume management, thumbnails for images, searching, and some system |
218 |
configuration. As it depends on many of the GNOME libraries for proper |
219 |
- function, it can seem a heavy compared to some of the other file managers. |
220 |
+ function, it can seem a bit heavy compared to some of the other file |
221 |
+ managers. |
222 |
</li> |
223 |
<li> |
224 |
<uri link="http://packages.gentoo.org/package/app-misc/gentoo">Gentoo</uri> |
225 |
@@ -531,16 +526,15 @@ |
226 |
<body> |
227 |
|
228 |
<ul> |
229 |
-<!-- still ~arch |
230 |
<li> |
231 |
Though <uri |
232 |
link="http://packages.gentoo.org/package/x11-misc/pcmanfm">PCManFM</uri> is |
233 |
mainly a file manager, it also gives you the option to manage the desktop |
234 |
- background (instead of using feh or nitrogen) and draw desktop icons. It |
235 |
- should be noted that with the current release (0.5), it is not readily |
236 |
- possible to get rid of the default "My Documents" icon on the desktop. |
237 |
+ background (instead of using <c>feh</c> or <c>nitrogen</c>) and draw |
238 |
+ desktop icons. It should be noted that with the current release (0.5.x), it |
239 |
+ is not readily possible to get rid of the default "My Documents" icon on the |
240 |
+ desktop. |
241 |
</li> |
242 |
---> |
243 |
<li> |
244 |
<uri link="http://packages.gentoo.org/package/x11-misc/idesk">iDesk</uri> is |
245 |
a simple program used to draw desktop icons. It supports shadowed and |
246 |
@@ -556,14 +550,11 @@ |
247 |
<body> |
248 |
|
249 |
<ul> |
250 |
-<!-- still ~arch |
251 |
<li> |
252 |
<uri link="http://code.google.com/p/tint2/">Tint2</uri> is a simple panel |
253 |
- and taskbar specifically made for Openbox3 (based on the ttm code). It |
254 |
- supports color/transparency, a clock, and drag and drop between virtual |
255 |
- desktops. |
256 |
+ and taskbar (based on the ttm code). It supports color/transparency, a |
257 |
+ clock, and drag and drop between virtual desktops. |
258 |
</li> |
259 |
---> |
260 |
<li> |
261 |
<uri |
262 |
link="http://packages.gentoo.org/package/x11-misc/pypanel">PyPanel</uri> is |
263 |
@@ -571,7 +562,6 @@ |
264 |
transparency, shading, tinting, location and layout configuration, font |
265 |
type, autohiding, application launcher, clock, and more. |
266 |
</li> |
267 |
-<!-- still ~arch |
268 |
<li> |
269 |
<uri |
270 |
link="http://packages.gentoo.org/package/lxde-base/lxpanel">LXPanel</uri> is |
271 |
@@ -579,7 +569,6 @@ |
272 |
clock, and a GUI-based configurator. It is feature-rich while depending on |
273 |
very few packages, making it a good choice for a lean system. |
274 |
</li> |
275 |
---> |
276 |
<li> |
277 |
<uri |
278 |
link="http://packages.gentoo.org/package/xfce-base/xfce4-panel">Xfce4-panel</uri> |
279 |
@@ -638,7 +627,6 @@ |
280 |
<body> |
281 |
|
282 |
<ul> |
283 |
-<!-- still ~arch |
284 |
<li> |
285 |
<uri link="http://packages.gentoo.org/package/lxde-base/lxsession"> |
286 |
LXsession</uri> is the stripped down session manager from LXDE. It is |
287 |
@@ -646,7 +634,6 @@ |
288 |
logout, and to automatically restart those programs. It also supports the |
289 |
HAL daemon. |
290 |
</li> |
291 |
---> |
292 |
<li> |
293 |
<uri link="http://packages.gentoo.org/package/xfce-base/xfce4-session"> |
294 |
Xfce4-session</uri> is the session manager from, you guessed it, Xfce. It |
295 |
@@ -668,7 +655,6 @@ |
296 |
is a GUI application allowing you to customise the Openbox window manager |
297 |
without manually editing <path>~/.config/openbox/rc.conf</path>. |
298 |
</li> |
299 |
-<!-- still ~arch |
300 |
<li> |
301 |
<uri |
302 |
link="http://packages.gentoo.org/package/lxde-base/lxappearance">LXappearance</uri> |
303 |
@@ -676,7 +662,6 @@ |
304 |
graphical interface for setting the theme and icons, while depending on very |
305 |
few extra libraries. |
306 |
</li> |
307 |
---> |
308 |
<li> |
309 |
<uri |
310 |
link="http://packages.gentoo.org/package/x11-themes/gtk-chtheme">GTK-ChTheme</uri> |
311 |
@@ -718,14 +703,12 @@ |
312 |
dynamically zoom, and set the desktop background (detailed instructions |
313 |
above). |
314 |
</li> |
315 |
-<!-- still ~arch |
316 |
<li> |
317 |
<uri |
318 |
link="http://packages.gentoo.org/package/media-gfx/gpicview">GPicView</uri> |
319 |
- is a GUI-based image viewer. Though it has more dependencies than feh, it |
320 |
- is incredibly quick to load and run. |
321 |
+ is a GUI-based image viewer. Though it has more dependencies than |
322 |
+ <c>feh</c>, it is incredibly quick to load and run. |
323 |
</li> |
324 |
---> |
325 |
<li> |
326 |
<uri link="http://packages.gentoo.org/package/x11-misc/slim">SLiM</uri> is |
327 |
the Simple Login Manager, which allows you to login to your Openbox session |
328 |
@@ -777,12 +760,6 @@ |
329 |
instead of manually editing your <path>~/.xinitrc</path>. |
330 |
</p> |
331 |
|
332 |
-<note> |
333 |
-This method of using Openbox with GNOME has been tested with the GNOME 2.22 |
334 |
-release. While it seems highly likely that it will work with GNOME 2.24 and |
335 |
-above, it has not been thoroughly tested as of yet. |
336 |
-</note> |
337 |
- |
338 |
</body> |
339 |
</section> |
340 |
<section> |
341 |
@@ -825,7 +802,7 @@ |
342 |
|
343 |
<p> |
344 |
If you use Xfce4 and would like to replace xfwm4 with Openbox, you will need to |
345 |
-go about it a little differently than with KDE or GNOME. Firstly, you need to |
346 |
+go about it a little differently than with KDE or GNOME. First, you need to |
347 |
start your normal Xfce session, and open up a terminal. From the terminal, |
348 |
issue the following command: |
349 |
</p> |
350 |
@@ -835,9 +812,9 @@ |
351 |
</pre> |
352 |
|
353 |
<p> |
354 |
-Secondly, you need to exit out of your Xfce session, and make sure to tick the |
355 |
+Second, you need to exit out of your Xfce session, and make sure to tick the |
356 |
checkbox that says "Save session for future login." This will keep Openbox as |
357 |
-your default window manager. Thirdly, you will notice that you can't logout |
358 |
+your default window manager. Third, you will notice that you can't logout |
359 |
properly when using the default menu action. To fix this problem, open up your |
360 |
<path>menu.xml</path>, and locate this line: |
361 |
</p> |