1 |
neysx 09/04/27 20:18:50 |
2 |
|
3 |
Modified: openbox.xml |
4 |
Log: |
5 |
New draft from #256693 |
6 |
|
7 |
Revision Changes Path |
8 |
1.2 xml/htdocs/doc/en/openbox.xml |
9 |
|
10 |
file : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/openbox.xml?rev=1.2&view=markup |
11 |
plain: http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/openbox.xml?rev=1.2&content-type=text/plain |
12 |
diff : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/openbox.xml?r1=1.1&r2=1.2 |
13 |
|
14 |
Index: openbox.xml |
15 |
=================================================================== |
16 |
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/openbox.xml,v |
17 |
retrieving revision 1.1 |
18 |
retrieving revision 1.2 |
19 |
diff -u -r1.1 -r1.2 |
20 |
--- openbox.xml 29 Jan 2009 17:50:20 -0000 1.1 |
21 |
+++ openbox.xml 27 Apr 2009 20:18:50 -0000 1.2 |
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.1 2009/01/29 17:50:20 neysx Exp $ --> |
26 |
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/openbox.xml,v 1.2 2009/04/27 20:18:50 neysx Exp $ --> |
27 |
|
28 |
<guide disclaimer="draft"> |
29 |
<title>The Openbox Configuration HOWTO</title> |
30 |
@@ -18,8 +18,8 @@ |
31 |
<!-- See http://creativecommons.org/licenses/by-sa/2.5 --> |
32 |
<license/> |
33 |
|
34 |
-<version>1</version> |
35 |
-<date>2009-01-29</date> |
36 |
+<version>1.1</version> |
37 |
+<date>2009-04-27</date> |
38 |
|
39 |
<chapter> |
40 |
<title>Introduction</title> |
41 |
@@ -151,29 +151,24 @@ |
42 |
</pre> |
43 |
|
44 |
<p> |
45 |
-Once it is installed, you need to tell it that you want a menu specifically |
46 |
-using the Openbox XML syntax: |
47 |
+Once it is installed, make sure to logout of root, and back into your user account. |
48 |
+You then instruct MenuMaker to create a menu specifically using the Openbox XML |
49 |
+syntax: |
50 |
</p> |
51 |
|
52 |
<pre caption="Using MenuMaker to generate a basic Openbox menu.xml"> |
53 |
-# <i>mmaker -v OpenBox3</i> |
54 |
+$ <i>mmaker -v OpenBox3</i> |
55 |
</pre> |
56 |
|
57 |
<p> |
58 |
The generated menu will be located at |
59 |
-<path>/root/.config/openbox/menu.xml</path>. You can then copy the file, and |
60 |
-overwrite either your user-specific <path>menu.xml</path> or the system-wide |
61 |
-one (both mentioned above): |
62 |
+<path>~/.config/openbox/menu.xml</path>. You can then choose to leave it as |
63 |
+your user-specific <path>menu.xml</path>, or to additionally copy it to the |
64 |
+system-wide menu configuration as well: |
65 |
</p> |
66 |
|
67 |
-<pre caption="Overwriting the default menu.xml files"> |
68 |
-<comment>(Creating or overwriting your user-specific menu)</comment> |
69 |
-# <i>mv /root/.config/openbox/menu.xml /home/$USER/.config/openbox/menu.xml</i> |
70 |
- |
71 |
-OR |
72 |
- |
73 |
-<comment>(Overwriting your system-wide menu)</comment> |
74 |
-# <i>mv /root/.config/openbox/menu.xml /etc/xdg/openbox/menu.xml</i> |
75 |
+<pre caption="Overwriting the default system-wide menu.xml files"> |
76 |
+$ <i>mv .config/openbox/menu.xml /etc/xdg/openbox/menu.xml</i> |
77 |
</pre> |
78 |
|
79 |
<impo> |
80 |
@@ -193,17 +188,24 @@ |
81 |
<pre caption="Editing the menu.xml file"><![CDATA[ |
82 |
<?xml version="1.0" encoding="UTF-8"?> |
83 |
<openbox_menu> |
84 |
-<separator label="<i>NAME_OF_SEPARATOR</i>"> |
85 |
-<menu id="<i>IDENTIFIER</i>" label="<i>NAME_OF_MENU</i>"> |
86 |
- <item label="<i>NAME_OF_PROGRAM</i>"> |
87 |
- <action name="execute"><execute><i>/LOCATION/OF/BINARY</i></execute></action> |
88 |
+<separator label="NAME_OF_SEPARATOR" /> |
89 |
+<menu id="IDENTIFIER" label="NAME_OF_MENU"> |
90 |
+ <item label="NAME_OF_PROGRAM"> |
91 |
+ <action name="execute"><execute>/LOCATION/OF/BINARY</execute></action> |
92 |
</item> |
93 |
</menu> |
94 |
</openbox_menu> |
95 |
]]></pre> |
96 |
|
97 |
<p> |
98 |
-Simply replace anything in <c>BLUE CAPS</c> with your information. |
99 |
+Simply replace anything in CAPS with your information. |
100 |
+</p> |
101 |
+ |
102 |
+<p> |
103 |
+Alternatively, you can <c>emerge obmenu</c>, which is a graphical interface |
104 |
+allowing you to create your menus without having to manually edit the |
105 |
+<path>menu.xml</path> file. It is a very small application and offers a |
106 |
+nice amount of customisation without typing any XML. |
107 |
</p> |
108 |
|
109 |
</body> |
110 |
@@ -327,8 +329,8 @@ |
111 |
</p> |
112 |
|
113 |
<pre caption="Using feh to set the background image"> |
114 |
-<comment>(feh has many other options instead of --bg-scale (which will scale the image |
115 |
-to the screen dimensions). Consult the feh documentation.)</comment> |
116 |
+<comment>(feh has many other options instead of --bg-scale [which will scale the image |
117 |
+to the screen dimensions]. Consult the feh documentation.)</comment> |
118 |
$ <i>feh --bg-scale /path/to/image.jpg</i> |
119 |
</pre> |
120 |
|
121 |
@@ -345,6 +347,41 @@ |
122 |
source $HOME/.fehbg & |
123 |
</pre> |
124 |
|
125 |
+<p> |
126 |
+If you don't particularly care for the idea of having to issue a command in the |
127 |
+terminal in order to set your background, you can alternatively use nitrogen. It |
128 |
+will allow you to set a folder for your background images, view thumbnails of |
129 |
+those images, and fit, stretch, or tile them to your desktop. |
130 |
+</p> |
131 |
+ |
132 |
+<p> |
133 |
+Installing nitrogen and getting it into your Openbox menu requires a few more |
134 |
+steps than are readily apparent. Firstly, and most obviously, you need to emerge |
135 |
+nitrogen. Due to <uri link="http://bugs.gentoo.org/show_bug.cgi?id=267231">this |
136 |
+library dependency bug</uri>, you will also need to <c>emerge librsvg</c> to avoid |
137 |
+a runtime termination error. Secondly, you need to run nitrogen with your |
138 |
+backgrounds folder appended: |
139 |
+</p> |
140 |
+ |
141 |
+<pre caption="Starting nitrogen with your image folder"> |
142 |
+nitrogen /path/to/your/backgrounds/folder |
143 |
+</pre> |
144 |
+ |
145 |
+<p> |
146 |
+Thirdly, you can set your background image, but it will not be there after you |
147 |
+logout. Just as with feh, you need to restore your background by editing your |
148 |
+<path>autostart.sh</path> script to have the following line: |
149 |
+</p> |
150 |
+ |
151 |
+<pre caption="Restoring your background with nitrogen"> |
152 |
+nitrogen --restore & |
153 |
+</pre> |
154 |
+ |
155 |
+<p> |
156 |
+This will cause nitrogen to load automatically when you start your Openbox session, |
157 |
+and that can lead to a slightly slower load time than using feh. |
158 |
+</p> |
159 |
+ |
160 |
</body> |
161 |
</section> |
162 |
</chapter> |
163 |
@@ -410,6 +447,52 @@ |
164 |
</section> |
165 |
|
166 |
<section> |
167 |
+<title>File Managers</title> |
168 |
+<body> |
169 |
+ |
170 |
+<ul> |
171 |
+<li> |
172 |
+<uri link="http://packages.gentoo.org/package/x11-misc/pcmanfm">PCManFM</uri> |
173 |
+is the lightweight filemanager from LXDE. It supports tabbed browsing, drag and |
174 |
+drop, thumnails for images, bookmarks, volume management, searching, and more. |
175 |
+It also provides supports for managing the desktop background and drawing |
176 |
+desktop icons (both optionally). |
177 |
+</li> |
178 |
+<li> |
179 |
+<uri link="http://packages.gentoo.org/package/xfce-base/thunar">Thunar</uri> is |
180 |
+the standard file manager from Xfce. It features a bulk renamer, |
181 |
+user-customisable actions, and an extension framework. Since it depends on many |
182 |
+Xfce libraries, it isn't as lightweight as PCManFM, but it's still slimmed down |
183 |
+by comparison to other file managers like Nautilus (from GNOME), and Konqueror |
184 |
+(from KDE). |
185 |
+</li> |
186 |
+<li> |
187 |
+<uri |
188 |
+link="http://packages.gentoo.org/package/gnome-base/nautilus">Nautilus</uri> is |
189 |
+the powerful file manager from the GNOME desktop environment. It features |
190 |
+volume management, thumbnails for images, searching, and some system |
191 |
+configuration. As it depends on many of the GNOME libraries for proper |
192 |
+function, it can seem a heavy compared to some of the other file managers. |
193 |
+</li> |
194 |
+<li> |
195 |
+<uri link="http://packages.gentoo.org/package/app-misc/gentoo">Gentoo</uri> (no |
196 |
+relation to this glorious Linux distribution) is a two-pane style file manager |
197 |
+based on GTK+ 1.x. It is incredibly lightweight, but lacks a majority of the |
198 |
+features now prominent in modern file managers. It should definitely be |
199 |
+considered for older hardware, or if you are wanting a barebones setup. |
200 |
+</li> |
201 |
+<li> |
202 |
+<uri link="http://packages.gentoo.org/package/app-misc/emelfm2">emelFM2</uri> |
203 |
+is another file manager in the vein of Midnight Commander. It features a |
204 |
+three-pane window, and is requires GTK+ 2.6.x or higher. As with the Gentoo |
205 |
+file manager (listed above), it is barebones and does not include many features |
206 |
+prevalent in newer file managers. |
207 |
+</li> |
208 |
+</ul> |
209 |
+</body> |
210 |
+</section> |
211 |
+ |
212 |
+<section> |
213 |
<title>Desktop management</title> |
214 |
<body> |
215 |
|
216 |
@@ -432,14 +515,14 @@ |
217 |
|
218 |
</body> |
219 |
</section> |
220 |
+ |
221 |
<section> |
222 |
<title>Panels</title> |
223 |
<body> |
224 |
|
225 |
<ul> |
226 |
<li> |
227 |
-Currently not in the official tree, <uri |
228 |
-link="http://code.google.com/p/tint2/">Tint2</uri> is a simple panel and |
229 |
+<uri link="http://code.google.com/p/tint2/">Tint2</uri> is a simple panel and |
230 |
taskbar specifically made for Openbox3 (based on the ttm code). It supports |
231 |
colour/transparency, a clock, and drag and drop between virtual desktops. |
232 |
Currently, it is not available in the official Portage tree, but is available |
233 |
@@ -469,51 +552,87 @@ |
234 |
|
235 |
</body> |
236 |
</section> |
237 |
+ |
238 |
<section> |
239 |
-<title>File Managers</title> |
240 |
+<title>Pagers / Systrays</title> |
241 |
<body> |
242 |
|
243 |
<ul> |
244 |
<li> |
245 |
-<uri link="http://packages.gentoo.org/package/x11-misc/pcmanfm">PCManFM</uri> |
246 |
-is the lightweight filemanager from LXDE. It supports tabbed browsing, drag and |
247 |
-drop, thumnails for images, bookmarks, volume management, searching, and more. |
248 |
-It also provides supports for managing the desktop background and drawing |
249 |
-desktop icons (both optionally). |
250 |
+<uri link="http://packages.gentoo.org/package/x11-misc/netwmpager">NetWMpager</uri> is |
251 |
+an EWMH-compliant pager that integrates nicely into any of the *box environments. It |
252 |
+is not as obtrusive, and is much more readily customisable than many of the other |
253 |
+available pagers. |
254 |
</li> |
255 |
<li> |
256 |
-<uri link="http://packages.gentoo.org/package/xfce-base/thunar">Thunar</uri> is |
257 |
-the standard file manager from Xfce. It features a bulk renamer, |
258 |
-user-customisable actions, and an extension framework. Since it depends on many |
259 |
-Xfce libraries, it isn't as lightweight as PCManFM, but it's still slimmed down |
260 |
-by comparison to other file managers like Nautilus (from GNOME), and Konqueror |
261 |
-(from KDE). |
262 |
+<uri link="http://packages.gentoo.org/package/x11-misc/bbpager">BBpager</uri> is a |
263 |
+desktop pager that was originally written for BlackBox, but works nicely with Openbox |
264 |
+as well. It does have some BlackBox dependencies though. |
265 |
</li> |
266 |
<li> |
267 |
-<uri |
268 |
-link="http://packages.gentoo.org/package/gnome-base/nautilus">Nautilus</uri> is |
269 |
-the powerful file manager from the GNOME desktop environment. It features |
270 |
-volume management, thumbnails for images, searching, and some system |
271 |
-configuration. As it depends on many of the GNOME libraries for proper |
272 |
-function, it can seem a heavy compared to some of the other file managers. |
273 |
+<uri link="http://packages.gentoo.org/package/x11-plugins/docker">Docker</uri> is the |
274 |
+system tray that is made especially for Openbox. It has no extra dependencies, and |
275 |
+gives you the ability to view and use tray icons for supported GTK and QT-based |
276 |
+applications. |
277 |
</li> |
278 |
<li> |
279 |
-<uri link="http://packages.gentoo.org/package/app-misc/gentoo">Gentoo</uri> (no |
280 |
-relation to this glorious Linux distribution) is a two-pane style file manager |
281 |
-based on GTK+ 1.x. It is incredibly lightweight, but lacks a majority of the |
282 |
-features now prominent in modern file managers. It should definitely be |
283 |
-considered for older hardware, or if you are wanting a barebones setup. |
284 |
+<uri link="http://packages.gentoo.org/package/x11-misc/trayer">Trayer</uri> is a system |
285 |
+tray that was modified from the FBpanel code, and is often used with FVWM. One of its |
286 |
+perks is that it supports transparency. |
287 |
</li> |
288 |
+</ul> |
289 |
+ |
290 |
+</body> |
291 |
+</section> |
292 |
+ |
293 |
+<section> |
294 |
+<title>Session Management</title> |
295 |
+<body> |
296 |
+ |
297 |
+<ul> |
298 |
<li> |
299 |
-<uri link="http://packages.gentoo.org/package/app-misc/emelfm2">emelFM2</uri> |
300 |
-is another file manager in the vein of Midnight Commander. It features a |
301 |
-three-pane window, and is requires GTK+ 2.6.x or higher. As with the Gentoo |
302 |
-file manager (listed above), it is barebones and does not include many features |
303 |
-prevalent in newer file managers. |
304 |
+<uri link="http://packages.gentoo.org/package/lxde-base/lxsession-lite"> |
305 |
+LXsession-Lite</uri> is the stripped down session manager from LXDE. It is |
306 |
+designed to remember applications that the user was running at the last logout, |
307 |
+and to automatically restart those programs. It also supports the HAL daemon. |
308 |
+</li> |
309 |
+<li> |
310 |
+<uri link="http://packages.gentoo.org/package/xfce-base/xfce4-session"> |
311 |
+XFCE4-session</uri> is the session manager from, you guessed it, XFCE. It is |
312 |
+capable of saving several sessions, and provides methods for logging out, rebooting, |
313 |
+and suspending your computer. It does, however, have many XFCE and other library |
314 |
+dependencies. |
315 |
+</li> |
316 |
+</ul> |
317 |
+ |
318 |
+</body> |
319 |
+</section> |
320 |
+ |
321 |
+<section> |
322 |
+<title>Configuration tools</title> |
323 |
+<body> |
324 |
+ |
325 |
+<ul> |
326 |
+<li> |
327 |
+<uri link="http://packages.gentoo.org/package/x11-misc/obconf">ObConf</uri> is a GUI |
328 |
+application allowing you to customise the Openbox window manager without manually |
329 |
+editing <path>.config/openbox/rc.conf</path>. |
330 |
+</li> |
331 |
+<li> |
332 |
+<uri link="http://packages.gentoo.org/package/lxde-base/lxappearance">LXappearance</uri> is |
333 |
+a GTK theme and icon configurator used with LXDE. It provides a nice graphical interface |
334 |
+for setting the theme and icons, while depending on very few extra libraries. |
335 |
+</li> |
336 |
+<li> |
337 |
+<uri link="http://packages.gentoo.org/package/x11-themes/gtk-chtheme">GTK-ChTheme</uri> is |
338 |
+a simple application allowing for easier switching of GTK themes. Currently, it does not |
339 |
+allow for the switching of icon themes. |
340 |
</li> |
341 |
</ul> |
342 |
+ |
343 |
</body> |
344 |
</section> |
345 |
+ |
346 |
<section> |
347 |
<title>Miscellaneous</title> |
348 |
<body> |
349 |
@@ -527,12 +646,28 @@ |
350 |
in appearance and data display. |
351 |
</li> |
352 |
<li> |
353 |
+<uri link="http://packages.gentoo.org/package/app-editors/leafpad">Leafpad</uri> is |
354 |
+the default text editor from LXDE. It is very lightweight, but includes features |
355 |
+like codeset options, and the ability to undo/redo without limits. |
356 |
+</li> |
357 |
+<li> |
358 |
<uri link="http://packages.gentoo.org/package/media-gfx/feh">feh</uri> is a |
359 |
simple image viewer that runs from the terminal, but it also has many other |
360 |
features. It can display a slideshow of images, create an index print, |
361 |
dynamically zoom, and set the desktop background (detailed instructions |
362 |
above). |
363 |
</li> |
364 |
+<li> |
365 |
+<uri link="http://packages.gentoo.org/package/media-gfx/gpicview">GPicView</uri> is |
366 |
+a GUI-based image viewer. Though it has more dependencies than feh, it is incredibly |
367 |
+quick to load and run. This is the default image viewer from LXDE. |
368 |
+</li> |
369 |
+<li> |
370 |
+<uri link="http://packages.gentoo.org/package/x11-misc/slim">SLiM</uri> is the Simple |
371 |
+Login Manager, which allows you to login to your Openbox session via a graphical |
372 |
+interface instead of the terminal. It has very few dependencies, and supports many |
373 |
+external themes, but should not be used on machines that require remote logins. |
374 |
+</li> |
375 |
</ul> |
376 |
|
377 |
</body> |
378 |
@@ -709,3 +844,4 @@ |
379 |
</section> |
380 |
</chapter> |
381 |
</guide> |
382 |
+ |