From 228c70186157d7184c235f38a72c4a4d9ce77164 Mon Sep 17 00:00:00 2001 From: Marco Peereboom Date: Fri, 2 Oct 2009 17:57:44 +0000 Subject: [PATCH] Add spanish translated scrotwm man. Use man scrotwm_es to use it. --- Makefile | 2 +- scrotwm_es.1 | 550 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ 2 files changed, 551 insertions(+), 1 deletion(-) create mode 100644 scrotwm_es.1 diff --git a/Makefile b/Makefile index 9e432cc..d7ed18f 100644 --- a/Makefile +++ b/Makefile @@ -4,7 +4,7 @@ SUBDIR= lib PROG=scrotwm -MAN=scrotwm.1 +MAN=scrotwm.1 scrotwm_es.1 CFLAGS+=-std=c89 -Wall -Wno-uninitialized -ggdb3 CPPFLAGS+= -I${X11BASE}/include diff --git a/scrotwm_es.1 b/scrotwm_es.1 new file mode 100644 index 0000000..f7369a6 --- /dev/null +++ b/scrotwm_es.1 @@ -0,0 +1,550 @@ +.\" $scrotwm$ +.\" +.\" Copyright (c) 2009 Marco Peereboom +.\" Copyright (c) 2009 Darrin Chandler +.\" +.\" Permission to use, copy, modify, and distribute this software for any +.\" purpose with or without fee is hereby granted, provided that the above +.\" copyright notice and this permission notice appear in all copies. +.\" +.\" THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES +.\" WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF +.\" MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR +.\" ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES +.\" WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN +.\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF +.\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. +.\" +.Dd $Mdocdate$ +.Dt SCROTWM 1 +.Os +.Sh NOMBRE +.Nm scrotwm +.Nd es un manejador de ventanas para X11 +.Sh SYNOPSIS +.Nm scrotwm +.Sh DESCRIPCIÓN +.Nm +es un manejador de ventanas super minimalista para X11. Intenta no superponer +las ventanas para que las mismas puedan usarse de manera eficiente y para cosas mas importantes. +Tiene configuraciones normales y no requiere que sepas un lenguaje de +programacion para configurarlo. Esta escrito por hackers para hackers y apunta +a ser pequeño, compacto y rápido. +.Pp +Cuando +.Nm +inicia, lo primero que hace es leer el archivo de configuracion, +.Pa scrotwm.conf . +Ver +.Sx ARCHIVOS DE CONFIGURACIÓN +. +.Pp +La siguiente anotacion se usa a través de esta pagina: +.Pp +.Bl -tag -width Ds -offset indent -compact +.It Cm M +Meta +.It Cm S +Shift +.It Aq Cm Name +Nombre de tecla +.It Cm M1 +Boton 1 del mouse +.It Cm M3 +Boton 3 del mouse +.El +.Pp +.Nm +es muy simple de usar. +La mayoria de las acciones se hacen con los mapeos (bindings) de mouse +o teclado. +Ver la sección de +.Sx BINDINGS +para las personalizaciones y configuraciones por defecto. +.Sh ARCHIVOS DE CONFIGURACIÓN +.Nm +primero trata de abrir el archivo por defecto en el directorio del usuario, +.Pa ~/.scrotwm.conf . +Si ese archivo no esta disponible, +luego trata de abrir el archivo global de configuracion +.Pa /etc/scrotwm.conf . +.Pp +El formato del archivo es \*(Lttecla\*(Gt = \*(Ltconfiguracion\*(Gt. +Por ejemplo: +.Pp +.Dl color_focus = red +.Pp +Habilitamos o deshabilitamos la opción usando 1 o 0 respectivamente. +.Pp +El archivo soporta las siguientes palabras clave: +.Pp +.Bl -tag -width "title_class_enabledXXX" -offset indent -compact +.It Cm color_focus +Color del borde de la ventana en foco. +.It Cm color_unfocus +Color del borde de la ventana fuera de foco. +.It Cm bar_enabled +Habilitar o deshabilitar la barra de estado. +.It Cm bar_border Ns Bq Ar x +Color del borde de la barra de estado en pantalla. +.Ar x . +.It Cm bar_color Ns Bq Ar x +Color de la ventana de la barra de estado en pantalla. +.Ar x . +.It Cm bar_font_color Ns Bq Ar x +Color de la fuente en la barra de estado en pantalla. +.Ar x . +.It Cm bar_font +Fuente de la barra de estado. +.It Cm bar_action +Scripts externos con populares agregados de información para la barra +de estado, como la vida de la bateria. +.It Cm bar_delay +Frecuencia de actualización, en segundos, de los scripts de la barra de +estado. +.It Cm clock_enabled +Habilitar o deshabilitar el reloj en la barra de estado, deshabilitado +por defecto con un 0, para usar el reloj de la barra de estado +(bar_action) +.It Cm dialog_ratio +Algunas aplicaciones tienen ventanas de dialogo muy pequeñas como para +ser usables. Este relación (ratio) es el tamaño de la pantalla, por +ejemplo 0.6 es 60% del tamaño físico de la pantalla. +.It Cm region +Acomodar una region personalizada, removiendo cualquier autodeteción de +regiones que ocupe el espacio en la pantalla. +Definiendo el formato screen[]:WIDTHxHEIGHT+X+Y, +e.g.\& screen[1]:800x1200+0+0. +.It Cm term_width +Setear un ancho minimo preferido para la terminal. +Si el valor es mayor que 0, +.Nm +intentará ajustar el tamaño de la fuente de la terminal para mantener +el ancho de la terminal por encima de este número cuando la ventana +cambia de tamaño. +Actualmente solo es soportado por +.Xr xterm 1 +El binario de +.Xr xterm 1 +no debe ser un setuid o setgid, que no sea el que viene por defecto en +la mayoria de los sistemas. +Los usuarios pueden necesitar setear program[term] (ver la sección +.Sx PROGRAMAS +) para usar una copia alternativa del binario de +.Xr xterm 1 +sin el seteo del setgid. +.It Cm title_class_enabled +Habilitar o deshabilitar la clase de ventana en la barre de estado. +Habilitado seteando 1 +.It Cm title_name_enabled +Habilitar o deshabilita el titulo de la ventana en la barra de estado. +Habilitado seteando 1 +.It Cm modkey +Cambiar mod key. +Mod1 generalmente es la tecla ALT y Mod4 la tecla de windows en una PC. +.It Cm program Ns Bq Ar p +Definir una nueva accion para ejecutar un programa. +.Ar p . +Ver la sección de +.Sx PROGRAMAS +.It Cm bind Ns Bq Ar x +Combinación de teclas para una acción +.Ar x . +Ver la sección +.Sx BINDINGS +.It Cm quirk Ns Bq Ar c:n +Agregar un "quirk" (o forzados) para ventanas con clase +.Ar c +y nombre +.Ar n . +Ver la sección +.Sx QUIRKS +.El +.Pp +Los colores deben ser especificados por la especificación +.Xr XQueryColor 3 +y las fuentes por la especificación +.Xr XQueryFont 3 +.Sh PROGRAMAS +.Nm +te permite definir acciones personales para lanzar los programas que +quieras y luego obligar a la misma con una función de acciones. +Ver la sección +.Sx BINDINGS +.Pp +Los programas por defecto se describen acá: +.Pp +.Bl -tag -width "screenshot_wind" -offset indent -compact +.It Cm term +xterm +.It Cm screenshot_all +screenshot.sh completo +.It Cm screenshot_wind +screenshot.sh por ventana +.It Cm lock +xlock +.It Cm initscr +initscreen.sh +.It Cm menu +dmenu_run -fn $bar_font -nb $bar_color -nf $bar_font_color -sb $bar_border -sf $bar_color +.El +.Pp +Los programas en la configuración personal, se especifican aca: +.Pp +.Dl program[] = [ [... ]] +.Pp +.Aq nombre +es un identificador, no genera conflictos con ninguna accion o palabra +clave, +.Aq progpath +es la ruta al programa, y +.Aq arg +es ninguno o mas de un argumento para el programa. +.Pp +Las siguientes variables de configuracion en +.Nm +(ver +.Sx ARCHIVOS DE CONFIGURACIÓN +), +y pueden ser usadas en los campos de +.Aq arg +como asi tambien sustituidas por valores al momento del inicio de un +programa: +.Pp +.Bl -tag -width "$bar_font_color" -offset indent -compact +.It Cm $bar_border +.It Cm $bar_color +.It Cm $bar_font +.It Cm $bar_font_color +.It Cm $color_focus +.It Cm $color_unfocus +.El +.Pp +Ejemplo: +.Bd -literal -offset indent +program[ff] = /usr/local/bin/firefox http://scrotwm.com.ar/ +bind[ff] = Mod+f # Ahora Mod+F inicia firefox +.Ed +.Pp +Para deshacer lo anterior: +.Bd -literal -offset indent +bind[] = Mod+f +program[ff] = +.Ed +.Pp +.Sh BINDINGS +.Nm +provee muchas funciones (o acciones) accesibles por medio de la +asignación (bindings) de teclas o el mouse. +.Pp +Las corrientes asignaciones (bindings) del mouse son: +.Pp +.Bl -tag -width "M-j, M-XXX" -offset indent -compact +.It Cm M1 +Enfoco una ventana +.It Cm M-M1 +Muevo una ventana +.It Cm M-M3 +Redimenciono una ventana +.It Cm M-S-M3 +Redimenciono una ventana hasta que quede centrada +.El +.Pp +Las corrientes asignaciones (bindings) de teclas son: +.Pp +.Bl -tag -width "M-j, M-XXX" -offset indent -compact +.It Cm M-S- Ns Aq Cm Return +term +.It Cm M-p +menu +.It Cm M-S-q +quit +.It Cm M-q +restart +.Nm +.It Cm M- Ns Aq Cm Space +cycle_layout +.It Cm M-S- Ns Aq Cm Space +reset_layout +.It Cm M-h +master_shrink +.It Cm M-l +master_grow +.It Cm M-, +master_add +.It Cm M-. +master_del +.It Cm M-S-, +stack_inc +.It Cm M-S-. +stack_del +.It Cm M- Ns Aq Cm Return +swap_main +.It Xo +.Cm M-j , +.Cm M- Ns Aq Cm TAB +.Xc +focus_next +.It Xo +.Cm M-k , +.Cm M-S- Ns Aq Cm TAB +.Xc +focus_prev +.It Cm M-m +focus_main +.It Cm M-S-j +swap_next +.It Cm M-S-k +swap_prev +.It Cm M-b +bar_toggle +.It Cm M-x +wind_del +.It Cm M-S-x +wind_kill +.It Cm M- Ns Aq Ar n +.Ns ws_ Ns Ar n +.It Cm M-S- Ns Aq Ar n +.Ns mvws_ Ns Ar n +.It Cm M- Ns Aq Cm Right +ws_next +.It Cm M- Ns Aq Cm Left +ws_prev +.It Cm M-S- Ns Aq Cm Right +screen_next +.It Cm M-S- Ns Aq Cm Left +screen_prev +.It Cm M-s +screenshot_all +.It Cm M-S-s +screenshot_wind +.It Cm M-S-v +version +.It Cm M-t +float_toggle +.It Cm M-S Aq Cm Delete +lock +.It Cm M-S-i +initscr +.El +.Pp +El nombre de las acciónes descripta a continuación: +.Pp +.Bl -tag -width "M-j, M-XXX" -offset indent -compact +.It Cm term +Ejecutar una terminal +(ver +.Sx PROGRAMAS +) +.It Cm menu +Menu +(ver +.Sx PROGRAMAS +) +.It Cm quit +Salir +.Nm +.It Cm restart +Reiniciar +.Nm +.It Cm cycle_layout +Disposición de las ventanas +.It Cm reset_layout +Reiniciar la disposición de las ventanas +.It Cm master_shrink +Achicar la region principal +.It Cm master_grow +Agrandar la region principal +.It Cm master_add +Agregar una ventana a la region principal +.It Cm master_del +Quitar una ventana de la region principal +.It Cm stack_inc +Agregar columnas/filas a las pilas +.It Cm stack_del +Quitar columnas/filas de las pilas +.It Cm swap_main +Mover la ventana corriente a la region principal +.It Cm focus_next +Enfocar la proxima ventana en la estación de trabajo +.It Cm focus_prev +Enfocar la anterior ventana en la estación de trabajo +.It Cm focus_main +Enfocar en la ventana principal de la estación de trabajo +.It Cm swap_next +Ejecutar con la siguiente ventana en la estación de trabajo +.It Cm swap_prev +Ejecutar con la anterior ventana en la estación de trabajo +.It Cm bar_toggle +Cambiar la barra de estado en todas las estaciones de trabajo +.It Cm wind_del +Borrar la ventana corriente en la estación de trabajo +.It Cm wind_kill +Destruir la ventana corriente en la estación de trabajo +.It Cm ws_ Ns Ar n +Cambiar entre estaciones de trabajo +.Ar n , +donde +.Ar n +es 1 por 10 +.It Cm mvws_ Ns Ar n +Mover la ventana corriente a una estación de trabajo +.Ar n , +donde +.Ar n +es 1 por 10 +.It Cm ws_next +Cambiar a la proxima estación de trabajo con una ventana en ella +.It Cm ws_prev +Cambiar a la anterior estación de trabajo con una ventana en ella +.It Cm screen_next +Mover el puntero a la proxima region +.It Cm screen_prev +Mover el puntero a la anterior region +.It Cm screenshot_all +Tomar una captura de pantalla de todo la pantalla (si esta habilitado) +(ver +.Sx PROGRAMAS +) +.It Cm screenshot_wind +Tomar una captura de pantalla de la ventana seleccionada (si esta habilitado) +(ver +.Sx PROGRAMAS +) +.It Cm version +Mostrar la version en la barra de estado +.It Cm float_toggle +Mostar la ventana en foco entre las flotantes y acomodadas +.It Cm lock +Bloquear pantalla +(ver +.Sx PROGRAMAS +) +.It Cm initscr +Reiniciar la pantalla +(ver +.Sx PROGRAMAS +) +.El +.Pp +Personalizar mapeos (bindings) en el archivo de configuración: +.Pp +.Dl bind[] = +.Pp +.Aq accion +una de las acciones listadas (o ninguna) y +.Aq teclas +una o mas teclas modificadas (puede ser ninguna tambien) +(MOD, Mod1, Shift, etc.) y una o mas teclas normales +(b, barra espaciadora, etc.), separadas por un "+". +Por ejemplo: +.Bd -literal -offset indent +bind[reset] = Mod4+q # combinación Tecla de Windows + q reinicia +bind[] = Mod1+q # des-hace la combinación Alt + q +.Ed +.Pp +Multiples combinaciones de teclas pueden hacer lo mismo. +.Sh QUIRKS +.Nm +te da "quirks" (o forzados) ventanas que tienen que ser tratas de manera especial, +como por ejemplo, popups, aplicaciones de pantalla completa, etc. +.Pp +Los "quirks" (o forzados) por defecto son: +.Pp +.Bl -tag -width "OpenOffice.org N.M:VCLSalFrameXXX" -offset indent -compact +.It Firefox-bin:firefox-bin +TRANSSZ +.It Firefox:Dialog +FLOAT +.It Gimp:gimp +FLOAT + ANYWHERE +.It MPlayer:xv +FLOAT + FULLSCREEN +.It OpenOffice.org 2.4:VCLSalFrame +FLOAT +.It OpenOffice.org 3.1:VCLSalFrame +FLOAT +.It pcb:pcb +FLOAT +.It xine:Xine Window +FLOAT + ANYWHERE +.It xine:xine Panel +FLOAT + ANYWHERE +.It xine:xine Video Fullscreen Window +FULLSCREEN + FLOAT +.It Xitk:Xitk Combo +FLOAT + ANYWHERE +.It Xitk:Xine Window +FLOAT + ANYWHERE +.It XTerm:xterm +XTERM_FONTADJ +.El +.Pp +Los "quirks" (o forzados) se describen a continuación: +.Pp +.Bl -tag -width "XTERM_FONTADJXXX" -offset indent -compact +.It FLOAT +Esta ventana no tiene que ser acomodada, pero le permitimos flotar libremente. +.It TRANSSZ +Ajusta el tamaño de las ventanas transitorias que son demasiado pequeñas utilizando dialog_ratio +(ver +.Sx ARCHIVOS DE CONFIGURACIÓN ) . +.It ANYWHERE +Permite que la ventana se ponga donde quiera. +.It XTERM_FONTADJ +Ajusta las fuentes de xterm cuando se redimenciona. +.It FULLSCREEN +Quita el borde para permitir las ventanas en pantalla completa. +.El +.Pp +Las configuraciones de "quirks" (o forzados) en el archivo de configuración se ven a continuación: +.Pp +.Dl quirk[:] = [ + ... ] +.Pp +.Aq clases +y +.Aq nombre +especifica la ventana en la cual el "quirk(s)" (o forzados) se aplica, y +.Aq quirk +es uno de los "quirks" (o forzados) de la lista. +Por ejemplo: +.Bd -literal -offset indent +quirk[MPlayer:xv] = FLOAT + FULLSCREEN # dejamos que mplayer funcione libremente +quirk[pcb:pcb] = NONE # borramos el quirk existente +.Ed +.Pp +Podes obtener +.Aq clases +y +.Aq nombre +corriendo el programa xprop(1) y luego clickear en la ventana que quieras. +En el proximo ejemplo, podremos verlo en acción con una ventana de Firefox: +.Bd -literal -offset indent +$ xprop | grep WM_CLASS +WM_CLASS(STRING) = "Navigator", "Firefox" +.Ed +.Sh ARCHIVOS +.Bl -tag -width "/etc/scrotwm.confXXX" -compact +.It Pa ~/.scrotwm.conf +.Nm +archivo de configuración especifico del usuario. +.It Pa /etc/scrotwm.conf +.Nm +configuraciones globales. +.El +.Sh HISTORIA +.Nm +fue inspirado en xmonad y dwm. +.Sh AUTORES +.An -nosplit +.Pp +.Nm +fue escrito por +.An Marco Peereboom Aq marco@peereboom.us , +.An Ryan Thomas McBride Aq mcbride@countersiege.com +and +.An Darrin Chandler Aq dwchandler@stilyagin.com . +.Sh BUGS +Actualmente el menu, se llama con +.Cm M-p , +depende de dmenu. -- 1.7.10.4