swift 05/04/07 12:04:19 Modified: xml/htdocs/doc/en metadoc.xml Added: xml/htdocs/doc/en fluxbox-config.xml Log: #87330 - New fluxbox configuration guide
Revision Changes Path 1.56 +7 -2 xml/htdocs/doc/en/metadoc.xml file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/metadoc.xml?rev=1.56&content-type=text/x-cvsweb-markup&cvsroot=gentoo plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/metadoc.xml?rev=1.56&content-type=text/plain&cvsroot=gentoo diff : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/metadoc.xml.diff?r1=1.55&r2=1.56&cvsroot=gentoo Index: metadoc.xml =================================================================== RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/metadoc.xml,v retrieving revision 1.55 retrieving revision 1.56 diff -u -r1.55 -r1.56 --- metadoc.xml 4 Apr 2005 19:53:57 -0000 1.55 +++ metadoc.xml 7 Apr 2005 12:04:18 -0000 1.56 @@ -1,9 +1,9 @@ <?xml version='1.0' encoding="UTF-8"?> -<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/metadoc.xml,v 1.55 2005/04/04 19:53:57 neysx Exp $ --> +<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/metadoc.xml,v 1.56 2005/04/07 12:04:18 swift Exp $ --> <!DOCTYPE metadoc SYSTEM "/dtd/metadoc.dtd"> <metadoc lang="en"> - <version>1.1</version> + <version>1.2</version> <members> <lead>swift</lead> <lead>neysx</lead> @@ -309,6 +309,7 @@ <file id="kde-split-ebuilds">/doc/en/kde-split-ebuilds.xml</file> <file id="grub-error-guide">/doc/en/grub-error-guide.xml</file> <file id="usb-guide">/doc/en/usb-guide.xml</file> + <file id="fluxbox-config">/doc/en/fluxbox-config.xml</file> </files> <docs> <doc id="name-logo"> @@ -597,6 +598,10 @@ <memberof>desktop_install</memberof> <fileid>gnome-config</fileid> </doc> + <doc id="fluxbox-config"> + <memberof>desktop_install</memberof> + <fileid>fluxbox-config</fileid> + </doc> <doc id="alsa-guide"> <memberof>desktop_config</memberof> <fileid>alsa-guide</fileid> 1.1 xml/htdocs/doc/en/fluxbox-config.xml file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/fluxbox-config.xml?rev=1.1&content-type=text/x-cvsweb-markup&cvsroot=gentoo plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/fluxbox-config.xml?rev=1.1&content-type=text/plain&cvsroot=gentoo Index: fluxbox-config.xml =================================================================== <?xml version='1.0' encoding="UTF-8"?> <!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/fluxbox-config.xml,v 1.1 2005/04/07 12:04:18 swift Exp $ --> <!DOCTYPE guide SYSTEM "/dtd/guide.dtd"> <guide link="/doc/en/fluxbox-config.xml"> <title>The Fluxbox Configuration HOWTO</title> <author title="Author"> <mail link="[EMAIL PROTECTED]">Jonathan Smith</mail> </author> <abstract> This howto will show you how to set up the Fluxbox windows manager for X11. </abstract> <!-- The content of this document is licensed under the CC-BY-SA license --> <!-- See http://creativecommons.org/licenses/by-sa/2.0 --> <license/> <version>1.0.1</version> <date>2005-04-01</date> <chapter> <title>Introduction</title> <section> <title>Introduction to the Fluxbox window manager</title> <body> <p> For those who are unfamiliar with Linux's desktop model, window managers (WMs) are the applications which are run by X11 to manage other graphical programs. While these are by no means required, an X11 session without a WM is quite ugly and does not contain many of the functions commonly associated with a modern desktop. </p> <p> Fluxbox is a WM which has a much more minimalist philosophy than more popular ones such as KDE or GNOME. While it serves the same basic purpose, Fluxbox lacks a graphical file manager, icons, a "start-menu"esque organization, and extra utilities. However, it is quite possible to obtain these and more if one so desires. This allows for the ultimate ability to customize, which is after all what Gentoo is about. </p> <p> This guide is aimed at those who are new to Fluxbox, curious, or who are just wanting to get more out of the Gentoo/Fluxbox experience. This guide will also illustrate how to get more (yet quite optional) functionality by using third party programs which work well with Fluxbox. </p> <p> Also note that since early 2005, XFree86 has been dropped from Gentoo Portage. This means that this guide is assuming the reader is using Xorg. If not, then this guide may nonetheless be accurate, but it does not attempt to provide cross-compatibility with XFree. Gentoo recommends changing to Xorg by <c>emerge xorg-x11</c>. </p> </body> </section> </chapter> <chapter> <title>Installing Fluxbox</title> <section> <title>Base installation</title> <body> <p> Gentoo provides an ebuild to quickly and easily install Fluxbox. While Gentoo provides the USE flags of <c>gnome</c> and <c>kde</c> which are to provide "compatibility" for those WMs, it has not been the author's experience that those are needed. If you desire qt, gtk+, or any KDE/GNOME utility then you are free to emerge and configure those independently. For example, the author uses Fluxbox with k3b, the KDE CD-R(W) burning utility. </p> <p> It is also necessary to have a program lock the X display to prevent unauthorized access, so it would be wise to also emerge <c>xlock</c>. The vast majority of users will also want the ability to set their own background, so we will emerge <c>eterm</c>, which doubles as a nice X11 terminal. </p> <pre caption="Emerging Fluxbox"> # <i>emerge fluxbox xlockmore x11-terms/eterm</i> </pre> <p> Well, thats it; Fluxbox is now installed! However, it is likely that you will not be able to use it efficiently with just those tools. The following sections will help install other potentially necessary packages, and configure Fluxbox and the third party programs to work for you. Keep in mind that all these steps are optional, so feel free to pick and choose. </p> </body> </section> </chapter> <chapter> <title>Configuring Fluxbox</title> <section> <title>Preparing X11</title> <body> <p> Fluxbox is simply another program that X11 runs. If desired, one can <c>startx</c> and then type <c>fluxbox</c> at an xterm. However, this is annoying to say the least. If one does not desire to boot to the GUI, but instead wants to start X11 manually, it is possible to have X automatically load Fluxbox by executing, as a normal (non-root) user: </p> <pre caption="Editing your xinit"> $ <i>echo fluxbox > ~/.xinitrc</i> </pre> <p> This is also not ideal for most users, as they want to have the desktop environment all the time; it is a pain to <c>startx</c> if it is desired to use a GUI everytime you boot. It also presents a security risk to the unaware. If one locks the X11 display using <c>xlock</c>, but run X11 from a console, then someone with physical access to the computer can switch to that console, kill X11, and use your account. The only way to prevent this is to either background X11 or run it in screen, detach the screen, and then logout of the console, a tedious task at best. If one uses a graphical login manager, this problem does not exist. However, you will be running X11 as root, which may be a bad thing. There are, as of this writing, no exploits that the author is aware of for the current version, but if one is concerned, then either not use X11 or use the above method with screen. Note that this is not a Fluxbox issue, but affects X11 itself. </p> <!-- thanks to Josh Nichols for helping cleanup this section. see comment #4 on bug 87330 --> <p> There are a number of graphical login managers to choose from; we will be using gdm. You may use another manager at your option, but gdm works well for Fluxbox, as well as any other WMs you may have installed such as GNOME, KDE, or xfce. </p> <pre caption="Login Manager"> # <i>emerge gdm</i> # <i>rc-update add xdm default</i> </pre> <impo> Be sure to emerge gdm and add xdm to the bootscript, and not the other way around! Switching these will cause failure. We will also need to modify one system-wide config file: </impo> <pre caption="Editing /etc/rc.conf"> DISPLAYMANAGER="gdm" </pre> </body> </section> <section> <title>Themes and Artwork</title> <body> <p> This section can be skipped if one truly wants a minimal footprint. However, it is nice to allow users to customize their WM's appearance. Themes specific to Fluxbox, Gentoo artwork for any WM, and themes that can be used on any *box WM will be installed. </p> <pre caption="Installing styles and artwork"> # <i>emerge commonbox-styles commonbox-styles-extra \ fluxbox-styles-fluxmod gentoo-artwork</i> </pre> </body> </section> <section> <title>Fluxbox Syntax for Vim</title> <body> <p> Next, install the special Fluxbox color scheme for <c>vim</c>. This enables users to more readily see the contents of their keys and init files for Fluxbox. This is a quite small extension for vim, so it is highly recommended (unless of course you are one of those emacs people, in which case I recommend <c>emerge -C emacs && emerge vim gvim</c> ;-). </p> <pre caption="Emerging Fluxbox Syntax"> <<Truncated>> -- [email protected] mailing list
