1 .\" Copyright (c) 2009 Marco Peereboom <marco@peereboom.us>
2 .\" Copyright (c) 2009 Darrin Chandler <dwchandler@stilyagin.com>
4 .\" Permission to use, copy, modify, and distribute this software for any
5 .\" purpose with or without fee is hereby granted, provided that the above
6 .\" copyright notice and this permission notice appear in all copies.
8 .\" THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
9 .\" WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
10 .\" MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
11 .\" ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
12 .\" WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
13 .\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
14 .\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
21 .Nd gerenciador de janela para o X11
26 \('e um gerenciador de janela minimalista que tenta n\(~ao atrapalhar a
27 valorosa forma real da tela para que essa possa
28 ser usada para coisas muito mais importantes.
29 Tem sensatos defaults e n\(~ao requer que algu\('em aprenda uma linguagem de
30 programa\(,c\(~ao para fazer qualquer configura\(,c\(~ao.
31 Ele foi escrito por hackers para hackers e esfor\(,ca-se em ser pequeno, compacto e
36 inicia, ele l\(^e as configura\(,c\(~oes do seu arquivo de configura\(,c\(~ao,
39 .Sx ARQUIVOS DE CONFIGURA\(,C\(~AO
42 A seguinte nota\(,c\(~ao \('e usada por toda essa p\('agina:
44 .Bl -tag -width Ds -offset indent -compact
58 \('e muito simples de usar.
59 Muitas das a\(,c\(~oes s\(~ao iniciadas por atalhos do mouse ou do teclado.
62 logo abaixo para os defaults e as personaliza\(,c\(~oes.
63 .Sh ARQUIVOS DE CONFIGURA\(,C\(~AO
65 primeiro tenta abrir o arquivo de configura\(,c\(~ao no diret\('orio do usu\('ario,
66 .Pa ~/.spectrwm.conf .
67 Se o arquivo n\(~ao estiver dispon\('ivel, ent\(~ao tenta abrir o arquivo de
68 configura\(,c\(~ao global
69 .Pa /etc/spectrwm.conf .
71 Assim \('e o formato do arquivo:\*(Ltpalavra-chave\*(Gt = \*(Ltconfigura\(,c\(~ao\*(Gt.
76 Para habilitar ou desabilitar uma op\(,c\(~ao usa-se o 1 ou 0, respectivamente.
78 O arquivo suporta as seguintes palavras-chave:
80 .Bl -tag -width "title_class_enabledXXX" -offset indent -compact
82 Cor da borda da janela atualmente focada.
84 Cor da borda das janelas fora de foco.
86 Habilita ou desabilita a barra de status.
87 .It Cm bar_border Ns Bq Ar x
88 Cor da borda da barra de status na tela
90 .It Cm bar_color Ns Bq Ar x
91 Cor da janela da barra de status na tela
93 .It Cm bar_font_color Ns Bq Ar x
94 Cor da fonte na barra de status na tela
97 Fonte da barra de status.
99 Script externo que preenche a barra de status com informa\(,c\(~oes adicionais,
100 como tempo de vida da bateria.
102 Freq\(:u\(^encia da atualiza\(,c\(~ao, em segundos, do script externo que preenche
105 Coloca a barra de status na parte inferior de cada regi\(~ao, ao inv\('es da parte superior.
107 Habilita ou desabilita mostrar o atual algor\('itmo de empilhamento na barra de status.
109 Habilita ou desabilita mostrar o rel\('ogio na barra de status.
110 Desabilite configurando para 0, ent\(~ao um rel\('ogio personalizado pode ser usado no
113 Algumas aplica\(,c\(~oes tem janelas de di\('alogo que s\(~ao muito pequenas para serem \('uteis.
114 Essa taxa \('e o tamanho da tela para o qual elas ser\(~ao redimencionadas.
115 Por exemplo, 0.6 equivale a 60% do tamanho da tela f\('isica.
117 Aloca uma regi\(~ao personalizada, removendo qualquer regi\(~ao automaticamente detectada
118 que ocupe o mesmo espa\(,co na tela.
119 Definido no formato screen[<idx>]:WIDTHxHEIGHT+X+Y,
120 e.g.\& screen[1]:800x1200+0+0.
122 Configura a largura m\('inima preferida para o terminal
123 Se esse valor for maior do que 0,
125 vai tentar ajustar os tamanhos da fonte no terminal para manter a largura
126 do terminal acima desse n\('umero enquanto a janela \('e redimencionada.
129 \('e suportado atualmente.
132 n\(~ao deve ser setuid ou setgid, que \('e o default em muitos sistemas.
133 Os usu\('arios podem precisar de configurar program[term] (veja a se\(,c\(~ao
135 ) para usar uma c\('opia alternativa do bin\('ario do
137 sem o bit setgid ativado.
138 .It Cm title_class_enabled
139 Habilita ou desabilita mostrar a classe da janela na barra de status.
140 Habilite configurando para 1.
141 .It Cm title_name_enabled
142 Habilita ou desabilita mostrar o t\('itulo da janela na barra de status.
143 Habilite configurando para 1.
144 .It Cm window_name_enabled
145 Habilita ou desabilita mostrar a nome da janela na barra de status.
146 Habilite configurando para 1.
148 Muda a tecla de modifica\(,c\(~ao.
149 Mod1 \('e geralmente a tecla ALT e Mod4 \('e a tecla windows em um PC.
151 Usar um valor de follow_cursor vai fazer o gerenciador de janela focar
152 a janela sob o mouse quando trocando \('areas de trabalho e criando janelas.
153 .It Cm disable_border
154 Remove a borda quando a barra estiver desabilitada e houver apenas uma janela na tela.
155 .It Cm program Ns Bq Ar p
156 Define uma nova a\(,c\(~ao para executar um programa
161 .It Cm bind Ns Bq Ar x
162 Cria uma combina\(,c\(~ao de teclas de atalho para a a\(,c\(~ao
167 .It Cm quirk Ns Bq Ar c:n
168 Adicione "quirk" para janelas com classe
177 Cores precisam ser especificadas pela especifica\(,c\(~ao
179 e fontes pela especifica\(,c\(~ao
182 Para listar as fontes dispon\('iveis em seu sistema veja o manual do
188 pode te ajudar a mostrar a X Logical Font Description ("XLFD") usada na
189 configura\(,c\(~ao da palavra-chave bar_font.
192 te permite definir a\(,c\(~oes personalizadas para executar programas de sua escolha
193 e ent\(~ao criar um atalho para elas da mesma forma que as a\(,c\(~oes embutidas.
198 Os programas default s\(~ao descritos abaixo:
200 .Bl -tag -width "screenshot_wind" -offset indent -compact
203 .It Cm screenshot_all
205 .It Cm screenshot_wind
212 dmenu_run \-fn $bar_font \-nb $bar_color \-nf $bar_font_color \-sb $bar_border \-sf $bar_color
215 Programas personalizados no arquivo de configura\(,c\(~ao s\(~ao especificados da seguinte maneira:
217 .Dl program[<name>] = <progpath> [<arg> [... <arg>]]
220 \('e um identificador qualquer que n\(~ao conflite com uma a\(,c\(~ao ou palavra-chave embutida,
222 \('e o programa desejado, e
224 \('e zero ou mais argumentos para o programa.
226 As seguintes vari\('aveis representam valores configur\('aveis no
229 .Sx ARQUIVOS DE CONFIGURA\(,C\(~AO
231 e podem ser usadas nos campos
233 e ser\(~ao substitu\('idas pelos valores na hora em que o programa for executado:
235 .Bl -tag -width "$bar_font_color" -offset indent -compact
239 .It Cm $bar_font_color
241 .It Cm $color_unfocus
245 .Bd -literal -offset indent
246 program[ff] = /usr/local/bin/firefox http://spectrwm.org/
247 bind[ff] = Mod+f # Agora Mod+F executa o firefox
250 Para desfazer a configura\(,c\(~ao anterior:
251 .Bd -literal -offset indent
258 prov\(^e muitas fun\(,c\(~oes (ou a\(,cões) acessadas pelos atalhos do teclado ou do mouse.
260 Os atuais atalhos do mouse s\(~ao descritos abaixo:
262 .Bl -tag -width "M-j, M-<TAB>XXX" -offset indent -compact
268 Redimenciona a janela
270 Redimenciona a janela enquanto a mant\('em centralizada
273 Os atalhos default do teclado s\(~ao descritos abaixo:
275 .Bl -tag -width "M-j, M-<TAB>XXX" -offset indent -compact
276 .It Cm M-S- Ns Aq Cm Return
285 .It Cm M- Ns Aq Cm Space
287 .It Cm M-S- Ns Aq Cm Space
301 .It Cm M- Ns Aq Cm Return
310 .Cm M-S- Ns Aq Cm TAB
327 .It Cm M-S- Ns Aq Ar n
329 .It Cm M- Ns Aq Cm Right
331 .It Cm M- Ns Aq Cm Left
335 .It Cm M-S- Ns Aq Cm Right
337 .It Cm M-S- Ns Aq Cm Left
347 .It Cm M-S Aq Cm Delete
353 Os nomes das a\(,c\(~oes e suas descri\(,cões est\(~ao listados abaixo:
355 .Bl -tag -width "M-j, M-<TAB>XXX" -offset indent -compact
357 Executa um novo terminal
373 Circula entre os poss\('iveis layouts
377 Encolhe a \('area mestre
379 Aumenta a \('area mestre
381 Adiciona janelas na \('area mestre
383 Remove janelas da \('area mestre
385 Adiciona colunas/linhas para a \('area de empilhamento
387 Remove colunas/linhas da \('area de empilhamento
389 Move a janela atual para a \('area mestre
391 Foca a pr\('oxima janela da \('area de trabalho
393 Foca a janela anterior da \('area de trabalho
395 Foca a janela principal da \('area de trabalho
397 Troca com a pr\('oxima janela da \('area de trabalho
399 Troca com a janela anterior da \('area de trabalho
401 Ativa/desativa a barra de status em todas as \('areas de trabalho
403 Apaga a janela atual da \('area de trabalho
405 Destr\('oi a janela atual da \('area de trabalho
407 Troca para a \('area de trabalho
413 Move a janela atual para a \('area de trabalho
419 Troca para a pr\('oxima \('area de trabalho que possua uma janela
421 Troca para a \('area de trabalho anterior que possua uma janela
423 Troca para a \('ultima \('area de trabalho visitada
425 Move o ponteiro para a pr\('oxima regi\(~ao
427 Move o ponteiro para a regi\(~ao anterior
428 .It Cm screenshot_all
429 Tira screenshot da tela inteira (se habilitado)
433 .It Cm screenshot_wind
434 Tira screenshot da janela selecionada (se habilitado)
439 Ativa/desativa a vers\(~ao na barras de status
441 Troca o estado da janela focada entre flutuante e tiled
448 Reinicializa as telas f\('isicas
454 Atalhos personalizados no arquivo de configura\(,c\(~ao s\(~ao especificados da seguinte maneira:
456 .Dl bind[<action>] = <keys>
459 \('e uma das a\(,c\(~oes listadas acima (ou vazio) e
461 est\('a na forma de zero ou mais teclas de modifica\(,c\(~ao
462 (MOD, Mod1, Shift, etc.) e uma ou mais teclas normais
463 (b, space, etc.), separadas pelo "+".
465 .Bd -literal -offset indent
466 bind[reset] = Mod4+q # combina a tecla Windows + q para reiniciar
467 bind[] = Mod1+q # desfaz a combina\(,c\(~ao Alt + q
470 M\('ultiplas combina\(,c\(~oes de teclas podem ser usadas para a mesma a\(,c\(~ao.
473 prov\(^e "quirks" que manipulam janelas que devem ser tratadas especialmente
474 em um gerenciador de janela "tiling", tal como algumas aplica\(,c\(~oes de
475 di\('alogos e tela cheia.
477 Os quirks default est\(~ao descritos abaixo:
479 .Bl -tag -width "OpenOffice.org N.M:VCLSalFrame<TAB>XXX" -offset indent -compact
480 .It Firefox\-bin:firefox\-bin
488 .It OpenOffice.org 2.4:VCLSalFrame
490 .It OpenOffice.org 3.1:VCLSalFrame
498 .It xine:xine Video Fullscreen Window
508 Os quirks em si est\(~ao descritos abaixo:
510 .Bl -tag -width "XTERM_FONTADJ<TAB>XXX" -offset indent -compact
512 Esta janela n\(~ao deve ser "tiled", mas permitida a flutuar livremente.
514 Ajusta o tamanho das janelas transit\('orias que sejam muito pequenas
517 .Sx ARQUIVOS DE CONFIGURA\(,C\(~AO ) .
519 Permite que a janela posicione a si mesma, n\(~ao-centrada.
521 Ajusta as fontes do xterm quando redimencionando.
523 Remove a borda para permitir a janela usar todo o tamanho da tela.
526 Quirks personalizados no arquivo de configura\(,c\(~ao s\(~ao especificados da seguinte maneira:
528 .Dl quirk[<class>:<name>] = <quirk> [ + <quirk> ... ]
533 especificam a janela ao qual o quirk se aplica, e
535 \('e um dos quirks da lista acima.
537 .Bd -literal -offset indent
538 quirk[MPlayer:xv] = FLOAT + FULLSCREEN # faz o mplayer tocar livremente
539 quirk[pcb:pcb] = NONE # remove quirk existente
546 executando o xprop(1) e ent\(~ao clicando na janela desejada.
547 No seguinte exemplo a jenela principal do Firefox foi clicada:
548 .Bd -literal -offset indent
549 $ xprop | grep WM_CLASS
550 WM_CLASS(STRING) = "Navigator", "Firefox"
553 Note que usando o grep(1) para WM_CLASS voc\(^e obt\('em class e name.
554 No exemplo acima a configura\(,c\(~ao do quirk poderia ser:
555 .Bd -literal -offset indent
556 quirk[Firefox:Navigator] = FLOAT
561 um sinal HUP far\('a com que o mesmo seja reiniciado.
563 .Bl -tag -width "/etc/spectrwm.confXXX" -compact
564 .It Pa ~/.spectrwm.conf
565 Configura\(,c\(~oes espec\('ificas do usu\('ario.
566 .It Pa /etc/spectrwm.conf
567 Configura\(,c\(~oes globais.
571 foi inspirado pelo xmonad & dwm.
577 .An Marco Peereboom Aq marco@peereboom.us ,
578 .An Ryan Thomas McBride Aq mcbride@countersiege.com
580 .An Darrin Chandler Aq dwchandler@stilyagin.com .
582 Atualmente o menu, invocado com