3 .\" Copyright (c) 2009 Marco Peereboom <marco@peereboom.us>
4 .\" Copyright (c) 2009 Darrin Chandler <dwchandler@stilyagin.com>
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.
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.
23 .Nd gestore di finestre per X11
28 è un gestore di finestre minimale che cerca di stare in disparte, in modo
29 che il prezioso spazio sullo schermo possa essere usato per cose più
30 importanti. Hai dei default sensati e non costringe l'utente ad imparare
31 un linguaggio di programmazione per configurarlo. È stato scritto dagli
32 hacker per gli hacker e cerca di essere piccolo, compatto e veloce.
36 viene avviato, legge le impostazioni presenti nel file di configurazione
39 .Sx FILE DI CONFIGURAZIONE
42 In questa pagina di manuale viene usata la seguente notazione:
44 .Bl -tag -width Ds -offset indent -compact
52 Tasto 1 (sinistro) del mouse
54 Tasto 3 (destro) del mouse
58 è molto semplice da usare. La maggior parte delle operazioni vengono
59 svolte usando combinazioni di tasti sulla tastiera o sul mouse.
62 più sotto per i default e le possibilità di personalizzazione.
63 .Sh FILE DI CONFIGURAZIONE
65 prova per prima cosa ad aprire il file di configurazione personale
68 Se il file in questione non è disponibile, prova ad usare il file di
69 configurazione globale
70 .Pa /etc/scrotwm.conf .
72 Il formato di questo file è \*(Ltchiave\*(Gt = \*(Ltvalore\*(Gt.
77 Per abilitare o disabilitare un'opzione, usare i valori 1 o 0
80 Il file supporta le seguenti chiavi:
82 .Bl -tag -width "title_class_enabledXXX" -offset indent -compact
84 Colore del bordo della finestra che ha il focus.
86 Colore del bordo delle finestre che non hanno il focus.
88 Abilita o disabilita la barra di stato.
89 .It Cm bar_border Ns Bq Ar x
90 Colore del bordo della barra di stato nello schermo
92 .It Cm bar_color Ns Bq Ar x
93 Colore della barra di stato nello schermo
95 .It Cm bar_font_color Ns Bq Ar x
96 Colore del testo della barra di stato nello schermo
99 Font della barra di stato.
101 Script esterno che aggiunge informazioni come la carica della batteria alla
104 Frequenza di aggiornamento, in secondi, dello script esterno che aggiunge
105 informazioni alla barra di stato.
107 Abilita o disabilita la visualizzazione dell'algoritmo di stacking
108 corrente nella barra di stato.
110 Abilita o disabilita l'orologio nella barra di stato. Se disabilitato,
111 usando il valore 0, è possibile usare un orologio personalizzato nello
112 script specificato in bar_action.
114 Alcune applicazioni hanno finestre di dialogo troppo piccole per risultare
115 utili. Questa è la percentuale dello schermo che verrà usata per le finestre
116 di dialogo: ad esempio, 0.6 indica il 60% della dimensione fisica dello
119 Alloca una regione personalizzata, rimuovendo qualsiasi regione
120 automaticamente rilevata stia occupando lo stesso spazio sullo schermo.
121 Definita nel formato screen[<idx>]:LARGHEZZAxALTEZZA+X+Y, ad esempio
122 \& screen[1]:800x1200+0+0.
124 Imposta la dimensione minima preferita per il terminale. Se questo valore
127 cercherà di riaggiustare la dimensione del testo nel terminale in modo che
128 la larghezza del terminale rimanga sopra il valore quando la finestra
129 viene ridimensionata. Al momento solo
131 è supportato. Il binario di
133 deve essere setuid o setgid perché questo funzioni: nella maggior parte dei
134 sistemi, questo è il default. L'utente potrebbe voler impostare
135 program[term] (vedere la sezione
137 più sotto) per usare una seconda copia del binario di
139 che non abbia il bit setgid impostato.
140 .It Cm title_class_enabled
141 Abilita o disabilita la visualizzazione della classe della finestra nella
142 barra di stato. Impostare a 1 per abilitare.
143 .It Cm title_name_enabled
144 Abilita o disabilita la visualizzazione del titolo della finestra nella
145 barra di stato. Impostare a 1 per abilitare.
147 Cambia il tasto modificatore.
148 Solitamente Mod1 è il tasto ALT e Mod4 è il tasto Windows su un PC.
149 .It Cm program Ns Bq Ar p
150 Definisce una nuova azione per lanciare il programma
155 .It Cm bind Ns Bq Ar x
156 Assegna una combinazione di tasti all'azione
161 .It Cm quirk Ns Bq Ar c:n
162 Aggiunge un "quirk" per le finestre di classe
171 I colori devono essere specificati nel formato usato da
173 e i font in quello usato da
177 consente la definizione di azioni personalizzate per lanciare programmi di
178 propria scelta, che possono essere assegnate a combinazioni di tasti nello
179 stesso modo in cui è possibile farlo con le azioni predefinite.
184 I programmi di default sono descritte qui sotto:
186 .Bl -tag -width "screenshot_wind" -offset indent -compact
189 .It Cm screenshot_all
191 .It Cm screenshot_wind
198 dmenu_run \-fn $bar_font \-nb $bar_color \-nf $bar_font_color \-sb $bar_border \-sf $bar_color
201 I programmi personalizzati vengono specificati con la seguente sintassi:
203 .Dl program[<nome>] = <percorso> [<arg> [... <arg>]]
206 è un qualsiasi identificatore che non va in conflitto con un'azione
207 predefinita o una chiave,
209 è il programma desiderato, e
211 sono zero o più argomenti da passare al programma.
213 Le seguenti variabili rappresentano valori impostabili in
216 .Sx FILE DI CONFIGURAZIONE
217 sopra), e possono essere usati nel campo
219 dove saranno sostituite con il valore al momento del lancio del programma:
221 .Bl -tag -width "$bar_font_color" -offset indent -compact
225 .It Cm $bar_font_color
227 .It Cm $color_unfocus
231 .Bd -literal -offset indent
232 program[ff] = /usr/local/bin/firefox http://scrotwm.org/
233 bind[ff] = Mod+f # adesso Mod+F lancia firefox
236 Per eliminare la combinazione precedente:
237 .Bd -literal -offset indent
244 fornisce molte funzioni (o azioni) accessibili tramite combinazioni di
245 tasti sul mouse o sulla tastiera.
247 Le scorciatoie assegnate al mouse sono:
249 .Bl -tag -width "M-j, M-<TAB>XXX" -offset indent -compact
251 Dà focus alla finestra
255 Ridimensiona la finestra
257 Ridimensiona la finestra mantenendola centrata
260 Le scorciatoie da tastiera di default sono:
262 .Bl -tag -width "M-j, M-<TAB>XXX" -offset indent -compact
263 .It Cm M-S- Ns Aq Cm Return
272 .It Cm M- Ns Aq Cm Space
274 .It Cm M-S- Ns Aq Cm Space
288 .It Cm M- Ns Aq Cm Return
297 .Cm M-S- Ns Aq Cm TAB
314 .It Cm M-S- Ns Aq Ar n
316 .It Cm M- Ns Aq Cm Right
318 .It Cm M- Ns Aq Cm Left
320 .It Cm M-S- Ns Aq Cm Right
322 .It Cm M-S- Ns Aq Cm Left
332 .It Cm M-S Aq Cm Delete
338 I nomi delle azioni e le relative descrizioni sono le seguenti:
340 .Bl -tag -width "M-j, M-<TAB>XXX" -offset indent -compact
342 Lancia un nuovo terminale
360 Re-inizializza il layout
362 Restringe l'area principale
364 Allarga l'area principale
366 Aggiunge finestre all'area principale
368 Rimuove finestre dall'area principale
370 Aggiunge righe/colonne all'area di stacking
372 Rimuove righe/colonne dall'area di stacking
374 Muove la finestra corrente nell'area principale
376 Dà il focus alla finestra successiva
378 Dà il focus alla finestra precedente
380 Dà il focus alla finestra principale
382 Scambia con la finestra successiva dell'area di lavoro
384 Scambia con la finestra precedente dell'area di lavoro
386 Mostra/nascondi la barra di stato da tutte le aree di lavoro
388 Chiudi la finestra corrente
390 Distruggi la finestra corrente
392 Passa all'area di lavoro
396 è compreso tra 1 e 10
398 Sposta la finestra corrente nell'area di lavoro
402 è compreso tra 1 e 10
404 Passa all'area di lavoro non vuota successiva
406 Passa all'area di lavoro non vuota precedente
408 Sposta il puntatore nella regione successiva
410 Sposta il puntatore nella regione precedente
411 .It Cm screenshot_all
412 Cattura uno screenshot dell'intero schermo, se abilitato (vedere la sezione
415 .It Cm screenshot_wind
416 Cattura uno screenshot di una singola finestra, se abilitato (vedere la
421 Abilita/disabilita il numero di versione nella barra di stato
423 Passa la finestra che ha il focus da floating a tiled
425 Blocca lo schermo (vedere la sezione
429 Re-inizializza gli schermi fisici (vedere la sezione
434 Le scorciatoie personalizzate sono specificate nel file di configurazione
437 .Dl bind[<azione>] = <tasti>
440 è una delle azioni elencate sopra (oppure nulla) e
442 è dato da zero o più modificatori (MOD, Mod1, Shift, ecc.) e uno o più
443 tasti normali (b, space, ecc.), separati da "+".
445 .Bd -literal -offset indent
446 bind[reset] = Mod4+q # assegna reset ai tasti Windows + q
447 bind[] = Mod1+q # rimuovi l'assegnazione di Alt + q
450 Più combinazioni di tasti possono essere assegnate alla stessa azione.
453 fornisce la possibilità di specificare dei "quirk" per la gestione di
454 finestre che devono subire un trattamento speciale da un gestore di finestre
455 tiling, come ad esempio alcune finestre di dialogo e applicazioni a
458 I quirk abilitati di default sono elencati qui sotto:
460 .Bl -tag -width "OpenOffice.org N.M:VCLSalFrame<TAB>XXX" -offset indent -compact
461 .It Firefox\-bin:firefox\-bin
469 .It OpenOffice.org 2.4:VCLSalFrame
471 .It OpenOffice.org 3.1:VCLSalFrame
479 .It xine:xine Video Fullscreen Window
489 I quirk sono descritti qui sotto:
491 .Bl -tag -width "XTERM_FONTADJ<TAB>XXX" -offset indent -compact
493 Questa finestra deve essere lasciata libera di muoversi.
495 Aggiusta la dimensione delle finestre troppo piccole usando dialog_ratio
497 .Sx FILE DI CONFIGURAZIONE ) .
499 Consente alla finestra di decidere da sola dove posizionarsi.
501 Aggiusta il font di xterm quando viene ridimensionata la finestra.
503 Rimuove i bordi, consentendo alla finestra di usare l'intera dimensione
507 I quirk personalizzati vanno specificati nel file di configurazione come
510 .Dl quirk[<classe>:<nome>] = <quirk> [ + <quirk> ... ]
515 specificano a quali finestre i quirk vanno applicati, e
517 è uno dei quirk presente nella lista sopra.
519 .Bd -literal -offset indent
520 quirk[MPlayer:xv] = FLOAT + FULLSCREEN # lascia che mplayer suoni
521 quirk[pcb:pcb] = NONE # rimuovi un quirk precedentemente specificato
528 usando xprop(1) e facendo click sulla finestra desiderata.
529 Nel seguente esempio è stato fatto click sulla finestra principale di
531 .Bd -literal -offset indent
532 $ xprop | grep WM_CLASS
533 WM_CLASS(STRING) = "Navigator", "Firefox"
536 Bisogna tener conto del fatto che usare grep per trovare WM_CLASS inverte
537 la classe e il nome. Nell'esempio precedente, la dichiarazione del quirk
539 .Bd -literal -offset indent
540 quirk[Firefox:Navigator] = FLOAT
543 .Bl -tag -width "/etc/scrotwm.confXXX" -compact
544 .It Pa ~/.scrotwm.conf
548 .It Pa /etc/scrotwm.conf
549 impostazioni globali di
554 prende ispirazione da xmonad & dwm.
560 .An Marco Peereboom Aq marco@peereboom.us ,
561 .An Ryan Thomas McBride Aq mcbride@countersiege.com
563 .An Darrin Chandler Aq dwchandler@stilyagin.com .
565 Al momento il menu, invocato usando