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 bar_at_bottom
 106 Puedes posicionar la statusbar en la parte inferior de la pantalla.
 107 .It Cm stack_enabled
 108 Habilitar o deshabilitar mostrar el algoritmo de apilamiento en la barra
 109 de estado.
 110 .It Cm clock_enabled
 111 Habilitar o deshabilitar el reloj en la barra de estado, deshabilitado
 112 por defecto con un 0, para usar el reloj de la barra de estado
 113 (bar_action)
 114 .It Cm dialog_ratio
 115 Algunas aplicaciones tienen ventanas de dialogo muy pequeñas como para
 116 ser usables. Este relación (ratio) es el tamaño de la pantalla, por
 117 ejemplo 0.6 es 60% del tamaño físico de la pantalla.
 118 .It Cm region
 119 Acomodar una region personalizada, removiendo cualquier autodeteción de
 120 regiones que ocupe el espacio en la pantalla.
 121 Definiendo el formato screen[<idx>]:WIDTHxHEIGHT+X+Y,
 122 e.g.\& screen[1]:800x1200+0+0.
 123 .It Cm term_width
 124 Setear un ancho minimo preferido para la terminal.
 125 Si el valor es mayor que 0,
 126 .Nm
 127 intentará ajustar el tamaño de la fuente de la terminal para mantener
 128 el ancho de la terminal por encima de este número cuando la ventana
 129 cambia de tamaño.
 130 Actualmente solo es soportado por
 131 .Xr xterm 1
 132 El binario de
 133 .Xr xterm 1
 134 no debe ser un setuid o setgid, que no sea el que viene por defecto en
 135 la mayoria de los sistemas.
 136 Los usuarios pueden necesitar setear program[term] (ver la sección
 137 .Sx PROGRAMAS
 138 ) para usar una copia alternativa del binario de
 139 .Xr xterm 1
 140 sin el seteo del setgid.
 141 .It Cm title_class_enabled
 142 Habilitar o deshabilitar la clase de ventana en la barre de estado.
 143 Habilitado seteando 1
 144 .It Cm title_name_enabled
 145 Habilitar o deshabilita el titulo de la ventana en la barra de estado.
 146 Habilitado seteando 1
 147 .It Cm modkey
 148 Cambiar mod key.
 149 Mod1 generalmente es la tecla ALT y Mod4 la tecla de windows en una PC.
 150 .It Cm focus_mode
 151 Usando el valor de follow_cursor puedes hacer que el manejador de ventanas
 152 se enfoque en la ventana cuando el cursor pase por arriba de las mismas o
 153 bien cambiando de estacion de trabajo.
 154 .It Cm disable_border
 155 Remueve el borde de una sola ventana cuando la barra de estado esta desactivada.
 156 .It Cm program Ns Bq Ar p
 157 Definir una nueva accion para ejecutar un programa.
 158 .Ar p .
 159 Ver la sección de
 160 .Sx PROGRAMAS
 161 .It Cm bind Ns Bq Ar x
 162 Combinación de teclas para una acción
 163 .Ar x .
 164 Ver la sección
 165 .Sx BINDINGS
 166 .It Cm quirk Ns Bq Ar c:n
 167 Agregar un "quirk" (o forzados) para ventanas con clase
 168 .Ar c
 169 y nombre
 170 .Ar n .
 171 Ver la sección
 172 .Sx QUIRKS
 173 .El
 174 .Pp
 175 Los colores deben ser especificados por la especificación
 176 .Xr XQueryColor 3
 177 y las fuentes por la especificación
 178 .Xr XQueryFont 3
 179 .Sh PROGRAMAS
 180 .Nm
 181 te permite definir acciones personales para lanzar los programas que
 182 quieras y luego obligar a la misma con una función de acciones.
 183 Ver la sección
 184 .Sx BINDINGS
 185 .Pp
 186 Los programas por defecto se describen acá:
 187 .Pp
 188 .Bl -tag -width "screenshot_wind" -offset indent -compact
 189 .It Cm term
 190 xterm
 191 .It Cm screenshot_all
 192 screenshot.sh completo
 193 .It Cm screenshot_wind
 194 screenshot.sh por ventana
 195 .It Cm lock
 196 xlock
 197 .It Cm initscr
 198 initscreen.sh
 199 .It Cm menu
 200 dmenu_run \-fn $bar_font \-nb $bar_color \-nf $bar_font_color \-sb $bar_border \-sf $bar_color
 201 .El
 202 .Pp
 203 Los programas en la configuración personal, se especifican aca:
 204 .Pp
 205 .Dl program[<nombre>] = <progpath> [<arg> [... <arg>]]
 206 .Pp
 207 .Aq nombre
 208 es un identificador, no genera conflictos con ninguna accion o palabra
 209 clave,
 210 .Aq progpath
 211 es la ruta al programa, y
 212 .Aq arg
 213 es ninguno o mas de un argumento para el programa.
 214 .Pp
 215 Las siguientes variables de configuracion en
 216 .Nm
 217 (ver
 218 .Sx ARCHIVOS DE CONFIGURACIÓN
 219 ),
 220 y pueden ser usadas en los campos de
 221 .Aq arg
 222 como asi tambien sustituidas por valores al momento del inicio de un
 223 programa:
 224 .Pp
 225 .Bl -tag -width "$bar_font_color" -offset indent -compact
 226 .It Cm $bar_border
 227 .It Cm $bar_color
 228 .It Cm $bar_font
 229 .It Cm $bar_font_color
 230 .It Cm $color_focus
 231 .It Cm $color_unfocus
 232 .El
 233 .Pp
 234 Ejemplo:
 235 .Bd -literal -offset indent
 236 program[ff] = /usr/local/bin/firefox http://scrotwm.com.ar/
 237 bind[ff] = Mod+f # Ahora Mod+F inicia firefox
 238 .Ed
 239 .Pp
 240 Para deshacer lo anterior:
 241 .Bd -literal -offset indent
 242 bind[] = Mod+f
 243 program[ff] =
 244 .Ed
 245 .Sh SIGNALS
 246 Enviando
 247 .Nm
 248 una se?al de HUP reinicia scrotwm.
 249 .Pp
 250 .Sh BINDINGS
 251 .Nm
 252 provee muchas funciones (o acciones) accesibles por medio de la
 253 asignación (bindings) de teclas o el mouse.
 254 .Pp
 255 Las corrientes asignaciones (bindings) del mouse son:
 256 .Pp
 257 .Bl -tag -width "M-j, M-<TAB>XXX" -offset indent -compact
 258 .It Cm M1
 259 Enfoco una ventana
 260 .It Cm M-M1
 261 Muevo una ventana
 262 .It Cm M-M3
 263 Redimenciono una ventana
 264 .It Cm M-S-M3
 265 Redimenciono una ventana hasta que quede centrada
 266 .El
 267 .Pp
 268 Las corrientes asignaciones (bindings) de teclas son:
 269 .Pp
 270 .Bl -tag -width "M-j, M-<TAB>XXX" -offset indent -compact
 271 .It Cm M-S- Ns Aq Cm Return
 272 term
 273 .It Cm M-p
 274 menu
 275 .It Cm M-S-q
 276 quit
 277 .It Cm M-q
 278 restart
 279 .Nm
 280 .It Cm M- Ns Aq Cm Space
 281 cycle_layout
 282 .It Cm M-S- Ns Aq Cm Space
 283 reset_layout
 284 .It Cm M-h
 285 master_shrink
 286 .It Cm M-l
 287 master_grow
 288 .It Cm M-,
 289 master_add
 290 .It Cm M-.
 291 master_del
 292 .It Cm M-S-,
 293 stack_inc
 294 .It Cm M-S-.
 295 stack_del
 296 .It Cm M- Ns Aq Cm Return
 297 swap_main
 298 .It Xo
 299 .Cm M-j ,
 300 .Cm M- Ns Aq Cm TAB
 301 .Xc
 302 focus_next
 303 .It Xo
 304 .Cm M-k ,
 305 .Cm M-S- Ns Aq Cm TAB
 306 .Xc
 307 focus_prev
 308 .It Cm M-m
 309 focus_main
 310 .It Cm M-S-j
 311 swap_next
 312 .It Cm M-S-k
 313 swap_prev
 314 .It Cm M-b
 315 bar_toggle
 316 .It Cm M-x
 317 wind_del
 318 .It Cm M-S-x
 319 wind_kill
 320 .It Cm M- Ns Aq Ar n
 321 .Ns ws_ Ns Ar n
 322 .It Cm M-S- Ns Aq Ar n
 323 .Ns mvws_ Ns Ar n
 324 .It Cm M- Ns Aq Cm Right
 325 ws_next
 326 .It Cm M- Ns Aq Cm Left
 327 ws_prev
 328 .It Cm M-a
 329 ws_prior
 330 .It Cm M-S- Ns Aq Cm Right
 331 screen_next
 332 .It Cm M-S- Ns Aq Cm Left
 333 screen_prev
 334 .It Cm M-s
 335 screenshot_all
 336 .It Cm M-S-s
 337 screenshot_wind
 338 .It Cm M-S-v
 339 version
 340 .It Cm M-t
 341 float_toggle
 342 .It Cm M-S Aq Cm Delete
 343 lock
 344 .It Cm M-S-i
 345 initscr
 346 .El
 347 .Pp
 348 El nombre de las acciónes descripta a continuación:
 349 .Pp
 350 .Bl -tag -width "M-j, M-<TAB>XXX" -offset indent -compact
 351 .It Cm term
 352 Ejecutar una terminal
 353 (ver
 354 .Sx PROGRAMAS
 355 )
 356 .It Cm menu
 357 Menu
 358 (ver
 359 .Sx PROGRAMAS
 360 )
 361 .It Cm quit
 362 Salir
 363 .Nm
 364 .It Cm restart
 365 Reiniciar
 366 .Nm
 367 .It Cm cycle_layout
 368 Disposición de las ventanas
 369 .It Cm reset_layout
 370 Reiniciar la disposición de las ventanas
 371 .It Cm master_shrink
 372 Achicar la region principal
 373 .It Cm master_grow
 374 Agrandar la region principal
 375 .It Cm master_add
 376 Agregar una ventana a la region principal
 377 .It Cm master_del
 378 Quitar una ventana de la region principal
 379 .It Cm stack_inc
 380 Agregar columnas/filas a las pilas
 381 .It Cm stack_del
 382 Quitar columnas/filas de las pilas
 383 .It Cm swap_main
 384 Mover la ventana corriente a la region principal
 385 .It Cm focus_next
 386 Enfocar la proxima ventana en la estación de trabajo
 387 .It Cm focus_prev
 388 Enfocar la anterior ventana en la estación de trabajo
 389 .It Cm focus_main
 390 Enfocar en la ventana principal de la estación de trabajo
 391 .It Cm swap_next
 392 Ejecutar con la siguiente ventana en la estación de trabajo
 393 .It Cm swap_prev
 394 Ejecutar con la anterior ventana en la estación de trabajo
 395 .It Cm bar_toggle
 396 Cambiar la barra de estado en todas las estaciones de trabajo
 397 .It Cm wind_del
 398 Borrar la ventana corriente en la estación de trabajo
 399 .It Cm wind_kill
 400 Destruir la ventana corriente en la estación de trabajo
 401 .It Cm ws_ Ns Ar n
 402 Cambiar entre estaciones de trabajo
 403 .Ar n ,
 404 donde
 405 .Ar n
 406 es 1 por 10
 407 .It Cm mvws_ Ns Ar n
 408 Mover la ventana corriente a una estación de trabajo
 409 .Ar n ,
 410 donde
 411 .Ar n
 412 es 1 por 10
 413 .It Cm ws_next
 414 Cambiar a la proxima estación de trabajo con una ventana en ella
 415 .It Cm ws_prev
 416 Cambiar a la anterior estación de trabajo con una ventana en ella
 417 .It Cm screen_next
 418 Mover el puntero a la proxima region
 419 .It Cm screen_prev
 420 Mover el puntero a la anterior region
 421 .It Cm screenshot_all
 422 Tomar una captura de pantalla de todo la pantalla (si esta habilitado)
 423 (ver
 424 .Sx PROGRAMAS
 425 )
 426 .It Cm screenshot_wind
 427 Tomar una captura de pantalla de la ventana seleccionada (si esta habilitado)
 428 (ver
 429 .Sx PROGRAMAS
 430 )
 431 .It Cm version
 432 Mostrar la version en la barra de estado
 433 .It Cm float_toggle
 434 Mostar la ventana en foco entre las flotantes y acomodadas
 435 .It Cm lock
 436 Bloquear pantalla
 437 (ver
 438 .Sx PROGRAMAS
 439 )
 440 .It Cm initscr
 441 Reiniciar la pantalla
 442 (ver
 443 .Sx PROGRAMAS
 444 )
 445 .El
 446 .Pp
 447 Personalizar mapeos (bindings) en el archivo de configuración:
 448 .Pp
 449 .Dl bind[<accion>] = <teclas>
 450 .Pp
 451 .Aq accion
 452 una de las acciones listadas (o ninguna) y
 453 .Aq teclas
 454 una o mas teclas modificadas (puede ser ninguna tambien)
 455 (MOD, Mod1, Shift, etc.) y una o mas teclas normales
 456 (b, barra espaciadora, etc.), separadas por un "+".
 457 Por ejemplo:
 458 .Bd -literal -offset indent
 459 bind[reset] = Mod4+q # combinación Tecla de Windows + q reinicia
 460 bind[] = Mod1+q # des-hace la combinación Alt + q
 461 .Ed
 462 .Pp
 463 Multiples combinaciones de teclas pueden hacer lo mismo.
 464 .Sh QUIRKS
 465 .Nm
 466 te da "quirks" (o forzados) ventanas que tienen que ser tratas de manera especial,
 467 como por ejemplo, popups, aplicaciones de pantalla completa, etc.
 468 .Pp
 469 Los "quirks" (o forzados) por defecto son:
 470 .Pp
 471 .Bl -tag -width "OpenOffice.org N.M:VCLSalFrame<TAB>XXX" -offset indent -compact
 472 .It Firefox\-bin:firefox\-bin
 473 TRANSSZ
 474 .It Firefox:Dialog
 475 FLOAT
 476 .It Gimp:gimp
 477 FLOAT + ANYWHERE
 478 .It MPlayer:xv
 479 FLOAT + FULLSCREEN
 480 .It OpenOffice.org 2.4:VCLSalFrame
 481 FLOAT
 482 .It OpenOffice.org 3.1:VCLSalFrame
 483 FLOAT
 484 .It pcb:pcb
 485 FLOAT
 486 .It xine:Xine Window
 487 FLOAT + ANYWHERE
 488 .It xine:xine Panel
 489 FLOAT + ANYWHERE
 490 .It xine:xine Video Fullscreen Window
 491 FULLSCREEN + FLOAT
 492 .It Xitk:Xitk Combo
 493 FLOAT + ANYWHERE
 494 .It Xitk:Xine Window
 495 FLOAT + ANYWHERE
 496 .It XTerm:xterm
 497 XTERM_FONTADJ
 498 .El
 499 .Pp
 500 Los "quirks" (o forzados) se describen a continuación:
 501 .Pp
 502 .Bl -tag -width "XTERM_FONTADJ<TAB>XXX" -offset indent -compact
 503 .It FLOAT
 504 Esta ventana no tiene que ser acomodada, pero le permitimos flotar libremente.
 505 .It TRANSSZ
 506 Ajusta el tamaño de las ventanas transitorias que son demasiado pequeñas utilizando dialog_ratio
 507 (ver
 508 .Sx ARCHIVOS DE CONFIGURACIÓN ) .
 509 .It ANYWHERE
 510 Permite que la ventana se ponga donde quiera.
 511 .It XTERM_FONTADJ
 512 Ajusta las fuentes de xterm cuando se redimenciona.
 513 .It FULLSCREEN
 514 Quita el borde para permitir las ventanas en pantalla completa.
 515 .El
 516 .Pp
 517 Las configuraciones de "quirks" (o forzados) en el archivo de configuración se ven a continuación:
 518 .Pp
 519 .Dl quirk[<clases>:<nombre>] = <quirk> [ + <quirk> ... ]
 520 .Pp
 521 .Aq clases
 522 y
 523 .Aq nombre
 524 especifica la ventana en la cual el "quirk(s)" (o forzados) se aplica, y
 525 .Aq quirk
 526 es uno de los "quirks" (o forzados) de la lista.
 527 Por ejemplo:
 528 .Bd -literal -offset indent
 529 quirk[MPlayer:xv] = FLOAT + FULLSCREEN # dejamos que mplayer funcione libremente
 530 quirk[pcb:pcb] = NONE  # borramos el quirk existente
 531 .Ed
 532 .Pp
 533 Podes obtener
 534 .Aq clases
 535 y
 536 .Aq nombre
 537 corriendo el programa xprop(1) y luego clickear en la ventana que quieras.
 538 En el proximo ejemplo, podremos verlo en acción con una ventana de Firefox:
 539 .Bd -literal -offset indent
 540 $ xprop | grep WM_CLASS
 541 WM_CLASS(STRING) = "Navigator", "Firefox"
 542 .Ed
 543 .Sh ARCHIVOS
 544 .Bl -tag -width "/etc/scrotwm.confXXX" -compact
 545 .It Pa ~/.scrotwm.conf
 546 .Nm
 547 archivo de configuración especifico del usuario.
 548 .It Pa /etc/scrotwm.conf
 549 .Nm
 550 configuraciones globales.
 551 .El
 552 .Sh HISTORIA
 553 .Nm
 554 fue inspirado en xmonad y dwm.
 555 .Sh AUTORES
 556 .An -nosplit
 557 .Pp
 558 .Nm
 559 fue escrito por
 560 .An Marco Peereboom Aq marco@peereboom.us ,
 561 .An Ryan Thomas McBride Aq mcbride@countersiege.com
 562 and
 563 .An Darrin Chandler Aq dwchandler@stilyagin.com .
 564 .Sh BUGS
 565 Actualmente el menu, se llama con
 566 .Cm M-p ,
 567 depende de dmenu.