nightmorph 09/12/29 19:23:09 Modified: openbox.xml Log: 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.
Revision Changes Path 1.6 xml/htdocs/doc/en/openbox.xml file : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/openbox.xml?rev=1.6&view=markup plain: http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/openbox.xml?rev=1.6&content-type=text/plain diff : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/openbox.xml?r1=1.5&r2=1.6 Index: openbox.xml =================================================================== RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/openbox.xml,v retrieving revision 1.5 retrieving revision 1.6 diff -u -r1.5 -r1.6 --- openbox.xml 12 Nov 2009 22:55:43 -0000 1.5 +++ openbox.xml 29 Dec 2009 19:23:08 -0000 1.6 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE guide SYSTEM "/dtd/guide.dtd"> -<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/openbox.xml,v 1.5 2009/11/12 22:55:43 nightmorph Exp $ --> +<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/openbox.xml,v 1.6 2009/12/29 19:23:08 nightmorph Exp $ --> <guide> <title>The Openbox Configuration HOWTO</title> @@ -21,8 +21,8 @@ <!-- See http://creativecommons.org/licenses/by-sa/2.5 --> <license/> -<version>1.3</version> -<date>2009-11-12</date> +<version>1.4</version> +<date>2009-12-29</date> <chapter> <title>Introduction</title> @@ -56,7 +56,7 @@ very quickly, even on older hardware. Whether your hardware is old or new, Openbox also provides a highly customisable and unobtrusive working environment. That means that if you don't want or need a panel, taskbar, clock, -or any other program, those choices are yours! +or any other program, those choices are yours to make! </p> </body> @@ -170,7 +170,7 @@ </p> <pre caption="Overwriting the default system-wide menu.xml files"> -$ <i>cp .config/openbox/menu.xml /etc/xdg/openbox/menu.xml</i> +# <i>cp .config/openbox/menu.xml /etc/xdg/openbox/menu.xml</i> </pre> <impo> @@ -188,13 +188,12 @@ </p> <pre caption="Editing the menu.xml file"> -<?xml version="1.0" encoding="UTF-8"?7gt; +<?xml version="1.0" encoding="UTF-8"?> <openbox_menu> <separator label="NAME_OF_SEPARATOR" /> <menu id="IDENTIFIER" label="NAME_OF_MENU"> <item label="NAME_OF_PROGRAM"> - <action - name="execute"><execute>/LOCATION/OF/BINARY</execute></action> + <action name="execute"><execute>/LOCATION/OF/BINARY</execute></action> </item> </menu> </openbox_menu> @@ -261,11 +260,11 @@ <?xml version="1.0" encoding="UTF-8"?> <openbox_menu> <menu id="1" label="Configuration"> - <item label="OpenBox Config> + <item label="OpenBox Config"> <action name="execute"><execute>/usr/bin/obconf</execute></action> </item> </menu> -</openbox_menu>> +</openbox_menu> </pre> </body> @@ -311,9 +310,10 @@ <p> Adding your own programs to the <path>autostart.sh</path> script is as easy as writing in the program name for many applications. For instance, if you have -Conky (a lightweight system monitor) installed, and want it to start -automatically with your Openbox session, you simply add the following line to -your <path>autostart.sh</path>: +<uri link="http://packages.gentoo.org/package/app-admin/conky";>Conky</uri> (a +lightweight system monitor) installed, and want it to start automatically with +your Openbox session, you simply add the following line to your +<path>autostart.sh</path>: </p> <pre caption="Adding Conky to your autostart.sh"> @@ -338,10 +338,12 @@ Some things that you might take for granted in bigger desktop environments are not included by default in Openbox. One such thing is setting your desktop background. In order to place an image as your wallpaper, you will need to -emerge a program like feh or nitrogen. Feh is a simple image viewer that can -also set the background, <e>and</e> it can easily be put into the autostart -script. Once you have emerged feh, you can issue the following command to set -the background: +emerge a program like <uri +link="http://packages.gentoo.org/package/media-gfx/feh";>feh</uri> or <uri +link="http://packages.gentoo.org/package/x11-misc/nitrogen";>nitrogen</uri>. +<c>feh</c> is a simple image viewer that can also set the background, <e>and</e> +it can easily be put into the autostart script. Once you have emerged +<c>feh</c>, you can issue the following command to set the background: </p> <pre caption="Using feh to set the background image"> @@ -365,30 +367,27 @@ </pre> <p> -If you don't particularly care for the idea of having to issue a command in the -terminal in order to set your background, you can alternatively use nitrogen. It -will allow you to set a folder for your background images, view thumbnails of -those images, and fit, stretch, or tile them to your desktop. +If you don't particularly care for the idea of having to issue a command in the +terminal in order to set your background, you can alternatively use +<c>nitrogen</c>. It will allow you to set a folder for your background images, +view thumbnails of those images, and fit, stretch, or tile them to your +desktop. </p> <p> -Installing nitrogen and getting it into your Openbox menu requires a few more -steps than are readily apparent. Firstly, and most obviously, you need to -<c>emerge nitrogen</c>. Due to <uri -link="http://bugs.gentoo.org/show_bug.cgi?id=267231";>this library dependency -bug</uri>, you may also need to <c>emerge --oneshot librsvg</c> to avoid a -runtime termination error. Secondly, you need to run nitrogen with your -backgrounds folder appended: +Installing <c>nitrogen</c> and getting it into your Openbox menu requires a few +more steps than are readily apparent. First, you need to <c>emerge nitrogen</c>. +Second, you need to run <c>nitrogen</c> with your backgrounds folder appended: </p> <pre caption="Starting nitrogen with your image folder"> -nitrogen /path/to/your/backgrounds/folder +$ <i>nitrogen /path/to/your/backgrounds/folder</i> </pre> <p> -Thirdly, you can set your background image, but it will not be there after you -logout. Just as with feh, you need to restore your background by editing your -<path>autostart.sh</path> script to have the following line: +Third, you can set your background image, but it will not be there after you +logout. Just as with <c>feh</c>, you need to restore your background by editing +your <path>autostart.sh</path> script to have the following line: </p> <pre caption="Restoring your background with nitrogen"> @@ -424,16 +423,14 @@ <body> <ul> -<!-- still ~arch <li> <uri link="http://packages.gentoo.org/package/lxde-base/lxterminal";>LXterminal</uri> - is the default terminal emulator for LXDE. It is very lightweight, and - based on VTE. While EvilVTE offers many more customisation options - (including transparency), LXterminal has a graphical interface for some of the - more common options (font, colors, et cetera). + is the default terminal emulator for LXDE. It is very lightweight, and based + on VTE. While EvilVTE offers many more customisation options (including + transparency), LXterminal has a graphical interface for some of the more + common options (font, colors, et cetera). </li> ---> <li> <uri link="http://packages.gentoo.org/package/x11-terms/evilvte";>EvilVTE</uri> is @@ -468,28 +465,25 @@ link="http://packages.gentoo.org/package/x11-terms/terminal";>Terminal</uri> is the VTE-based default for the Xfce desktop environment, so it does require some Xfce libraries to run. However, it is still fairly speedy, and - supports transparency and is easily customized. + supports transparency and is easily customised. </li> </ul> </body> </section> - <section> <title>File managers</title> <body> <ul> -<!-- still ~arch <li> <uri link="http://packages.gentoo.org/package/x11-misc/pcmanfm";>PCManFM</uri> is the lightweight filemanager from LXDE. It supports tabbed browsing, drag and drop, thumnails for images, bookmarks, volume management, searching, and - more. It also provides supports for managing the desktop background and + more. It also provides supports for managing the desktop background and drawing desktop icons (both optionally). </li> ---> <li> <uri link="http://packages.gentoo.org/package/xfce-base/thunar";>Thunar</uri> is the standard file manager from Xfce. It features a bulk renamer, @@ -504,7 +498,8 @@ is the powerful file manager from the GNOME desktop environment. It features volume management, thumbnails for images, searching, and some system configuration. As it depends on many of the GNOME libraries for proper - function, it can seem a heavy compared to some of the other file managers. + function, it can seem a bit heavy compared to some of the other file + managers. </li> <li> <uri link="http://packages.gentoo.org/package/app-misc/gentoo";>Gentoo</uri> @@ -531,16 +526,15 @@ <body> <ul> -<!-- still ~arch <li> Though <uri link="http://packages.gentoo.org/package/x11-misc/pcmanfm";>PCManFM</uri> is mainly a file manager, it also gives you the option to manage the desktop - background (instead of using feh or nitrogen) and draw desktop icons. It - should be noted that with the current release (0.5), it is not readily - possible to get rid of the default "My Documents" icon on the desktop. + background (instead of using <c>feh</c> or <c>nitrogen</c>) and draw + desktop icons. It should be noted that with the current release (0.5.x), it + is not readily possible to get rid of the default "My Documents" icon on the + desktop. </li> ---> <li> <uri link="http://packages.gentoo.org/package/x11-misc/idesk";>iDesk</uri> is a simple program used to draw desktop icons. It supports shadowed and @@ -556,14 +550,11 @@ <body> <ul> -<!-- still ~arch <li> <uri link="http://code.google.com/p/tint2/";>Tint2</uri> is a simple panel - and taskbar specifically made for Openbox3 (based on the ttm code). It - supports color/transparency, a clock, and drag and drop between virtual - desktops. + and taskbar (based on the ttm code). It supports color/transparency, a + clock, and drag and drop between virtual desktops. </li> ---> <li> <uri link="http://packages.gentoo.org/package/x11-misc/pypanel";>PyPanel</uri> is @@ -571,7 +562,6 @@ transparency, shading, tinting, location and layout configuration, font type, autohiding, application launcher, clock, and more. </li> -<!-- still ~arch <li> <uri link="http://packages.gentoo.org/package/lxde-base/lxpanel";>LXPanel</uri> is @@ -579,7 +569,6 @@ clock, and a GUI-based configurator. It is feature-rich while depending on very few packages, making it a good choice for a lean system. </li> ---> <li> <uri link="http://packages.gentoo.org/package/xfce-base/xfce4-panel";>Xfce4-panel</uri> @@ -638,7 +627,6 @@ <body> <ul> -<!-- still ~arch <li> <uri link="http://packages.gentoo.org/package/lxde-base/lxsession";> LXsession</uri> is the stripped down session manager from LXDE. It is @@ -646,7 +634,6 @@ logout, and to automatically restart those programs. It also supports the HAL daemon. </li> ---> <li> <uri link="http://packages.gentoo.org/package/xfce-base/xfce4-session";> Xfce4-session</uri> is the session manager from, you guessed it, Xfce. It @@ -668,7 +655,6 @@ is a GUI application allowing you to customise the Openbox window manager without manually editing <path>~/.config/openbox/rc.conf</path>. </li> -<!-- still ~arch <li> <uri link="http://packages.gentoo.org/package/lxde-base/lxappearance";>LXappearance</uri> @@ -676,7 +662,6 @@ graphical interface for setting the theme and icons, while depending on very few extra libraries. </li> ---> <li> <uri link="http://packages.gentoo.org/package/x11-themes/gtk-chtheme";>GTK-ChTheme</uri> @@ -718,14 +703,12 @@ dynamically zoom, and set the desktop background (detailed instructions above). </li> -<!-- still ~arch <li> <uri link="http://packages.gentoo.org/package/media-gfx/gpicview";>GPicView</uri> - is a GUI-based image viewer. Though it has more dependencies than feh, it - is incredibly quick to load and run. + is a GUI-based image viewer. Though it has more dependencies than + <c>feh</c>, it is incredibly quick to load and run. </li> ---> <li> <uri link="http://packages.gentoo.org/package/x11-misc/slim";>SLiM</uri> is the Simple Login Manager, which allows you to login to your Openbox session @@ -777,12 +760,6 @@ instead of manually editing your <path>~/.xinitrc</path>. </p> -<note> -This method of using Openbox with GNOME has been tested with the GNOME 2.22 -release. While it seems highly likely that it will work with GNOME 2.24 and -above, it has not been thoroughly tested as of yet. -</note> - </body> </section> <section> @@ -825,7 +802,7 @@ <p> If you use Xfce4 and would like to replace xfwm4 with Openbox, you will need to -go about it a little differently than with KDE or GNOME. Firstly, you need to +go about it a little differently than with KDE or GNOME. First, you need to start your normal Xfce session, and open up a terminal. From the terminal, issue the following command: </p> @@ -835,9 +812,9 @@ </pre> <p> -Secondly, you need to exit out of your Xfce session, and make sure to tick the +Second, you need to exit out of your Xfce session, and make sure to tick the checkbox that says "Save session for future login." This will keep Openbox as -your default window manager. Thirdly, you will notice that you can't logout +your default window manager. Third, you will notice that you can't logout properly when using the default menu action. To fix this problem, open up your <path>menu.xml</path>, and locate this line: </p>
