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