scrotwm_es.1

   1 .\"     $scrotwm$
   2 .\"
   3 .\" Copyright (c) 2009 Marco Peereboom <marco@peereboom.us>
   4 .\" Copyright (c) 2009 Darrin Chandler <dwchandler@stilyagin.com>
   5 .\"
   6 .\" Permission to use, copy, modify, and distribute this software for any
   7 .\" purpose with or without fee is hereby granted, provided that the above
   8 .\" copyright notice and this permission notice appear in all copies.
   9 .\"
  10 .\" THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
  11 .\" WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
  12 .\" MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
  13 .\" ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
  14 .\" WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
  15 .\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
  16 .\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
  17 .\"
  18 .Dd $Mdocdate$
  19 .Dt SCROTWM 1
  20 .Os
  21 .Sh NOMBRE
  22 .Nm scrotwm
  23 .Nd es un manejador de ventanas para X11
  24 .Sh SYNOPSIS
  25 .Nm scrotwm
  26 .Sh DESCRIPCIÓN
  27 .Nm
  28 es un manejador de ventanas super minimalista para X11. Intenta no superponer
  29 las ventanas para que las mismas puedan usarse de manera eficiente y para cosas mas importantes.
  30 Tiene configuraciones normales y no requiere que sepas un lenguaje de
  31 programacion para configurarlo. Esta escrito por hackers para hackers y apunta
  32 a ser pequeño, compacto y rápido.
  33 .Pp
  34 Cuando
  35 .Nm
  36 inicia, lo primero que hace es leer el archivo de configuracion,
  37 .Pa scrotwm.conf .
  38 Ver
  39 .Sx ARCHIVOS DE CONFIGURACIÓN
  40 .
  41 .Pp
  42 La siguiente anotacion se usa a través de esta pagina:
  43 .Pp
  44 .Bl -tag -width Ds -offset indent -compact
  45 .It Cm M
  46 Meta
  47 .It Cm S
  48 Shift
  49 .It Aq Cm Name
  50 Nombre de tecla
  51 .It Cm M1
  52 Boton 1 del mouse
  53 .It Cm M3
  54 Boton 3 del mouse
  55 .El
  56 .Pp
  57 .Nm
  58 es muy simple de usar.
  59 La mayoria de las acciones se hacen con los mapeos (bindings) de mouse
  60 o teclado.
  61 Ver la sección de
  62 .Sx BINDINGS
  63 para las personalizaciones y configuraciones por defecto.
  64 .Sh ARCHIVOS DE CONFIGURACIÓN
  65 .Nm
  66 primero trata de abrir el archivo por defecto en el directorio del usuario,
  67 .Pa ~/.scrotwm.conf .
  68 Si ese archivo no esta disponible,
  69 luego trata de abrir el archivo global de configuracion
  70 .Pa /etc/scrotwm.conf .
  71 .Pp
  72 El formato del archivo es \*(Lttecla\*(Gt = \*(Ltconfiguracion\*(Gt.
  73 Por ejemplo:
  74 .Pp
  75 .Dl color_focus = red
  76 .Pp
  77 Habilitamos o deshabilitamos la opción usando 1 o 0 respectivamente.
  78 .Pp
  79 El archivo soporta las siguientes palabras clave:
  80 .Pp
  81 .Bl -tag -width "title_class_enabledXXX" -offset indent -compact
  82 .It Cm color_focus
  83 Color del borde de la ventana en foco.
  84 .It Cm color_unfocus
  85 Color del borde de la ventana fuera de foco.
  86 .It Cm bar_enabled
  87 Habilitar o deshabilitar la barra de estado.
  88 .It Cm bar_border Ns Bq Ar x
  89 Color del borde de la barra de estado en pantalla.
  90 .Ar x .
  91 .It Cm bar_color Ns Bq Ar x
  92 Color de la ventana de la barra de estado en pantalla.
  93 .Ar x .
  94 .It Cm bar_font_color Ns Bq Ar x
  95 Color de la fuente en la barra de estado en pantalla.
  96 .Ar x .
  97 .It Cm bar_font
  98 Fuente de la barra de estado.
  99 .It Cm bar_action
 100 Scripts externos con populares agregados de información para la barra
 101 de estado, como la vida de la bateria.
 102 .It Cm bar_delay
 103 Frecuencia de actualización, en segundos, de los scripts de la barra de
 104 estado.
 105 .It Cm clock_enabled
 106 Habilitar o deshabilitar el reloj en la barra de estado, deshabilitado
 107 por defecto con un 0, para usar el reloj de la barra de estado
 108 (bar_action)
 109 .It Cm dialog_ratio
 110 Algunas aplicaciones tienen ventanas de dialogo muy pequeñas como para
 111 ser usables. Este relación (ratio) es el tamaño de la pantalla, por
 112 ejemplo 0.6 es 60% del tamaño físico de la pantalla.
 113 .It Cm region
 114 Acomodar una region personalizada, removiendo cualquier autodeteción de
 115 regiones que ocupe el espacio en la pantalla.
 116 Definiendo el formato screen[<idx>]:WIDTHxHEIGHT+X+Y,
 117 e.g.\& screen[1]:800x1200+0+0.
 118 .It Cm term_width
 119 Setear un ancho minimo preferido para la terminal.
 120 Si el valor es mayor que 0,
 121 .Nm
 122 intentará ajustar el tamaño de la fuente de la terminal para mantener
 123 el ancho de la terminal por encima de este número cuando la ventana
 124 cambia de tamaño.
 125 Actualmente solo es soportado por
 126 .Xr xterm 1
 127 El binario de
 128 .Xr xterm 1
 129 no debe ser un setuid o setgid, que no sea el que viene por defecto en
 130 la mayoria de los sistemas.
 131 Los usuarios pueden necesitar setear program[term] (ver la sección
 132 .Sx PROGRAMAS
 133 ) para usar una copia alternativa del binario de
 134 .Xr xterm 1
 135 sin el seteo del setgid.
 136 .It Cm title_class_enabled
 137 Habilitar o deshabilitar la clase de ventana en la barre de estado.
 138 Habilitado seteando 1
 139 .It Cm title_name_enabled
 140 Habilitar o deshabilita el titulo de la ventana en la barra de estado.
 141 Habilitado seteando 1
 142 .It Cm modkey
 143 Cambiar mod key.
 144 Mod1 generalmente es la tecla ALT y Mod4 la tecla de windows en una PC.
 145 .It Cm program Ns Bq Ar p
 146 Definir una nueva accion para ejecutar un programa.
 147 .Ar p .
 148 Ver la sección de
 149 .Sx PROGRAMAS
 150 .It Cm bind Ns Bq Ar x
 151 Combinación de teclas para una acción
 152 .Ar x .
 153 Ver la sección
 154 .Sx BINDINGS
 155 .It Cm quirk Ns Bq Ar c:n
 156 Agregar un "quirk" (o forzados) para ventanas con clase
 157 .Ar c
 158 y nombre
 159 .Ar n .
 160 Ver la sección
 161 .Sx QUIRKS
 162 .El
 163 .Pp
 164 Los colores deben ser especificados por la especificación
 165 .Xr XQueryColor 3
 166 y las fuentes por la especificación
 167 .Xr XQueryFont 3
 168 .Sh PROGRAMAS
 169 .Nm
 170 te permite definir acciones personales para lanzar los programas que
 171 quieras y luego obligar a la misma con una función de acciones.
 172 Ver la sección
 173 .Sx BINDINGS
 174 .Pp
 175 Los programas por defecto se describen acá:
 176 .Pp
 177 .Bl -tag -width "screenshot_wind" -offset indent -compact
 178 .It Cm term
 179 xterm
 180 .It Cm screenshot_all
 181 screenshot.sh completo
 182 .It Cm screenshot_wind
 183 screenshot.sh por ventana
 184 .It Cm lock
 185 xlock
 186 .It Cm initscr
 187 initscreen.sh
 188 .It Cm menu
 189 dmenu_run -fn $bar_font -nb $bar_color -nf $bar_font_color -sb $bar_border -sf $bar_color
 190 .El
 191 .Pp
 192 Los programas en la configuración personal, se especifican aca:
 193 .Pp
 194 .Dl program[<nombre>] = <progpath> [<arg> [... <arg>]]
 195 .Pp
 196 .Aq nombre
 197 es un identificador, no genera conflictos con ninguna accion o palabra
 198 clave,
 199 .Aq progpath
 200 es la ruta al programa, y
 201 .Aq arg
 202 es ninguno o mas de un argumento para el programa.
 203 .Pp
 204 Las siguientes variables de configuracion en
 205 .Nm
 206 (ver
 207 .Sx ARCHIVOS DE CONFIGURACIÓN
 208 ),
 209 y pueden ser usadas en los campos de
 210 .Aq arg
 211 como asi tambien sustituidas por valores al momento del inicio de un
 212 programa:
 213 .Pp
 214 .Bl -tag -width "$bar_font_color" -offset indent -compact
 215 .It Cm $bar_border
 216 .It Cm $bar_color
 217 .It Cm $bar_font
 218 .It Cm $bar_font_color
 219 .It Cm $color_focus
 220 .It Cm $color_unfocus
 221 .El
 222 .Pp
 223 Ejemplo:
 224 .Bd -literal -offset indent
 225 program[ff] = /usr/local/bin/firefox http://scrotwm.com.ar/
 226 bind[ff] = Mod+f # Ahora Mod+F inicia firefox
 227 .Ed
 228 .Pp
 229 Para deshacer lo anterior:
 230 .Bd -literal -offset indent
 231 bind[] = Mod+f
 232 program[ff] =
 233 .Ed
 234 .Pp
 235 .Sh BINDINGS
 236 .Nm
 237 provee muchas funciones (o acciones) accesibles por medio de la
 238 asignación (bindings) de teclas o el mouse.
 239 .Pp
 240 Las corrientes asignaciones (bindings) del mouse son:
 241 .Pp
 242 .Bl -tag -width "M-j, M-<TAB>XXX" -offset indent -compact
 243 .It Cm M1
 244 Enfoco una ventana
 245 .It Cm M-M1
 246 Muevo una ventana
 247 .It Cm M-M3
 248 Redimenciono una ventana
 249 .It Cm M-S-M3
 250 Redimenciono una ventana hasta que quede centrada
 251 .El
 252 .Pp
 253 Las corrientes asignaciones (bindings) de teclas son:
 254 .Pp
 255 .Bl -tag -width "M-j, M-<TAB>XXX" -offset indent -compact
 256 .It Cm M-S- Ns Aq Cm Return
 257 term
 258 .It Cm M-p
 259 menu
 260 .It Cm M-S-q
 261 quit
 262 .It Cm M-q
 263 restart
 264 .Nm
 265 .It Cm M- Ns Aq Cm Space
 266 cycle_layout
 267 .It Cm M-S- Ns Aq Cm Space
 268 reset_layout
 269 .It Cm M-h
 270 master_shrink
 271 .It Cm M-l
 272 master_grow
 273 .It Cm M-,
 274 master_add
 275 .It Cm M-.
 276 master_del
 277 .It Cm M-S-,
 278 stack_inc
 279 .It Cm M-S-.
 280 stack_del
 281 .It Cm M- Ns Aq Cm Return
 282 swap_main
 283 .It Xo
 284 .Cm M-j ,
 285 .Cm M- Ns Aq Cm TAB
 286 .Xc
 287 focus_next
 288 .It Xo
 289 .Cm M-k ,
 290 .Cm M-S- Ns Aq Cm TAB
 291 .Xc
 292 focus_prev
 293 .It Cm M-m
 294 focus_main
 295 .It Cm M-S-j
 296 swap_next
 297 .It Cm M-S-k
 298 swap_prev
 299 .It Cm M-b
 300 bar_toggle
 301 .It Cm M-x
 302 wind_del
 303 .It Cm M-S-x
 304 wind_kill
 305 .It Cm M- Ns Aq Ar n
 306 .Ns ws_ Ns Ar n
 307 .It Cm M-S- Ns Aq Ar n
 308 .Ns mvws_ Ns Ar n
 309 .It Cm M- Ns Aq Cm Right
 310 ws_next
 311 .It Cm M- Ns Aq Cm Left
 312 ws_prev
 313 .It Cm M-S- Ns Aq Cm Right
 314 screen_next
 315 .It Cm M-S- Ns Aq Cm Left
 316 screen_prev
 317 .It Cm M-s
 318 screenshot_all
 319 .It Cm M-S-s
 320 screenshot_wind
 321 .It Cm M-S-v
 322 version
 323 .It Cm M-t
 324 float_toggle
 325 .It Cm M-S Aq Cm Delete
 326 lock
 327 .It Cm M-S-i
 328 initscr
 329 .El
 330 .Pp
 331 El nombre de las acciónes descripta a continuación:
 332 .Pp
 333 .Bl -tag -width "M-j, M-<TAB>XXX" -offset indent -compact
 334 .It Cm term
 335 Ejecutar una terminal
 336 (ver
 337 .Sx PROGRAMAS
 338 )
 339 .It Cm menu
 340 Menu
 341 (ver
 342 .Sx PROGRAMAS
 343 )
 344 .It Cm quit
 345 Salir
 346 .Nm
 347 .It Cm restart
 348 Reiniciar
 349 .Nm
 350 .It Cm cycle_layout
 351 Disposición de las ventanas
 352 .It Cm reset_layout
 353 Reiniciar la disposición de las ventanas
 354 .It Cm master_shrink
 355 Achicar la region principal
 356 .It Cm master_grow
 357 Agrandar la region principal
 358 .It Cm master_add
 359 Agregar una ventana a la region principal
 360 .It Cm master_del
 361 Quitar una ventana de la region principal
 362 .It Cm stack_inc
 363 Agregar columnas/filas a las pilas
 364 .It Cm stack_del
 365 Quitar columnas/filas de las pilas
 366 .It Cm swap_main
 367 Mover la ventana corriente a la region principal
 368 .It Cm focus_next
 369 Enfocar la proxima ventana en la estación de trabajo
 370 .It Cm focus_prev
 371 Enfocar la anterior ventana en la estación de trabajo
 372 .It Cm focus_main
 373 Enfocar en la ventana principal de la estación de trabajo
 374 .It Cm swap_next
 375 Ejecutar con la siguiente ventana en la estación de trabajo
 376 .It Cm swap_prev
 377 Ejecutar con la anterior ventana en la estación de trabajo
 378 .It Cm bar_toggle
 379 Cambiar la barra de estado en todas las estaciones de trabajo
 380 .It Cm wind_del
 381 Borrar la ventana corriente en la estación de trabajo
 382 .It Cm wind_kill
 383 Destruir la ventana corriente en la estación de trabajo
 384 .It Cm ws_ Ns Ar n
 385 Cambiar entre estaciones de trabajo
 386 .Ar n ,
 387 donde
 388 .Ar n
 389 es 1 por 10
 390 .It Cm mvws_ Ns Ar n
 391 Mover la ventana corriente a una estación de trabajo
 392 .Ar n ,
 393 donde
 394 .Ar n
 395 es 1 por 10
 396 .It Cm ws_next
 397 Cambiar a la proxima estación de trabajo con una ventana en ella
 398 .It Cm ws_prev
 399 Cambiar a la anterior estación de trabajo con una ventana en ella
 400 .It Cm screen_next
 401 Mover el puntero a la proxima region
 402 .It Cm screen_prev
 403 Mover el puntero a la anterior region
 404 .It Cm screenshot_all
 405 Tomar una captura de pantalla de todo la pantalla (si esta habilitado)
 406 (ver
 407 .Sx PROGRAMAS
 408 )
 409 .It Cm screenshot_wind
 410 Tomar una captura de pantalla de la ventana seleccionada (si esta habilitado)
 411 (ver
 412 .Sx PROGRAMAS
 413 )
 414 .It Cm version
 415 Mostrar la version en la barra de estado
 416 .It Cm float_toggle
 417 Mostar la ventana en foco entre las flotantes y acomodadas
 418 .It Cm lock
 419 Bloquear pantalla
 420 (ver
 421 .Sx PROGRAMAS
 422 )
 423 .It Cm initscr
 424 Reiniciar la pantalla
 425 (ver
 426 .Sx PROGRAMAS
 427 )
 428 .El
 429 .Pp
 430 Personalizar mapeos (bindings) en el archivo de configuración:
 431 .Pp
 432 .Dl bind[<accion>] = <teclas>
 433 .Pp
 434 .Aq accion
 435 una de las acciones listadas (o ninguna) y
 436 .Aq teclas
 437 una o mas teclas modificadas (puede ser ninguna tambien)
 438 (MOD, Mod1, Shift, etc.) y una o mas teclas normales
 439 (b, barra espaciadora, etc.), separadas por un "+".
 440 Por ejemplo:
 441 .Bd -literal -offset indent
 442 bind[reset] = Mod4+q # combinación Tecla de Windows + q reinicia
 443 bind[] = Mod1+q # des-hace la combinación Alt + q
 444 .Ed
 445 .Pp
 446 Multiples combinaciones de teclas pueden hacer lo mismo.
 447 .Sh QUIRKS
 448 .Nm
 449 te da "quirks" (o forzados) ventanas que tienen que ser tratas de manera especial,
 450 como por ejemplo, popups, aplicaciones de pantalla completa, etc.
 451 .Pp
 452 Los "quirks" (o forzados) por defecto son:
 453 .Pp
 454 .Bl -tag -width "OpenOffice.org N.M:VCLSalFrame<TAB>XXX" -offset indent -compact
 455 .It Firefox-bin:firefox-bin
 456 TRANSSZ
 457 .It Firefox:Dialog
 458 FLOAT
 459 .It Gimp:gimp
 460 FLOAT + ANYWHERE
 461 .It MPlayer:xv
 462 FLOAT + FULLSCREEN
 463 .It OpenOffice.org 2.4:VCLSalFrame
 464 FLOAT
 465 .It OpenOffice.org 3.1:VCLSalFrame
 466 FLOAT
 467 .It pcb:pcb
 468 FLOAT
 469 .It xine:Xine Window
 470 FLOAT + ANYWHERE
 471 .It xine:xine Panel
 472 FLOAT + ANYWHERE
 473 .It xine:xine Video Fullscreen Window
 474 FULLSCREEN + FLOAT
 475 .It Xitk:Xitk Combo
 476 FLOAT + ANYWHERE
 477 .It Xitk:Xine Window
 478 FLOAT + ANYWHERE
 479 .It XTerm:xterm
 480 XTERM_FONTADJ
 481 .El
 482 .Pp
 483 Los "quirks" (o forzados) se describen a continuación:
 484 .Pp
 485 .Bl -tag -width "XTERM_FONTADJ<TAB>XXX" -offset indent -compact
 486 .It FLOAT
 487 Esta ventana no tiene que ser acomodada, pero le permitimos flotar libremente.
 488 .It TRANSSZ
 489 Ajusta el tamaño de las ventanas transitorias que son demasiado pequeñas utilizando dialog_ratio
 490 (ver
 491 .Sx ARCHIVOS DE CONFIGURACIÓN ) .
 492 .It ANYWHERE
 493 Permite que la ventana se ponga donde quiera.
 494 .It XTERM_FONTADJ
 495 Ajusta las fuentes de xterm cuando se redimenciona.
 496 .It FULLSCREEN
 497 Quita el borde para permitir las ventanas en pantalla completa.
 498 .El
 499 .Pp
 500 Las configuraciones de "quirks" (o forzados) en el archivo de configuración se ven a continuación:
 501 .Pp
 502 .Dl quirk[<clases>:<nombre>] = <quirk> [ + <quirk> ... ]
 503 .Pp
 504 .Aq clases
 505 y
 506 .Aq nombre
 507 especifica la ventana en la cual el "quirk(s)" (o forzados) se aplica, y
 508 .Aq quirk
 509 es uno de los "quirks" (o forzados) de la lista.
 510 Por ejemplo:
 511 .Bd -literal -offset indent
 512 quirk[MPlayer:xv] = FLOAT + FULLSCREEN # dejamos que mplayer funcione libremente
 513 quirk[pcb:pcb] = NONE  # borramos el quirk existente
 514 .Ed
 515 .Pp
 516 Podes obtener
 517 .Aq clases
 518 y
 519 .Aq nombre
 520 corriendo el programa xprop(1) y luego clickear en la ventana que quieras.
 521 En el proximo ejemplo, podremos verlo en acción con una ventana de Firefox:
 522 .Bd -literal -offset indent
 523 $ xprop | grep WM_CLASS
 524 WM_CLASS(STRING) = "Navigator", "Firefox"
 525 .Ed
 526 .Sh ARCHIVOS
 527 .Bl -tag -width "/etc/scrotwm.confXXX" -compact
 528 .It Pa ~/.scrotwm.conf
 529 .Nm
 530 archivo de configuración especifico del usuario.
 531 .It Pa /etc/scrotwm.conf
 532 .Nm
 533 configuraciones globales.
 534 .El
 535 .Sh HISTORIA
 536 .Nm
 537 fue inspirado en xmonad y dwm.
 538 .Sh AUTORES
 539 .An -nosplit
 540 .Pp
 541 .Nm
 542 fue escrito por
 543 .An Marco Peereboom Aq marco@peereboom.us ,
 544 .An Ryan Thomas McBride Aq mcbride@countersiege.com
 545 and
 546 .An Darrin Chandler Aq dwchandler@stilyagin.com .
 547 .Sh BUGS
 548 Actualmente el menu, se llama con
 549 .Cm M-p ,
 550 depende de dmenu.