From f1ff5ff3b2947ca31f0718e37bb0b2668303247f Mon Sep 17 00:00:00 2001 From: Mark Tiefenbruck Date: Fri, 22 Aug 2008 06:12:01 -0700 Subject: add -sync command line option for debugging X issues --- doc/asciidoc/fluxbox.1 | 2111 +++++++++++++++----------------------- doc/asciidoc/fluxbox.txt | 3 + doc/fluxbox.1.in | 11 +- nls/C/Translation.m | 1 + nls/en_GB/Translation.m | 1 + nls/en_GB/generated-ISO-8859-1.m | 1 + nls/en_GB/generated-UTF-8.m | 1 + nls/en_US/Translation.m | 1 + nls/en_US/generated-ISO-8859-1.m | 1 + nls/en_US/generated-UTF-8.m | 1 + src/fluxbox.cc | 6 +- src/fluxbox.hh | 2 +- src/main.cc | 7 +- 13 files changed, 835 insertions(+), 1312 deletions(-) diff --git a/doc/asciidoc/fluxbox.1 b/doc/asciidoc/fluxbox.1 index 24cabf7..de70779 100644 --- a/doc/asciidoc/fluxbox.1 +++ b/doc/asciidoc/fluxbox.1 @@ -1,429 +1,379 @@ .\" Title: fluxbox .\" Author: .\" Generator: DocBook XSL Stylesheets v1.73.2 -.\" Date: 08/20/2008 +.\" Date: 08/22/2008 .\" Manual: .\" Source: .\" -.TH "FLUXBOX" "1" "08/20/2008" "" "" +.TH "FLUXBOX" "1" "08/22/2008" "" "" .\" disable hyphenation .nh .\" disable justification (adjust text to left margin only) .ad l .SH "NAME" -fluxbox - Un liviano manejador de ventanas para el X Windowing System +fluxbox - A lightweight window manager for the X Windowing System .SH "SYNOPSIS" -\fIfluxbox\fR [\-v | \-version] [\-h | \-help] [\-i | \-info] \fIfluxbox\fR [\-rc rcfile] [\-log logfile] [\-display display] [\-screen scr,scr|all] [\-verbose] +\fIfluxbox\fR [\-rc rcfile] [\-log logfile] [\-display display] [\-screen scr,scr|all] [\-verbose] [\-sync] .sp -.SH "DESCRIPCION" -fluxbox(1) provee decoraciones de ventanas configurables, un menu root para lanzar aplicaciones y una barra de tareas que muestra el nombre del \fIworkspace\fR actual, la aplicacion activa y la hora actual\. Tambien hay un menu de workspace para agregar o remover espacios de trabajo\. La \fIslit\fR puede ser usada para \fIdockear\fR pequenias aplicaciones, por ej\.: la mayoria de las bbtools pueden usar la slit\. +\fIfluxbox\fR [\-v | \-version] | [\-h | \-help] | [\-i | \-info] | [\-list\-commands] .sp -fluxbox(1) puede iconificar las ventanas a la barra de tareas, agregando la ventana al submenu \fIIcons\fR del menu workspace\. Con un click reapareceran las ventanas iconificadas\. Doble\-click en la barra de titulo de una ventana la \fIfoldeara\fR (shade), por ej\.: desaparecera la ventana y quedara visible solamente la barra de titulo\. +.SH "DESCRIPTION" +fluxbox(1) provides configurable window decorations, a root menu to launch applications and a toolbar that shows the current workspace name, a set of application names and the current time\. There is also a workspace menu to add or remove workspaces\. The `slit\' can be used to dock small applications; e\.g\. most of the bbtools can use the slit\. .sp -fluxbox(1) usa su propia clase de graficos para renderizar sus imagenes al vuelo\. Mediante el uso de \fIestilos\fR se puede determinar en gran nivel la apariencia de un escritorio\. Los estilos de Fluxbox son compatibles con los de Blackbox 0\.65 o versiones anteriores, de modo que los usuarios que esten migrando aun pueden usar sus temas favoritos\. +fluxbox(1) can iconify windows to the toolbar, in addition to adding the window to the \fIIcons\fR submenu of the workspace menu\. One click and they reappear\. A double\-click on the titlebar of the window will \fIshade\fR it; i\.e\. the window will disappear, and only the titlebar will remain visible\. .sp -Fluxbox cumple con la mayoria de las especificaciones Extended Window Manager Hints (EWMH), asi como otros numerosos standards de Window Hinting\. Esto permite a todos los window managers que las cumplen proveer una interfaz comun para caracteristicas standard usadas por aplicaciones y utilidades de escritorio\. +fluxbox(1) uses its own graphics class to render its images on the fly\. By using style files, you can determine in great detail how your desktop looks\. fluxbox styles are compatible with those of Blackbox 0\.65 or earlier versions, so users migrating can still use their current favourite themes\. .sp -.SH "OPCIONES" +fluxbox(1) supports the majority of the Extended Window Manager Hints (EWMH) specification, as well as numerous other Window Hinting standards\. This allows all compliant window managers to provide a common interface to standard features used by applications and desktop utilities\. +.sp +.SH "OPTIONS" +.PP +\-display display +.RS 4 +Start fluxbox on the specified display\. Programs started by fluxbox will share the DISPLAY environment variable also\. +.RE +.PP +\-h, \-help +.RS 4 +Display command line options\. +.RE +.PP +\-i, \-info +.RS 4 +Display useful information concerning the defaults and compiled\-in options\. +.RE +.PP +\-log logfile +.RS 4 +Starting fluxbox with this option will designate a file in which you want to log events to\. +.RE .PP -\-d display |\-display display +\-rc rcfile .RS 4 -Inicia fluxbox en el -\fIdisplay\fR -especificado\. Los programas iniciados por Fluxbox tendran el mismo valor de la variable de entorno DISPLAY\. +Use a different config file other than the default ~/\.fluxbox/init\. .RE .PP -\-h | \-help +\-v, \-version .RS 4 -Muestra las opciones de lineas de comandos y sale\. +The version of fluxbox installed\. .RE .PP -\-i | \-info +\-screen scr,scr|all .RS 4 -Muestra informacion util concerniente a las opciones por defecto y las compiladas\. +Run on specified screens only or all (by default)\. .RE .PP -\-l logfile +\-verbose .RS 4 -Iniciando Fluxbox con esta opcion creara un archivo en el que se guardara un -\fIlog\fR -de los eventos\. +Print more information in process\. .RE .PP -\-rc archivo rc +\-sync .RS 4 -Usa otro archivo rc que el por defecto "~/\.fluxbox/init"\. \-version Muestra la version de Fluxbox instalada\. +Synchronize with the X server for debugging\. .RE -.SH "INICIANDO FLUXBOX" -fluxbox(1) viene con un programa llamado startfluxbox(8) localizado generalmente donde se instalo Fluxbox\. Este script nos provee con muchas opciones y variables que pueden ser indicadas cuando al inicio de Fluxbox\. Para utilizarlo cuando se inicia Fluxbox, se debe colocar \fIexec startfluxbox\fR como ultimo comando en el /\.xinitrc o /\.xsession del usuario (dependiendo de las distribuciones y del display manager que se utilice), asumiendo que la localizacion de fluxbox(1) y startfluxbox(8) estan en el $PATH del \fIshell\fR\. Tambien hay que notar que tal vez haya que crear el archivo /\.xinitrc o tal vez el setup use /\.xsession\. Para mas informacion ver el manual del shell\. +.SH "STARTING FLUXBOX" +fluxbox(1) comes with a program called startfluxbox(8) usually located wherever you installed fluxbox\. This script provides you with many options and variables that can be set when starting fluxbox\. To actually call fluxbox and begin using it, you should place "exec startfluxbox" in your /\.xinitrc or /\.xsession (depending on your distribution and/or display manager) as the last executed command\. This is assuming that the location of fluxbox(1) and startfluxbox(8) are in your shell\'s $PATH\. Also note that you may need to create the /\.xinitrc file or your setup may use /\.xsession instead, depending on your X setup\. For more information on your shell, please visit your shell\'s manual page\. +.sp +By using fluxbox \-i you\'ll see the defaults used by fluxbox(1)\. These are what fluxbox looks for upon startup\. In the list of `Defaults:\' you\'ll see a menu file location, this is where you can provide a system\-wide menu file for your users\. .sp -Usando \fIfluxbox \-i\fR se veran las opciones por defecto utilizadas por fluxbox(1)\. Estas son las que busca al inicio\. En la lista de \fIDefaults:\fR la ubicacion de archivo menu, ahi se puede proveer un menu comun para todos los usuarios\. +On exit or restart, fluxbox will save user defaults in the file ~/\.fluxbox/init\. Resources in this file can be edited by hand\. fluxbox also has many tools to edit these; look through the main menu once fluxbox has started to find different ways of managing your session\. .sp -Saliendo o reiniciando, Fluxbox guardara las configuraciones del usuario en el archivo ~/\.fluxbox/init\. Los recursos en este archivo pueden ser editados a mano\. Fluxbox tambien tiene muchas herramientas para modificar esto\. Hay que mirar en el menu principal una vez que Fluxbox ha iniciado para encontrar diferentes maneras de administrar la sesion\. +.SH "USING FLUXBOX" +When using fluxbox for the first time, users who are more accustomed to full desktop environments such as KDE or Gnome may be a little surprised by the minimal screen content\. fluxbox is designed to be fast and powerful, so it may take a bit of getting used to \(em however, the rewards are worthwhile\. .sp -.SH "USANDO FLUXBOX" -Cuando se usa Fluxbox por primera vez, los usuarios acostumbrados a ambientes de escritorios completos tales como KDE o Gnome pueden quedar un poco sorprendidos por el contenido de pantalla minimo\. Fluxbox esta diseniado para ser rapido y potente, asi que puede llevar un poco de tiempo acostumbrarse, sin embargo los resultados que se pueden obtener valen la pena\. Daremos un sumario rapido de las cosas comunes en esta seccion\. De todas maneras recomendamos que consulte las secciones referenciadas de este manual para posterior desarrollo de su entendimiento de lo que puede hacer con Fluxbox\. +In this section, we\'ll give a quick summary of the common things\. However, we recommend that you consult the referenced sections of this manual to further develop your understanding of what you can do with fluxbox\. .sp -.SS "Root Window (ventana principal)" -Observando el escritorio de Fluxbox inmediatamente despues del startup generalmente se vera solo una cosa: la barra de tareas (Toolbar)\. Si se hace click derecho (boton 3 del mouse) en algun lugar vacio se podra acceder al RootMenu (menu principal), con un click del boton del medio (boton 2 del mouse) en el escritorio muestra el WorkspaceMenu (menu de escritorio)\. +.SS "Root Window (Main)" +Looking at the fluxbox desktop immediately after startup you\'ll generally see only one thing: the toolbar\. If you right click (mouse button 3) somewhere on the desktop, you can access the RootMenu\. A middle click (mouse button 2) on the desktop shows you the WorkspaceMenu\. .sp -.SS "RootMenu y WorkspaceMenu" -Desde el RootMenu se pueden lanzar aplicaciones y configurar Fluxbox\. El WorkspaceMenu muestra todas las ventanas y en que escritorios estan\. Vea la seccion MENUS para saber como personalizar estos\. +.SS "RootMenu and WorkspaceMenu" +From the RootMenu you can launch applications and configure fluxbox\. The WorkspaceMenu shows all windows and on which workspaces they are\. See section MENUS on how to customize these menus\. .sp .SS "Toolbar" -La Toolbar contiene hasta ocho campos/herramientas: +The toolbar contains any combination of the following tools: .sp .sp .RS 4 \h'-04'\(bu\h'+03' -\fBWorkspace Name\fR: Nombre del escritorio actual +\fBWorkspace Name\fR: Name of the current visible workspace .RE .sp .RS 4 \h'-04'\(bu\h'+03' -\fBIconbar\fR: Muestra las ventanas +\fBIconbar\fR: List of windows managed by fluxbox .RE .sp .RS 4 \h'-04'\(bu\h'+03' -\fBSystem Tray\fR: Area para -\fIapplets\fR +\fBSystem Tray\fR: Area for applets .RE .sp .RS 4 \h'-04'\(bu\h'+03' -\fBClock\fR: Hora y fecha +\fBClock\fR: Date and Time .RE .sp .RS 4 \h'-04'\(bu\h'+03' -\fBWorkspace Arrows\fR: -\fIFlechas\fR -para cambiar de escritorio +\fBWorkspace Arrows\fR: Previous/Next Workspace .RE .sp .RS 4 \h'-04'\(bu\h'+03' -\fBWindow Arrows\fR: -\fIFlechas\fR -para cambiar de ventana +\fBWindow Arrows\fR: Previous/Next Application Window .RE -Los contenidos de la Toolbar pueden ser configurados en el archivo \fIinit\fR\. Hablaremos sobre este archivo en gran extension en la seccion RECURSOS\. +The contents of the toolbar can be configured in the `init\' file\. We discuss the `init\' file at great length in the RESOURCES section\. .sp .SS "Slit" -Inicialmente no se podra ver la Slit\. Esta ahi, es solo que aun no esta siendo utilizada\. La Slit confunde a algunos al principio\. Hay que pensar en ella como un \fImuelle\fR (dock) al que se pueden anclar pequenios programas\. Si se han mirado capturas de pantalla en el sitio oficial de Fluxbox probablemente se hayan notado pequenias aplicaciones en el borde de algunas de las pantallas\. Estas muy probablemente estaban \fIdockeadas\fR en la Slit\. Para aprender mas sobre la Slit hay una seccion entera mas adelante que entra en detalle acerca de las opciones de que dispone\. +Initially you won\'t be able to see the slit\. It is there, but it isn\'t being used yet\. The slit confuses some people initially\. Think of it as a dock where you can place smaller programs\. If you\'ve looked at any screenshots on the official fluxbox web site, you will have noticed some small programs on the edge of some of the screens\. These were more than likely docked programs in the slit\. To learn more about the slit, we have an entire section below that goes into detail about the options you have\. .sp .SS "Layers" -Fluxbox maneja las siguientes Layers (capas) \fB Above Dock \fR Dock \fB Top \fR Normal \fB Bottom \fR Desktop -.sp -Las ventanas en una capa mas alta aparecen sobre las que estan en una mas baja\. Estas capas pueden ser usadas en ventanas de aplicaciones, en la Slit o en la Toolbar\. Se pueden asignar aplicaciones a una cierta capa especificandolo en el archivo apps\. Hablaremos sobre el archivo \fIapps\fR en la seccion APLICACIONES\. Se discutira en mas detalle sobre las capas en la seccion LAYERS\. -.sp -.SS "Focus Model" -La ventana que esta enfocada es la que recibe los eventos de teclado y mouse\. El tipo de enfocado (Focus Model) es seleccionable via menu de Configuracion localizado en el RootMenu\. Discutiremos sobre los diferentes modos de enfocado en la seccion FOCUS MODEL\. -.sp -.SS "Ventanas" -Un click izquierdo del mouse en cualquier parte del borde de la ventana la \fIelevara\fR sobre las otras\. Manteniendo apretado el boton y arrastrando la desplazara a otra parte del escritorio\. Arrastrando los \fIgrips\fR de tamanio en las esquinas inferiores izquierda y derecha cambiaran el tamanio de la ventana\. Click del medio en un borde o la barra de titulo inmediatamente la \fIbajara\fR\. Click derecho en un borde o la barra de titulo muestra el WindowMenu\. Los comandos en este menu en particular se comentan en detalle en la seccion MENUS\. -.sp -.SS "Tabs" -Fluxbox permite que las ventanas sean \fIagrupadas\fR haciendo click con el boton del medio en la barra de titulo y luego arrastrando y soltando en otra ventana\. De esta manera las barras de título se convertiran en pestanias permitiendo al usuario seleccionar cada ventana individualmente\. Este metodo nos permite poner multiples aplicaciones en una sola localizacion en el escritorio, y hacer muchas operaciones (por ej\. mover o cambiar de tamanio) a todas las ventanas del grupo\. Las opciones se detallan en la seccion TAB OPTIONS -.sp -.SS "Miscelaneas" -Cuando se quiere arrastrar una ventana, pero no se puede ver el borde inferior o la barra de titulo se puede apretar (y sostener!) +fluxbox manages the following layers (from highest to lowest): .sp .sp .RS 4 -.nf -ALT + Boton Izquierdo del Mouse (Boton 1) -.fi +\h'-04'\(bu\h'+03'Above Dock .RE -y moverla a cualquier parte del espacio de trabajo actual\. Esta combinacion de teclas puede ser usada tambien para traer el frente ventanas parcialmente visibles\. -.sp -La combinacion -.sp .sp .RS 4 -.nf -ALT + Boton Derecho del Mouse (Boton 3) -.fi +\h'-04'\(bu\h'+03'Dock .RE -permitira cambiar el tamanio de la ventana\. Esto puede se deshabilitado en el archivo \fIinit\fR (por defecto ~/\.fluxbox/init) con: -.sp .sp .RS 4 -.nf -session\.session0\.useMod1: -.fi +\h'-04'\(bu\h'+03'Top .RE -.SS "MENUS" -Fluxbox instala un archivo de menu por defecto en /user/local/share/fluxbox/menu\. Para confirmar esto podemos usar el comando fluxbox \-i desde una terminal\. Por supuesto este menu puede ser modificado para todos los usuarios de una sola vez, pero tambien es posible crear un menu individual para cada usuario\. Por convencion los usuarios crean su archivo menu en ~/\.fluxbox\. Una vez que hemos creado nuestro propia menu, querremos asegurarnos que indicamos adecuadamente su localizacion en nuestro archivo \fIinit\fR asi fluxbox sabra donde buscar\. El valor que debemos agregar o cambiar es: -.sp .sp .RS 4 -.nf -session\.session0\.menuFile: -.fi +\h'-04'\(bu\h'+03'Normal .RE -Para que este cambio tenga efecto debemos reiniciar Fluxbox\. Nos aseguramos que nuestro menu sea utilizable, luego elegimos \fIRestar\fR del menu root\. Este reinicio es necesario solamente si hacemos cambios al archivo \fIinit\fR, de otra manera alcanza con \fIReload config\fR\. Una recarga del menu tambien puede ser forzada enviando una senial SIGUSR2 (ver la seccion SENIALES)\. -.sp -.SS "Menu Root" -El menu root es donde se pueden cambiar diferentes aspectos de fluxbox simplemente haciendo click en un item del mismo\. La mayoria de los cambios en este menu tambien se pueden hacer en el archivo \fIinit\fR\. Sin embargo es mucho mas facil cambiar ciertas opciones sin tener que abrir un editor de texto y buscar el recurso\. En el menu root generalmente se tiene un submenu llamado\'fluxbox menu\' o \fIsettings\fR, donde se encontrara una cantidad de opciones diferentes\. Le echaremos una mirada a la mayoria, si no a todas, aqui\. -.sp .sp .RS 4 -\h'-04'\(bu\h'+03' -\fBConfigure\fR: El proximo nivel bajo este menu es donde se pueden indicar ciertas opciones y realmente empezar a personalizar el -\fIlook and feel\fR -del escritorio\. +\h'-04'\(bu\h'+03'Bottom .RE .sp .RS 4 -\h'-04'\(bu\h'+03' -\fBSystem Styles\fR: Aca es donde se encuentra la lista de los estilos estandar\. Se puede seleccionar uno de ellos con un simple click\. Es probable que se tenga que recargar la configuracion o reiniciar para que cada elemento grafico corresponda al nuevo estilo\. Los estilos de sistema estan localizados en /usr/local/share/fluxbox/styles de acuerdo a una instalacion por defecto\. Cabe recordar que se puede confirmar esto con fluxbox \-i\. +\h'-04'\(bu\h'+03'Desktop .RE +Windows on a higher layer will always appear above those on a lower one\. These layers can be used on application windows, the slit or the toolbar\. You can assign applications to a certain layer by specifying it in the `apps\' file or through the WindowMenu\. We discuss the `apps\' file in the APPLICATIONS section\. We discuss the WindowMenu in the MENUS section\. We discuss layers in more detail in the LAYERS section\. .sp -.RS 4 -\h'-04'\(bu\h'+03' -\fBUser Styles\fR: ~/\.fluxbox/styles es la ubicacion donde se almacenaran los estilos nuevos que se consigan de Internet\. Si se crean estilos propios tambien es este el directorio donde colocarlos (siguiendo los -\fIstandards\fR -descriptos en fluxstyle(1))\. -.RE +.SS "Focus Model" +The window that has the focus is the one that receives key and mouse events\. The focus model is selectable via the Configuration menu located in the root menu\. We\'ll discuss the different types of focus below in the FOCUS MODEL section\. .sp -.RS 4 -\h'-04'\(bu\h'+03' -\fBWorkspace List\fR: Esta es una lista de los espacios de trabajo configurados en -\fIinit\fR\. Si hay programas ejecutandose en alguno de los -\fIescritorios\fR -apareceran listados un nivel mas abajo\. -.RE +.SS "Windows" +A left click (mouse button 1) on any part of the window\'s border will raise it\. Dragging then moves the window to another part of the desktop\. A right click and drag on the border resizes the window\. Dragging the resize grips at the left and right bottom corners also will resize the window\. Middle clicking on a border or titlebar will immediately lower the window\. Right clicking on the titlebar opens the Window menu\. The commands unique to this menu are discussed in detail in the Window Menu section of MENUS\. .sp -.RS 4 -\h'-04'\(bu\h'+03' -\fBTools\fR: Aparecen listadas diferentes herramientas que se pueden utilizar\. Se puede renombrar ventanas o regenerar el menu\. -.RE +.SS "Tabs" +fluxbox allows windows to be `grouped\' by middle clicking and holding on a window\'s tab and dragging it onto another window\. This `tabbing\' allows you to put multiple applications in one location on the desktop and do several operations (for example, moving or resizing) to all windows in the group\. By default, tabs are located just above the window, but they may be embedded in the titlebar or moved to other locations on the outside of the window\. Configuration is discussed in TAB OPTIONS section\. +.sp +.SH "MENUS" +fluxbox installs a default menu file in @pkgdatadir@/menu\. You can also use fluxbox \-i to confirm this action\. Of course this system\-wide menu can be customized for all users at once, but it is also possible to create an individual menu file for each user\. By convention, users create a menu file in ~/\.fluxbox/menu \. Once you\'ve created your own menu file, you\'ll want to make sure that you properly declare this location in your `init\' file so that fluxbox knows where to look\. The value you\'ll want to add or change is: .sp -.RS 4 -\h'-04'\(bu\h'+03' -\fBWindow\fR: Permite cambiar el manejador de ventanas (aparece solamente si se tienen instalados otros manejadores de ventanas o ambientes de escritorio)\. -.RE .sp .RS 4 -\h'-04'\(bu\h'+03' -\fBLock Screen\fR: Bloquea la pantalla\&... +.nf +session\.menuFile: +.fi .RE +For this change to take effect, fluxbox must be restarted\. Be sure that your menu is usable, then choose `Restart\' from the default fluxbox root menu\. This restart is only necessary if you make changes to the `init\' file; otherwise, fluxbox will automatically detect your changes\. +.sp +.SS "Root Menu" +The root menu is where you can change different aspects of fluxbox by simply clicking on a menu item\. Most of the changes in this menu can also be done in the `init\' file\. However it makes it very easy to change certain options without having to open up an editor and find the resource\. In the root menu, you usually have a `fluxbox menu\' or `Settings\' submenu, where you will find lots of different options\. We\'ll take a look at most, if not all, of those here\. +.sp .sp .RS 4 \h'-04'\(bu\h'+03' -\fBFluxbox Command\fR: Una pequenia linea de comandos aparecera donde se podra ingresar un comando Fluxbox\. +\fBConfigure\fR: The next level under this menu is where you can set certain resources and really begin to customize the look and feel of your desktop\. .RE .sp .RS 4 \h'-04'\(bu\h'+03' -\fBReload Config\fR: Se utiliza para recargar cualquier archivo de menu o estilo\. Es solo una re\-lectura basica de los archivos usados por Fluxbox\. +\fBSystem Styles\fR: This is where the standard styles are listed\. You can select one of these by clicking on it\. You may have to `reload\' the config or `restart\' to get every graphical element to change to the new style\. System styles are located in @pkgdatadir@/styles/ upon a default install\. Remember that you can confirm this with fluxbox \-i\. .RE .sp .RS 4 \h'-04'\(bu\h'+03' -\fBRestart\fR: Reinicia todo, esto relee archivos y redibuja elementos graficos\. +\fBUser Styles\fR: ~/\.fluxbox/styles This is the location where you will store new styles that you grab from the Internet\. If you create your own styles this is also where you will put yours (provided that you follow the +\fIstandards\fR +described in fluxstyle(1))\. .RE .sp .RS 4 \h'-04'\(bu\h'+03' -\fBExit\fR: Sale de fluxbox y termina el servidor X\. +\fBWorkspace List\fR: This is a list of the workspaces configured in your `init\' file\. If there are programs running on any of the workspaces, they will be listed one level down\. .RE -.SS "Menu de Configuracion" -Este menu ofrece la oportunidad de configurar fluxbox\. Tambien puede ser hecho editando el archivo init, pero es mas facil y mas rapido para la mayoria de los usuarios hacerlo desde el menu\. -.sp .sp .RS 4 \h'-04'\(bu\h'+03' -\fBFocus Model\fR: Por favor leer la seccion FOCUS MODEL al final de este manual\. +\fBTools\fR: Listed here are different tools that you can use\. You can rename your workspace, run programs from a command line or regenerate your menu\. .RE .sp .RS 4 \h'-04'\(bu\h'+03' -\fBTab Options\fR: Nos permite configurar las propiedades de las -\fItabs\fR\. Se detalla en la seccion TAB OPTIONS\. +\fBWindow\fR: Allows you to switch your window manager\. (Only listed if you have other window managers/desktop environments installed\.) .RE .sp .RS 4 \h'-04'\(bu\h'+03' -\fBSlit\fR: Este menu puede ser abierto clickeando sobre la Slit (si esta visible)\. +\fBLock Screen\fR: Locks the screen\&... .RE .sp .RS 4 \h'-04'\(bu\h'+03' -\fBLayer\fR: Mirar dentro de este submenu las distintas prioridades de Layer\. +\fBfluxbox Command\fR: A little Commandline will popup where you can enter a fluxbox command\. .RE .sp .RS 4 \h'-04'\(bu\h'+03' -\fBAuto Hide\fR: Si esta activado, la slit desaparecera luego de cierto tiempo y se escondera de la vista del usuario\. Se puede hacer aparecer si se mueve el mouse hacia el borde del escritorio donde la slit esta posicionada\. +\fBReload Config\fR: Use this to reload any menu files or style files\. Just a basic re\-read of the files by a running fluxbox\. .RE .sp .RS 4 \h'-04'\(bu\h'+03' -\fBMaximize Over\fR: Si activado, todas las ventanas al ser maximizadas se estiraran hasta pasar por encima o por debajo de la slit\. De otro modo seran limitadas por el borde de esta\. +\fBRestart\fR: Restart the whole darn thing\. This starts a completely new fluxbox process, rereads files and redraws all graphical elements\. Running applications will remain open, however\. .RE .sp .RS 4 -\h'-04'\(bu\h'+03' -\fBAlpha\fR: Cambiando este valor la slit se volvera mas o menos transparente (solamente su decoracion, no las aplicaciones en ella)\. 0 (transparente) \- 255 (opaco) +\h'-04'\(bu\h'+03'*Exit: Exits fluxbox and probably shuts down the X Window server\. .RE +.SS "Configuration Menu" +This menu offers the opportunity to set up fluxbox\. It contains many options from the init file, but this is an easier and faster way for most users\. +.sp .sp .RS 4 \h'-04'\(bu\h'+03' -\fBSlit Direction\fR: Alterando este valor se indicara la direccion de la slit para ordenar las aplicaciones cargadas en la slit\. No hay efecto con solo una aplicacion\. +\fBFocus Model\fR: Please read the FOCUS MODEL section at the end of this manual\. .RE .sp .RS 4 \h'-04'\(bu\h'+03' -\fBClients\fR: Este submenu nos deja reordenar las aplicaciones corriendo en la slit\. Se pueden esconder deseleccionandolas en la lista que las muestra\. Esto no matara la aplicacion\. Se hacen aparecer seleccionandolas en la lista\. La opcion "Save Slitlist" guarda el nuevo orden en el archivo -\fIslitlist\fR -localizado en ~/\.fluxbox (util si se reordenan las aplicaciones con las opciones -\fICycle Up\fR -y -\fICycle Down\fR)\. +\fBTab Options\fR: Lets you configure the properties of tabs\. Detailed in TAB OPTIONS section\. .RE .sp .RS 4 \h'-04'\(bu\h'+03' -\fBToolbar\fR: Observar la parte de la seccion TOOLBAR denominada "Configuracion a traves del menu de la Barra de Herramientas"\. +\fBSlit\fR: This Menu can be opened by right clicking the slit (if visible)\. Find more information about this menu\'s options in the SLIT section\. .RE .sp .RS 4 \h'-04'\(bu\h'+03' -\fBImage dithering\fR: Activa o desactiva el dithering de imagenes\. +\fBToolbar\fR: Please take a look at the "Configuration via the Toolbar Menu" part of the TOOLBAR section\. .RE .sp .RS 4 \h'-04'\(bu\h'+03' -\fBOpaque Window Moving\fR: Si esta activado, se vera el contenido de la ventana mientras se la arrastra\. De otro modo se vera solo el borde durante el movimiento\. +\fBImage Dithering\fR: Enable or disable dithering of images\. .RE .sp .RS 4 \h'-04'\(bu\h'+03' -\fBFull Maximization\fR: Activando esta opcion actuara sobre las configuraciones por separado de la slit y la toolbar\. Las ventanas siempre se maximizaran por encima o por debajo de ellas\. +\fBOpaque Window Moving\fR: If enabled, you will see the window content while dragging it\. Otherwise the window will be shown as a "border"\. .RE .sp .RS 4 \h'-04'\(bu\h'+03' -\fBFocus New Window\fR: Si activado, cada nueva ventana que se abra aparecera enfocada\. +\fBFull Maximization\fR: Enabling this will override the separate settings for the slit/toolbar\. Windows will always maximize over/under both of them\. .RE .sp .RS 4 \h'-04'\(bu\h'+03' -\fBFocus Last Window on Workspace\fR: Enfoca la ultima ventana cuando se vuelve a un espacio de trabajo\. +\fBFocus New Window\fR: If enabled, a newly opened window will gain focus\. .RE .sp .RS 4 \h'-04'\(bu\h'+03' -\fBWorkspace warping\fR: Activar esta opcion permite arrastrar ventanas de un escritorio hacia otro\. +\fBFocus Last Window on Workspace\fR: This focuses the previous window when switching back to a workspace if the option is enabled\. .RE .sp .RS 4 \h'-04'\(bu\h'+03' -\fBDesktop MouseWhell Switching\fR: Con esta opción se puede cambiar de escritorio haciendo girar la rueda del mouse sobre la toolbar o sobre el fondo de escritorio\. +\fBWindows Warping\fR: If enabled, you can drag windows from one workspace to another\. .RE .sp .RS 4 \h'-04'\(bu\h'+03' -\fBDecorate transient windows\fR: Cuando se selecciona esta opción todas las ventanas temporales tienen borde y -\fIgrips\fR\. +\fBDecorate Transient Windows\fR: With this option enabled all temporary windows will have a border and grips\. .RE .sp .RS 4 \h'-04'\(bu\h'+03' -\fBClick Raises\fR: Cuando activada, un click en cualquier parte de la ventana (incluida la decoracion) la traera al frente\. De otro modo solamente se podra hacer con un click en la barra de titulo\. +\fBClick Raises\fR: If enabled a click anywhere on a window area (including the decorations) will raise it\. Otherwise you can only raise it by clicking the titlebar\. .RE .sp .RS 4 \h'-04'\(bu\h'+03' -\fBTransparency\fR: Permite configurar la transparencia para el menu y las ventanas enfocadas y desenfocadas\. +\fBTransparency\fR: This sets the transparency for a focused, unfocused window and the menu\. .RE -.SS "Menu Window" -Este menu es mostrado cuando se hace click derecho sobre la barra de titulo o el borde de una ventana\. Las opciones disponibles son: +.SS "Window Menu" +The Window menu is displayed when you right click on the titlebar of a window\. The options available are: .sp .sp .RS 4 \h'-04'\(bu\h'+03' -\fBSend To\&...\fR: Manda una ventana a otro escritorio\. Cuando se selecciona el escritorio con click del medio, Fluxbox nos enviara junto con la aplicacion al espacio seleccionado\. +\fBSend To\&...\fR: Send window to another workspace\. When you select the workspace with a middle click, fluxbox will send you along with the application to the selected workspace\. .RE .sp .RS 4 \h'-04'\(bu\h'+03' -\fBShade\fR: Hace un -\fIshade\fR -a la ventana (muestra solamente la barra de titulo)\. +\fBShade\fR: Shade the window (display the titlebar only)\. .RE .sp .RS 4 \h'-04'\(bu\h'+03' -\fBIconify\fR: Iconifica la ventana\. El -\fIicono\fR -puede encontrarse en el submenu Icons del menu workspace asi como en la toolbar (si se ha seleccionado un modo para la toolbar que muestre los iconos\. +\fBIconify\fR: Iconify window\. The `icon\' can be found in the Icons submenu of the workspace menu as well as in the toolbar (if a Toolbar mode showing Icons is selected)\. .RE .sp .RS 4 \h'-04'\(bu\h'+03' -\fBMaximize\fR: (Des)Maximiza la ventana\. Dependiendo de la configuracion de la toolbar y de la slit, la maximizacion puede cubrirlas\. Se pueden usar los diferentes botones del mouse para diferentes aspectos de la funcion Maximize\. -.sp -.RS 4 -\h'-04'\(bu\h'+03'Boton 1 (Des)Maximiza normalmente\. -.RE +\fBMaximize\fR: (Un)Maximize window\. Depending on your toolbar and slit configuration, maximize may cover them\. You can use the different mouse buttons for different aspects of maximize function\. .sp .RS 4 -\h'-04'\(bu\h'+03'Boton 2 (Des)Maximiza la ventana verticalmente\. +\h'-04'\(bu\h'+03'Button 1 (Un)Maximize as normal\. .RE .sp .RS 4 -\h'-04'\(bu\h'+03'Boton 3 (Des)Maximiza la ventana horizontalmente\. -.RE +\h'-04'\(bu\h'+03'Button 2 (Un)Maximize window vertically\. .RE .sp .RS 4 -\h'-04'\(bu\h'+03' -\fBRaise\fR: Trae la ventana al frente\. +\h'-04'\(bu\h'+03'Button 3 (Un)Maximize window horizontally\. .RE -.sp -.RS 4 -\h'-04'\(bu\h'+03' -\fBLower\fR: Envia la ventana al fondo\. .RE .sp .RS 4 \h'-04'\(bu\h'+03' -\fBStick\fR: (De)Stickea la ventana\. Una ventana stickeada es mostrada en todos los escritorios al mismo tiempo\. +\fBRaise\fR: Raise the window\. .RE .sp .RS 4 \h'-04'\(bu\h'+03' -\fBNext Client\fR: Activa el proximo cliente en este grupo de ventanas\. +\fBLower\fR: Lower the window\. .RE .sp .RS 4 \h'-04'\(bu\h'+03' -\fBPrev Client\fR: Activa el cliente anterior en este grupo de ventanas\. +\fBStick\fR: (Un)Stick window\. A `stuck\' window will always be displayed on all workspaces\. .RE .sp .RS 4 \h'-04'\(bu\h'+03' -\fBLayer\&...\fR: Cambia la capa de esta ventana\. +\fBLayer\&...\fR: Change the layer of this window\. .RE .sp .RS 4 \h'-04'\(bu\h'+03' -\fBRemember\&...\fR: Especifica que configuracion de ventana debe ser almacenada en el archivo apps, cubierto mas adelante en la seccion APLICACIONES\. +\fBRemember\&...\fR: Specify which window settings should be stored in the apps file, covered later on in the APPLICATIONS section\. .RE .sp .RS 4 \h'-04'\(bu\h'+03' -\fBClose\fR: Cierra la aplicacion\. +\fBClose\fR: Close the application softly\. .RE -.SS "Menu Workspace" -El menu Workspace puede encontrarse clickeando con el boton del medio en el fondo de escritorio\. Aparecera un menu dando la opcion de agregar o quitar un escritorio\. Tambien se veran los escritorios listados, un menu por debajo se veran los programas que estan ejecutandose en los respectivos espacios de trabajo\. Por ultimo pero no menos importante se vera el menu Icons que muestra las aplicaciones que han sido iconificadas\. +.SS "Workspace Menu" +The workspace menu can be found by middle clicking on the background\. A menu will popup giving you the option to add or remove a workspace\. You will also see your workspaces listed there; middle clicking on a workspace name will take you to that workspace, whereas clicking on a window name in one of the per\-workspace submenus will take you to the workspace that window is on, and select the window\. Last but not least you will notice the Icons menu\. This is for applications which have been `iconified\'\. .sp -.SS "Comportamiento de los menus" -Dicho comportamiento puede ser configurado en el archivo \fIinit\fR con las siguientes entradas (el valor por defecto para ambas es 0): +.SS "Menu Behavior" +The behavior of the submenus in a menu can be configured in the `init\' file, with the following entries (default for both is 0): .sp .sp .RS 4 @@ -432,134 +382,144 @@ session\.screen0\.menuDelay: session\.screen0\.menuDelayClose: .fi .RE -.SS "Sintaxis del Menu" -Existen hasta cuatro campos en una linea de menu\. Son de la forma: +.SS "Menu Syntax" +There are up to four fields in a menu line\. They are of the form: .sp .sp .RS 4 .nf -[tag] (nombre|etiqueta) {comando|nombre_del_archivo} +[tag] (label|filename) {command|filename} .fi .RE -Los tags reconocidos son: +The supported tags are: +.PP +[begin] (label) +.RS 4 +This tells fluxbox to start parsing the menu file\. This tag is required for fluxbox to read your menu file\. If it cannot find it, the system default menu is used in its place\. +.RE .PP -[begin] (etiqueta) +[config] (label) .RS 4 -Le indica a fluxbox donde inicia a analizar el menu\. Este tag es requerido para que Fluxbox lea el archivo de menu\. Si no lo puede encontrar sera usado el menu por defecto\. +Inserts a fluxbox native submenu item, containing numerous configuration options concerning window placement, focus style, window moving style, etc\. .RE .PP [end] .RS 4 -Le dice a Fluxbox que es el final de un menu\. Puede ser tanto un submenu como el Menu root\. Debe haber por lo menos uno de estos tags que se corresponda con el tag requerido [begin]\. +This tells fluxbox that it is at the end of a menu\. This can either be a submenu or the main root menu\. There must be at least one of these tags in your menu to correspond to the required [begin] tag\. .RE .PP +[exec] (label) {command} .RS 4 -Inserta un comando en el menu\. Cuando se selecciona este item en el menu Fluxbox ejecuta el comando\. +Inserts a command item into the menu\. When you select the menu item from the menu, fluxbox runs +\fIcommand\fR\. .RE .PP -[exit] (etiqueta) +[exit] (label) .RS 4 -Inserta un item que sale de Fluxbox\. Cualquier ventana abierta es redireccionada a la ventana root y se cierra\. +Inserts an item that shuts down and exits fluxbox\. Any open windows are reparented to the root window before fluxbox exits\. .RE .PP -[include] (nombre\-de\-archivo\-o\-directorio) +[include] (file\-or\-directory\-name) .RS 4 -Analiza el archivo especificado por nombre en linea con el menu actual\. El nombre puede ser la ruta completa al archivo, o puede empezar con ~/, el cual sera buscado en el directorio home del usuario\. Si la ruta es un directorio entonces todos los archivos que contenga seran incluidos\. +Parses the file specified by filename inline with the current menu\. The filename can be the full path to a file or it can begin with ~/, which will be expanded into your home directory\. If the path is a directory, then all files in the directory are included\. .RE .PP -[nop] (etiqueta) +[nop] (label) .RS 4 -Inserta un item no operacional en el menu actual\. Esto puede ser usado para ayudar a dar formato al menu dividiendolo en bloques o secciones si asi se desea\. Este tag soporta una etiqueta pero no es necesaria, en tal caso se obtendra un item en blanco\. +Insert a non\-operational item into the current menu\. This can be used to help format the menu into blocks or sections if so desired\. This tag does support a label, but one is not required in which case a blank item will be used instead\. .RE .PP [separator] .RS 4 -Esto creara una bonita linea de separacion\. Util para dividir secciones de una manera vistosa\. +This will create a nice separation line\. Useful for splitting up sections in a +\fIpretty\fR +way\. .RE .PP -[style] (etiqueta) {nombre_de_archivo} +[style] (label) {filename} .RS 4 -Le dice a Fluxbox que inserte un item que, cuando seleccionado, lee el estilo nombrado en nombre_de_archivo y aplica las nuevas texturas, colores y fuentes a la sesion ejecutandose actualmente\. +This tells fluxbox to insert an item that, when selected, reads style file named filename and apply the new textures, colors and fonts to the current running session\. .RE .PP -[stylesmenu] (directorio) +[stylesmenu] (directory) .RS 4 -Lee todos los nombres de archivo dentro del directorio especificado, asumiendo que todos son archivos de estilo validos, y crea items del menu dentro del menu actual para cada archivo, que, cuando seleccionados por el usuario aplicaran el estilo elegido a la sesion actual\. Las etiquetas que son creadas en el menu son los nombres de los archivos de estilos\. +Reads all filenames from the specified directory, assuming that they are all valid style files, and creates menu items in the current menu for every filename, that, when selected by the user will apply the selected style file to the current session\. The labels that are created in the menu are the filenames of the style files\. .RE .PP -[stylesdir] (etiquteta) {titulo_del_menu} +[stylesdir] (label) {directory} .RS 4 -Crea un entrada de submenu con etiqueta (que es tambien el titulo del nuevo submenu), e inserta en ese submenu todos los nombres de archivo en el directorio especificado, asumiendo que todos son archivos validos de estilo (los directorios son ignorados) en la misma manera que el comando [stylesmenu]\. Tanto [stylesdir] como [stylesmenu] hacen posible instalar estilos sin editar el archivo init\. +Creates a submenu entry with label (that is also the title of the new submenu), and inserts in that submenu all filenames in the specified directory, assuming that they are all valid style files (directories are ignored) in the same way as the [stylesdir] command does\. Both [stylesdir] and [stylesmenu] commands make it possible to install style files without editing your init file\. .RE .PP -[submenu] (etiqueta) {titulo_de_menu} +[submenu] (label) {menutitle} .RS 4 -Este comando le dice a Fluxbox que cree y analice un nuevo menu\. Este menu es insertado como submenu dentro de menu principal\. Estos menus son analizados recursivamente, de modo que no hay limite para el numero de niveles o submenus anidados que se puedan tener\. El titulo del nuevo menu es opcional, si no se especifica ninguno el titulo del menu sera el mismo que el de la etiqueta\. Es requerido el tag [end] para finalizar el submenu\. +This tells fluxbox to create and parse a new menu\. This menu is inserted as a submenu into the parent menu\. These menus are parsed recursively, so there is no limit to the number of levels or nested submenus you can have\. The title for the new menu is optional, if none is supplied, the new menu\'s title is the same as the item label\. An [end] tag is required to end the submenu\. .RE .PP [reconfig] (label) .RS 4 -Cuando seleccionado este item relee el estilo actual y el archivo de menu y aplica cualquier cambio\. Es util para crear un nuevo tema o estilo sin que haya que reiniciar fluxbox cada vez que guardamos algun cambio\. Sin embargo Fluxbox relee el menu automaticamente cada vez que cambia\. +When selected this item re\-reads the current style and menu files and applies any changes\. This is useful for creating a new style or theme, as you don\'t have to constantly restart fluxbox every time you save your style\. However, fluxbox automatically rereads the menu whenever it changes\. .RE .PP -[restart] (etiqueta) {comando} +[restart] (label) {command} .RS 4 -Le dice a Fluxbox que reinicie\. Si se provee un comando sale y ejecuta el comando (el cual es habitualmente el nombre de otro window manager)\. Si el comando es omitido Fluxbox se reinicia a si mismo\. +This tells fluxbox to restart\. If command is supplied, it shuts down and runs the command (which is commonly the name of another window manager)\. If the command is omitted, fluxbox restarts itself\. .RE .PP -[config] (label) +[wallpapers] (directory) {command} .RS 4 -Inserta submenu Fluxbox nativo, conteniendo numerosas opciones de configuracion relacionadas a la localizacion de ventanas, estilo de foco, estilo de movimiento de ventana, etc\. +This inserts a menu item to set the wallpaper for each file in the given directory\. The command is optional and defaults to fbsetbg\. .RE .PP -[wallpapers] (etiqueta) +[workspaces] (label) .RS 4 -Este item nos permite enlistar nuestros fondos de pantalla\. Esta hecho para trabajar junto con fbsetbg(1) y permite con un simple click en una imagen cambiar de fondo\. Se nota? Fluxbox lo hace facil\&... +This tells fluxbox to insert a link to the workspaces menu directly into your menu\. This is handy for those users who can\'t access the workspace menu directly (e\.g\. if you don\'t have a 3 button mouse, it is rather hard to middle click to show the workspace menu)\. .RE .PP -[workspaces] (etiqueta) -.RS 4 -Le dice a Fluxbox que inserte un enlace al menu workspaces directamente a nuestro menu\. Particularmente util para los usuarios que no pueden acceder a dicho menu directamente (por ej\.: si no se tiene un mouse de tres botones es bastante dificil clickear con el boton del medio para que nos lo muestre)\. -.RE -Cualquier linea que empiece con un \fI#\fR o \fI!\fR es considerada un comentario e ignorada por Fluxbox\. Tambien, en los campos etiqueta/comando/nombre_de_archivo se puede usar cualquier caracter\. Usando \fI\e\fR se inserta una barra invertida literal en los campos etiqueta/comando/nombre_de_archivo\. -.sp -.sp -.RS 4 -.nf - Menu Ejemplo - # menu de Fluxbox - [begin] (Fluxbox) - [exec] (rxvt) {rxvt \-ls} - [exec] (netscape) {netscape \-install} - [exec] (The GIMP) {gimp} - [exec] (XV) {xv} - [exec] (Vim) {rxvt \-geometry 132x60 \-name VIM \-e screen vim} - [exec] (Mutt) {rxvt \-name mutt \-e mutt} - [submenu] (mozilla) - [exec] (navegador) {mozilla \-browser} - [exec] (noticias) {mozilla \-news} - [exec] (correo) {mozilla \-mail} - [exec] (edit) {mozilla \-edit} - [exec] (compose) {mozilla \-compose} - [end] - [submenu] (Window Manager) - [exec] (Editar Menus) {nedit ~/\.fluxbox/menu} - [submenu] (Estilo) {Que estilo?} - [stylesdir] (~/\.fluxbox/styles) - [stylesmenu] (Fluxbox Styles) {@pkgdatadir@/styles} - [end] - [config] (Opciones de configuracion) - [reconfig] (Reconfigurar) - [restart] (Reiniciar) - [end] - [exit] (Salir) - [end] +[\fIcommand\fR] (label) +.RS 4 +In addition to the commands above, any legal key command may be used as a menu item\. See fluxbox\-keys(5) for more information\. +.RE +Any line that starts with a \fI#\fR or \fI!\fR is considered a comment and ignored by fluxbox\. Also, in the label/command/filename fields you can escape any character\. Using \fI\e\e\fR inserts a literal back\-slash into the label/command/filename field\. +.sp +Here is an example menu file: +.sp +.sp +.RS 4 +.nf +# fluxbox menu file +[begin] (fluxbox) + [exec] (rxvt) {rxvt \-ls} + [exec] (netscape) {netscape \-install} + [exec] (The GIMP) {gimp} + [exec] (XV) {xv} + [exec] (Vim) {rxvt \-geometry 132x60 \-name VIM \-e screen vim} + [exec] (Mutt) {rxvt \-name mutt \-e mutt} + [submenu] (mozilla) + [exec] (browser) {mozilla \-browser} + [exec] (news) {mozilla \-news} + [exec] (mail) {mozilla \-mail} + [exec] (edit) {mozilla \-edit} + [exec] (compose) {mozilla \-compose} + [end] + [submenu] (Window Manager) + [exec] (Edit Menus) {nedit ~/\.fluxbox/menu} + [submenu] (Style) {Which Style?} + [stylesdir] (~/\.fluxbox/styles) + [stylesmenu] (fluxbox Styles) {@pkgdatadir@/styles} + [end] + [config] (Config Options) + [reconfig] (Reconfigure) + [restart] (Restart) + [end] + [exit] (Log Out) +[end] .fi .RE .SH "TOOLBAR" -La toolbar (barra de tareas) es un area donde Fluxbox muestra informacion, como un reloj, el identificador de workspaces (espacios de trabajo o escritorios), una systemtray (bandeja del sistema) u una taskbar (llamada iconbar) que puede contener los programas en ejecucion\. El color, aspecto, fuente, etc, son definidos en el estilo y no pueden ser definidos como configuraciones globales\. +The toolbar is a small area to display information like a clock, workspace name, a system tray or a taskbar (iconbar) that can contain the running programs\. The color, look, font etc\. is defined in the style and can\'t be defined as a global setting (except with the style overlay)\. .sp -Las partes de la toolbar pueden ser activadas o desactivadas en el archivo \fIinit\fR con los argumentos definidos a continuacion: +The tools in the toolbar can be enabled/disabled in the init file with the arguments given to the line: .sp .sp .RS 4 @@ -567,7 +527,7 @@ Las partes de la toolbar pueden ser activadas o desactivadas en el archivo \fIin session\.screen0\.toolbar\.tools .fi .RE -El orden y la cantidad de herramientas son libremente seleccionables y deben estar separadas por comas\.Ej\.: +The order and number of tools is freely selectable, but they must be separated by a ","\. E\.g\.: .sp .sp .RS 4 @@ -575,72 +535,72 @@ El orden y la cantidad de herramientas son libremente seleccionables y deben est session\.screen0\.toolbar\.tools: workspacename, systemtray, iconbar, clock .fi .RE -las posibles partes o herramientas de la toolbar son: +The possible tools are: .sp .sp .RS 4 \h'-04'\(bu\h'+03' -\fBClock\fR: Mostrara el area donde apareceran de acuerdo a la especificacion del formato listado en "man strftime"\. +\fBClock\fR: This will show an area to display a clock and the date according to the format specification listed in "man strtftime" .RE .sp .RS 4 \h'-04'\(bu\h'+03' -\fBIconbar\fR: Esta es el area que contiene todas las ventanas (todas las aplicaciones en ejecucion, todas las ventanas minimizadas o tal vez ninguna ventana, todo dependiendo de la configuracion de la toolbar\. +\fBIconbar\fR: This is the area that contains all windows (all running applications, all minimized windows or maybe no window, all depending on the Toolbar Settings)\. .RE .sp .RS 4 \h'-04'\(bu\h'+03' -\fBSystemtray\fR: La Systemtray (bandeja del sistema) puede contener aplicaciones que estan hechas para correr sobre ella\. +\fBSystemtray\fR: The Systemtray can hold applications that are made to use it\. .RE .sp .RS 4 \h'-04'\(bu\h'+03' -\fBWorkspaceName\fR: Muestra el nombre del espacio de trabajo actual\. +\fBWorkspaceName\fR: This displays the name of the current workspace\. .RE .sp .RS 4 \h'-04'\(bu\h'+03' -\fBPrevWorkspace\fR: Muestra una flecha que permite cambiar al Workspace siguiente que se encuentra a la izquierda del actual\. Lo mismo que MouseWheelDown con "Desktop MouseWheel Switching" activado\. +\fBPrevWorkspace\fR: This displays an arrow that allows to switch to the workspace left of the current one\. .RE .sp .RS 4 \h'-04'\(bu\h'+03' -\fBNextWorkspace\fR: Muestra una flecha que permite cambiar al siguiente Workspace a la derecha del actual\. Lo mismo que MouseWheelUp con "Desktop MouseWheel Switching" activado\. +\fBNextWorkspace\fR: This displays an arrow that allows to switch to the workspace right of the current one\. .RE .sp .RS 4 \h'-04'\(bu\h'+03' -\fBPrevWindow\fR: Muestra una flecha que permite enfocar la ventana visible anterior en el workspace actual\. +\fBPrevWindow\fR: This displays an arrow that switches focus to the previous visible window on the current workspace\. .RE .sp .RS 4 \h'-04'\(bu\h'+03' -\fBNextWindow\fR: Muestra una flecha que permite enfocar la ventana visible posterior en el workspace actual\. +\fBNextWindow\fR: This displays an arrow that switches focus to the next visible window on the current workspace\. .RE -La Toolbar puede ser configurada de dos maneras\. Tanto a traves de el Menu de configuracion de la misma, el cual es accesible desde el Menu de Configuracion en el Root\-Menu o con click derecho sobre Nombre de Workspace/Flechas/Reloj en la toolbar, o editando el archivo Init a mano (Observar la seccion RESOURCES para mas informacion sobre como hacerlo\. +Other aspects of the toolbar can be configured in two ways: through the toolbar menu, which is accessable in the Configuration part of the RootMenu or with a right click on the edge the toolbar, or by editing the init file (see the RESOURCES section for more information about that)\. .sp -.SS "Configuracion a traves del menu de la Barra de Herramientas\." -Todos los cambios tienen efecto mientras trabajas y puedes notarlo de inmediato, exceptuando cambios en el "Alpha de la barra de herramientas" (toolbar Alpha) , que necesita que se reinicie fluxbox para que los cambios tengan efecto\. +.SS "Configuration via the Toolbar Menu" +All changes take effect immediately, except for a change of the "Toolbar Alpha", which needs a restart to make the change visible\. Here are the settings: .sp .sp .RS 4 \h'-04'\(bu\h'+03' -\fBVisible\fR: Setea la barra de herramientas en modo visible o invisible (bueno, esto deberia ser mas que obvio ;) ) +\fBVisible\fR: Sets the toolbar either to visible or invisible\. .sp .RS 4 .nf -session\.screen0\.toolbar\.visible: +session\.screen0\.toolbar\.visible: .fi .RE .RE .sp .RS 4 \h'-04'\(bu\h'+03' -\fBAuto hide\fR: Si esta variable es seteada la barra de herramientas va a desaparecer despues de un tiempo definido cuando el puntero del mouse salga del area de la barra de herramientas\. La barra va a aparecer cuando el mouse entre en la zona restante de los bordes de la barra de herramientas\. El tiempo de espera puede ser seteado en init\. +\fBAuto hide\fR: If this is enabled the toolbar will disappear after a defined time when the mouse pointer leaves the toolbar\. It will slide in when the cursor hits the remaining edge of the toolbar\. .sp .RS 4 .nf -session\.screen0\.toolbar\.autoHide: +session\.screen0\.toolbar\.autoHide: session\.autoRaiseDelay: .fi .RE @@ -648,7 +608,7 @@ session\.autoRaiseDelay: .sp .RS 4 \h'-04'\(bu\h'+03' -\fBToolbar width percentage\fR: Setea el ancho de la barra de herramienta en forma de porcentaje\. Use el boton izquierdo del mouse para disminuir y el boton derecho para incrementar el valor\. El valor puede variar entre 0 y 100\. +\fBToolbar width percentage\fR: Sets the width of the toolbar in percent\. Use the left mouse button to decrease and the right mouse\-button to increase the value\. The value can be from 1\-100\. .sp .RS 4 .nf @@ -659,1389 +619,930 @@ session\.screen0\.toolbar\.widthPercent: .sp .RS 4 \h'-04'\(bu\h'+03' -\fBMaximize Over\fR: Esta opcion permitira a las ventanas ser maximizadas sobre la barra de herramientas\. Con esta opcion deshabilitada solo se "dockearan" en el borde de la barra\. Para usar esta opcion, la opcion de "Full Maximization" de la configuracion de fluxbox menu debera estar deshabilitada, de otra manera esta opcion "Maximize over" no funcionara\. +\fBMaximize Over\fR: Enabling this option will prevent windows from maximizing over the toolbar\. With this switched on they will only expand to the edge of the bar\. To use this option, "Full Maximization" from the Configuration menu must be DISABLED\. Otherwise this option will not work\. .sp .RS 4 .nf -session\.screen0\.toolbar\.maxOver: -session\.screen0\.fullMaximization: +session\.screen0\.toolbar\.maxOver: +session\.screen0\.fullMaximization: .fi .RE .RE -\-\fBLayer\&...\fR: Esta opcion configura la capa donde la barra de herramientas es seteada\. Con esta misma uno puede configurar la barra de herramientas para que este siempre arriba de todo con "Always on top" .sp +.RS 4 +\h'-04'\(bu\h'+03' +\fBLayer\&...\fR: This sets the layer on which the toolbar is set\. With this you can set the toolbar to "Always on top"\. .sp .RS 4 .nf session\.screen0\.toolbar\.layer: .fi .RE -\-\fBPlacement\fR: Configura el lugar donde la barra de herramientas se encontrara, arriba, abajo, con una alineacion de derecha, izquierda o en el centro\. +.RE .sp +.RS 4 +\h'-04'\(bu\h'+03' +\fBPlacement\fR: Sets the toolbar to any edge of the screen, either centered or aligned with a corner\. .sp .RS 4 .nf -session\.screen0\.toolbar\.alpha: +session\.screen0\.toolbar\.placement: .fi .RE -\-\fBAlpha\fR: Esta opcion configura el valor alpha (transparencia) para la barra de herramientas\. Use el boton izquierdo del mouse para disminuir y el derecho para incrementar el valor\. 0 es invisible y 255 es sin ninguna transparencia (color solido)\. +.RE .sp +.RS 4 +\h'-04'\(bu\h'+03' +\fBAlpha\fR: This sets the alpha value for the toolbar\. Use the left mouse button to decrease and the right mouse button to increase the value\. 0 is invisible, 255 is not transparent at all\. .sp .RS 4 .nf session\.screen0\.toolbar\.alpha: .fi .RE -\-\fBIconbar Mode\fR: +.RE .sp +.RS 4 +\h'-04'\(bu\h'+03' +\fBIconbar Mode\fR: .sp .RS 4 .nf -Especifica el modo de la barra de iconos "iconbar": +Specifies the mode of the iconbar: .fi .RE +.RE .sp .RS 4 -.nf -\-None: - No mostrara ninguna ventana -\-Icons: - Solo mostrara las ventanas de todos los escritorios que estan minimizadas\. -\-NoIcons: - Solo mostrara las ventanas de todos los escritorios que no estan minimizadas\. -\-WorkspaceIcons: - Solo mostrara las ventanas del escritorio en donde se encuentra que esten - minimizadas\. -\-WorkspaceNoIcons: - Solo mostrara las ventanas del escritorio en donde se encuentra que no esten - minimizadas\. -\-Workspace: - Mostrara todas las ventanas del escritorio en donde se encuentra\. -\-All WIndows: - Mostrara todas las ventanas de todos los escritorios\. -.fi +\h'-04'\(bu\h'+03' +\fBNone\fR: will not show any windows .RE .sp .RS 4 -.nf -session\.screen0\.iconbar\.mode: -.fi +\h'-04'\(bu\h'+03' +\fBIcons\fR: shows windows from all workspaces that are minimized (iconified) .RE -\-\fBAlignment\fR: -.sp .sp .RS 4 -.nf -\-Left: - Todos los iconos y ventanas seran alineados segun el ancho seteado en init\. -\-Relative: - Todos los iconos y ventanas seran arreglados para que la barra de iconos - siempre este completa\. -\-Right: - Todos los iconos y ventanas seran alineados segun el ancho seteado en init\. -.fi +\h'-04'\(bu\h'+03' +\fBNoIcons\fR: shows windows from all workspaces that are not minimized (iconified) .RE .sp .RS 4 -.nf -session\.screen0\.iconbar\.aligment: -session\.screen0\.iconbar\.iconWidth: -.fi +\h'-04'\(bu\h'+03' +\fBWorkspaceIcons\fR: shows windows from the current workspace that are minimized (iconified) .RE -\-\fBShow Pictures\fR: Si esta variable esta habilitada la barra de iconos mostrara los iconos de las aplicaciones , si esta posee alguno\. -.sp .sp .RS 4 -.nf -session\.screen0\.iconbar\.usePixmap: -.fi +\h'-04'\(bu\h'+03' +\fBWorkspaceNoIcons\fR: shows windows from the current workspace that are not minimized (iconified) .RE -\-\fBClock\fR: Deja que cambies el estilo de la hora entre 00:00am \- 12:00pm y 00:00\-24:00\. -.sp -\-\fBEdit Clock Format\fR: Clickeando esta opcion abrira una pequenia ventana en la cual el el formato de hora podra ser modificado de acuerdo a \fIman strftime\fR\. -.sp .sp .RS 4 -.nf -session\.screen0\.strftimeFormat: -.fi +\h'-04'\(bu\h'+03' +\fBWorkspace\fR: shows all windows from the current workspace .RE -.SS "RESOURCES" -Usualmente el archivo de resource ~/\.fluxbox/init es creado y mantenido por Fluxbox\. Uno puede usar el menu [config] para setear la mayoria de estas opciones\. Sin embargo, nosotros vamos a contemplar todas las opciones disponibles de resource para el usuario\. Si editas este archivo mientras estas corriendo Fluxbox, deberas reiniciar el mismo para que carguen las opciones de resource\. -.sp -Cuando estamos corriendo Fluxbox en un ambiente de multiples escritorios la screen0 puede ser tambien screen1, screenN, etc\. Uno puede customizar el comportamiento de Fluxbox en cada uno de los escritorios\. A continuacion damos un ejemplo favorito de Fluxbox documentation manager: .sp +.RS 4 +\h'-04'\(bu\h'+03' +\fBAll Windows\fR: shows all windows from all workspaces .sp .RS 4 .nf - session\.screen0\.toolbar\.onTop: False - session\.screen0\.toolbar\.autoHide: True - session\.screen0\.toolbar\.placement: BottomCenter - session\.screen0\.toolbar\.widthPercent: 42 - session\.screen0\.slit\.onTop: False - session\.screen0\.slit\.autoHide: True - session\.screen0\.slit\.placement: TopLeft - session\.screen0\.slit\.direction: Vertical - session\.screen0\.strftimeFormat: %I:%M %p - session\.screen1\.toolbar\.onTop: True - session\.screen1\.slit\.autoHide: False - session\.screen1\.slit\.placement: CenterRight - session\.screen1\.slit\.direction: Vertical - session\.screen1\.strftimeFormat: %a %d %R [%s] +session\.screen0\.iconbar\.mode: .fi .RE -Aqui estan los resources que estan actualmente disponibles: -.sp +.RE .sp .RS 4 -.nf -session\.screen0\.menu\.alpha: -session\.screen0\.slit\.alpha: -session\.screen0\.toolbar\.alpha: -session\.screen0\.window\.focus\.alpha: -session\.screen0\.window\.unfocus\.alpha: - Estos resources estan disponibles para que el usuario pueda configurar -diferentes niveles de transparencia para diferentes componentes -de Fluxbox\. Cada uno acepta un valor entre 0\-255 siendo 255 el -mas opaco y 0 completamente transparente\. El default es 255\. -.fi +\h'-04'\(bu\h'+03' +\fBAlignment\fR: .RE .sp .RS 4 -.nf -session\.screen0\.slit\.autoHide: -session\.screen0\.toolbar\.autoHide: - El resource autoHide permite al usuario que configure el comportamiento -de la barra de herramientas y el slit\. Este comportamiento puede ser -que estos desaparezcan cuando estos no estan siendo activamente usados -por el usuario, o que permanezcan visibles todo el tiempo\. Default -.fi +\h'-04'\(bu\h'+03' +\fBLeft\fR: all icons will be left\-aligned with the width set in the init file .RE .sp .RS 4 -.nf -session\.screen0\.desktopwheeling: -session\.screen0\.toolbar\.wheeling: -Esto marca la posibilidad de utlizar el scroll del mouse del usuario\. -Configurando estos valores a \'\' (true o false) permite que el usuario -pueda literalmente navegar entre escritorios o aplicaciones en la barra de -herramientas\. Default: -.fi +\h'-04'\(bu\h'+03' +\fBRelative\fR: all icons will be sized evenly to fill the iconbar completely .RE .sp .RS 4 -.nf -session\.screen0\.slit\.layer: -session\.screen0\.toolbar\.layer: -session\.screen0\.toolbar\.onTop: -Un usuario puede configurar si la barra de herramientas o el slit -siempre estan en el frente de la pantalla\. Configurando estos -resources va a llevar a la barra de herramientas y el slit por -encima de todas las otras ventanas\. Por defecto: False +session\.screen0\.iconbar\.alignment: +session\.screen0\.iconbar\.iconWidth: .fi .RE +.RE .sp .RS 4 -.nf -session\.screen0\.slit\.placement: -session\.screen0\.toolbar\.placement: -Esto permite al usuario poner el split y la barra de herramientas -donde el usuario desee\. Las opciones disponibles son: - \- BottomCenter - \- BottomLeft - \- BottomRight - \- LeftCenter - \- RightCenter - \- TopCenter - \- TopLeft -.fi -.RE +\h'-04'\(bu\h'+03' +\fBShow Pictures\fR: If enabled the iconbar will show the application\'s icon (if provided by the application) .sp .RS 4 .nf -session\.screen0\.slit\.maxOver: -session\.screen0\.toolbar\.maxOver: - Seteando estas a \'\' permitira la ventana de aplicacion -maximizarse completamente\. configurando estas a \'\' permitira -a la slit y la barra de herramientas conservar sus correspondientes -territorios y siempre seran visibles cuando una aplicacion sea -maximizada\. El default es: +session\.screen0\.iconbar\.usePixmap: .fi .RE +.RE .sp .RS 4 -.nf -session\.screen0\.toolbar\.height: -Setea la altura de la barra de herramientas\. Default: 0 - Si el valor es seteado a 0, el archivo de estilo