blackbox.1

   1 .\"
   2 .\" Man page for Blackbox
   3 .\"
   4 .\" Copyright (c) 2000 by Wilbert Berendsen <wbsoft@xs4all.nl>
   5 .\"
   6 .\" This manual page may be freely distributed and modified.
   7 .\" Parts of the text are taken from website and several README's
   8 .\" by His Great Hughesness himself. Why reinvent wheels?
   9 .\"
  10 .\" Created with NEdit, tested with ``man'' and ``tkman.''
  11 .\" This manpage uses only standard groff and tmac.an macros.
  12 .\" To all translators who didn't do manpages earlier (like me ;-):
  13 .\" Read the Man-Page-Mini-HOWTO and the LDP manpage ``man 7 man''
  14 .\" There's all I needed to know about these macros.
  15 .\"
  16 .\" Updated for bb 0.61 at Sat Sep  9 06:56:04 CEST 2000
  17 .\"
  18 .\" ..define sort of <blockquote><pre> macro
  19 .de EX
  20 .ne 5
  21 .if n .sp 1
  22 .if t .sp .5
  23 .nf
  24 .in +.5i
  25 ..
  26 .de EE
  27 .fi
  28 .in -.5i
  29 .if n .sp 1
  30 .if t .sp .5
  31 ..
  32 .TH blackbox 1 "10 marca 2002" "0.61.1"
  33 .SH NAZWA
  34 blackbox \- menad¿er okien dla X11
  35 .SH STRESZCZENIE
  36 .BR blackbox " \-help | \-version"
  37 .br
  38 .B blackbox
  39 .RI "[ \-rc" " plik_rc " "] [ \-display" " displej " ]
  40 .SH OPIS
  41 .\"
  42 .\" Phirst Phew ParagraPhs taken from blackbox.alug.org
  43 .\"
  44
  45 Blackbox jest jednym z wielu menad¿erów okien dla X Window System, wersji 11
  46 wydania 6 i pó¼niejszych.
  47 Blackbox jest napisany w C++ i nie wspó³dzieli kodu z ¿adnym innym menad¿erem
  48 okien (chocia¿ implementacja graficzna jest podobna do Window Makera).
  49 .PP
  50 Od pocz±tku Blackbox jest rozwijany z nastawieniem na minimalizm.
  51 Za³o¿eniem nie jest przykuwanie wzroku wygl±dem, posiadanie wielu opcji
  52 czy mo¿liwo¶æ odwzorowania intefejsów graficznych z innych systemów operacyjnych.
  53 Blackbox po prostu ma byæ
  54 .BR szybki .
  55 .PP
  56 Blackbox posiada konfigurowalne dekoracje okien, menu z aplikacjami
  57 i pasek narzêdzi pokazuj±cy nazwê bie¿±cego biurka, nazwê aktywnego okna i aktualny
  58 czas.
  59 Jest tak¿e menu do dodawania lub usuwania biurek.
  60 `Slit' (Szczelina???) mo¿e byæ u¿yta do dokowania ma³ych aplikacji, np.
  61 wiêkszo¶æ bbtools-ów mo¿e tego u¿ywaæ.
  62 .PP
  63 Blackbox wprowadza specjalny sposób obs³ugi ikon: Kiedy minimalizujesz okno,
  64 nie pojawiaj± siê ikonki; zamiast mo¿esz obejrzeæ wszystkie zminimalizowane
  65 aplikacje w podmenu `Icons' (Ikony) menu biurek.
  66 Twój pulpit nigdy nie bêdzie za¶miecony ikonami. Jaka alternatywa do ikon
  67 wprowadzone jest zas³anianie okien: podwójne klikniêcie na pasku tytu³owym
  68 zas³oni okno (np. okno zniknie; tylko pasek tytu³owy pozostanie widoczny).
  69 .PP
  70 Blackbox u¿ywa w³asnej klasy graficznej do renderowania obrazów w locie.
  71 Poprzez u¿ywanie plików stylów w du¿ym stopniu mo¿esz zdecydowaæ jak bêdzie
  72 wygl±daæ twój pulpit.
  73 Na razie Blackbox u¿ywa w³asnego protoko³u do komunikacji z innymi klientami
  74 takimi jak pejd¿ery.
  75 Trwaj± prace nad przystosowaniem siê do nowej specyfikacji menad¿erów okien,
  76 której u¿ywaj± ju¿ GNOME i KDE.
  77 .SH OPCJE
  78 Blackbox obs³uguje nastêpuj±ce opcje linii komend:
  79 .TP
  80 .B \-help
  81 Wy¶wietla opcje dostêpne z linii komend. Po czym koñczy dzia³anie.
  82 .TP
  83 .B \-version
  84 Wy¶wietla informacjê o wersji i koñczy dzia³anie.
  85 .TP
  86 .BI \-rc \ plik_rc
  87 U¿ywa innego ni¿ domy¶lny
  88 .IR  "~/.blackboxrc"
  89 pliku konfiguracyjnego.
  90 .TP
  91 .BI \-display \ displej
  92 Uruchamia Blackboxa na podanym displeju.
  93 Programy uruchamiane pod kontrol± Blackboxa bêd± mia³y
  94 zmienn± ¶rodowiskow±
  95 .B DISPLAY
  96 ustawian± na tê warto¶æ.
  97 .SH URUCHAMIANIE BLACKBOXA
  98 Program ten jest zwykle uruchamiany poprzez skrypt u¿ytkownika, najczê¶ciej
  99 jest to
 100 .IR ~/.xinitrc .
 101 ¯eby uruchamiaæ blackboxa zmodyfikuj skrypt dodaj±c
 102 .EX 0
 103 exec blackbox
 104 .EE
 105 jako ostatni± wykonywan± komendê skryptu.
 106 Gdy zakoñczysz blackboxa, zakoñczy siê tak¿e sesja X.
 107 .PP
 108 Przy starcie Blackbox stara siê odnale¼æ domy¶lne menu w pliku
 109 .IR /usr/X11R6/share/blackbox/menu .
 110 Mo¿esz tutaj umie¶ciæ globalne menu dla swoich uzytkowników.
 111 .PP
 112 Przy koñczeniu pracy b±d¼ przy restarcie Blackbox bêdzie zapisywa³ ustawienia
 113 w pliku
 114 .I ~/.blackboxrc
 115 w domowym katalogu u¿ytkownika.
 116 Plik ten mo¿e byæ te¿ edytowany rêcznie.
 117 .SH U¯YWANIE BLACKBOXA
 118 Od wersji 0.60.x Blackbox nie zajmuje siê obs³ug± klawiatury \"osobi¶cie\";
 119 zamiast tego polega na programie
 120 .IR bbkeys (1).
 121 Wiêc omówimy obs³ugê Blackboxa przy pomocy myszy.
 122 .SS G³ówne okno (T³o):
 123 Po klikniêciu prawym przyciskiem myszki(button 3) pojawi siê menu,
 124 z którego mo¿na uruchamiaæ aplikacje.
 125 Mo¿esz dostosowaæ te menu do swoich potrzeb.
 126 Gdzie znajduj± siê pliki za to odpowiedzialne jest opisane wy¿ej.
 127 Klikniêcie ¶rodkowego przycisku (button 2) powoduje wy¶wietlenie menu dla biurek.
 128 Mo¿esz dodaæ nowe biurko lub usun±æ ju¿ istniej±ce, zobaczyæ listê aplikacji dzia³aj±cych
 129 na poszczególnych biurkach, sprawdziæ zminimalizowane aplikacje i skoczyæ bezpo¶rednio
 130 na dowolne biurko czy do dowolnej aplikacji.
 131 .PP
 132 Klikniêcie lewego przycisku myszki (button 1) na nazwie aplikacji w menu z biurkami
 133 przeniesiê ciê na wskazany pulpit roboczy(biurko) i uaktywni okno z t± aplikacj±;
 134 Klikniêcie ¶rodkowego przycisku (button 2) przy³±czy okno z aplikacj± do bie¿±cego
 135 pulpitu.
 136 .SS Pasek narzêdzi:
 137 Pasek narzêdzi sk³ada siê z trzech pól: nazwy biurka,
 138 nazwy aktywnego okna i zegarka.
 139 Klikniêcie lewym przyciskiem przeniesie pasek narzêdzi na pierwszy plan.
 140 Klikniêcie ¶rodkowym klawiszem schowa go za innymi oknami (o ile nie jest ustawione
 141 AlwaysOnTop (Zawsze na wierzchu)).
 142 Po klikniêciu prawym przyciskiem pojawi siê malutkie menu.
 143 .PP
 144 U¿ywaj±c go mo¿esz wprowadziæ now± nazwê bie¿±cego biurka (kiedy skoñczysz naci¶nij Enter).
 145 Mo¿esz tak¿e wybraæ po³o¿enie paska narzêdzi, czy ma byæ zawsze na wierzchu i czy
 146 pasek narzêdzi powinen siê chowaæ, gdy wska¼nik myszy siê oddali.
 147 .PP
 148 Uwaga: W wersjach Blackboxa poni¿ej 0.60.0 klikniêcie prawym klawiszem myszki
 149 od razu wywo³ywa³o tryb edycji nazwy biurka.
 150 .SS Pasek tytu³owy okna i obrze¿a:
 151 Klikniêcie lewym przyciskiem na jakiejkolwiek czê¶ci obrze¿a okna uaktywni je.
 152 Trzymaj±c przycisk wci¶niêty mo¿esz przesuwaæ okno.
 153 Przy pomocy uchwytów w lewym dolnym i prawym dolnym rogu mo¿esz zmieniæ
 154 rozmiary okna.
 155 Klikniêcie ¶rodkowym przyciskiem od razu zmiejszy okno.
 156 Po klikniêcie prawym przyciskiem na obrze¿u lub pasku tytu³owym
 157 pojawi siê okienko z menu z nastêpuj±cymi komendami:
 158 .TP
 159 .B Send To... (Przerzuæ do...)
 160 Przenosi okno na inne biurko.
 161 Kiedy wybierzesz biurko ¶rodkowym przyciskiem Blackbox przeniesie ciê
 162 razem z aplikacj± na te biurko.
 163 .TP
 164 .B Shade (Cieñ)
 165 Cieniuje okno (wy¶wietla tylko pasek tytu³owy).
 166 .TP
 167 .B Iconify (Minimalizuj)
 168 Minimalizuje okno.
 169 Ikonê programu mo¿na odnale¼æ w podmenu `Icons' (Ikony) menu biurka. Nie pojawi
 170 siê ona jednak na ekranie.
 171 .TP
 172 .B Maximize (Maksymalizuj)
 173 (Nie)maksymalizuj okna.
 174 Kiedy klikniesz ¶rodkowym przyciskiem na tym elemencie menu
 175 okno powiêkszy siê tylko w pionie.
 176 .TP
 177 .B Raise (Podnie¶)
 178 Uaktywnia okno.
 179 .TP
 180 .B Lower (Zmiejsz)
 181 Deaktywuje okno.
 182 .TP
 183 .B Stick (Na ka¿dym biurku)
 184 (Nie) przymocowuje okno.
 185 Przymocowane okno bêdzie zawsze widoczne na bie¿±cym biurku.
 186 .TP
 187 .B Kill Client (Zakoñcz bezwarunkowo)
 188 Wysy³a sygna³ -SIGKILL do w³a¶ciciela okna. U¿yj tego w ostateczno¶ci, je¶li program
 189 odmawia normalnego zakoñczenia.
 190 .TP
 191 .B Close (Zamknij)
 192 Zakoñcz bezpiecznie aplikacjê.
 193 .PP
 194 Gdy podwójnie klikniesz na pasku tytu³owym okna tylko pasek tytu³owy
 195 pozostanie widoczny. Ponowne podwójne klikniêcie przywróci poprzedni wygl±d.
 196 .SS Przyciski okna:
 197 Przycisk w lewym górnym rogu okna (na pasku tytu³owym) to przycisk minimalizacji.
 198 Jego klikniêcie dowolnym przyciskiem myszki spowoduje minimalizacjê okna.
 199 Przycisk najbardziej na prawo (z X) koñczy dzia³anie aplikacji.
 200 Je¶li jest jaki¶ przycisk jeszcze oprócz dwóch wymienionych to maksymalizuje
 201 on okno na trzy sposoby:
 202 lewy przycisk myszki powoduje maksymalizacjê na ca³y ekran, ¦rodkowy
 203 tylko w pionie, prawy tylko w poziomie.
 204 .SS Jakiekolwiek menu:
 205 Klikniêcie prawego przycisku myszy schowa menu.
 206 Klikniêcie lewego przycisku na pasku tytu³owym lub jakimkolwiek (pod)menu
 207 i przeci±gniêcie w inne miejsce spowoduje, ¿e menu pozostanie widoczne.
 208 Nie zniknie gdy klikniesz na jakim¶ elemencie menu.
 209 .SS Ró¿no¶ci:
 210 Kiedy chcesz przeci±gn±æ okno, gdy nie widaæ dolnych uchwytów
 211 lub paska tytu³owego, mo¿esz wcisn±æ klawisz Alt i lewy przycisk myszki,
 212 i przeci±gaæ do woli.
 213 Tej samej kombinacji mo¿esz u¿yæ by uaktywniæ okno.
 214 Mo¿esz tak¿e u¿yæ Alt + ¶rodkowy przycisk myszy, ¿eby zdeaktywowaæ okno
 215 a Alt + przycisk prawy, ¿eby zmieniæ rozmiary okna.
 216 .SH PLIK MENU
 217 Domy¶lnie plik menu jest instalowany w
 218 .IR /usr/X11R6/share/blackbox/menu .
 219 Oczywi¶cie te globalne menu mo¿e byæ dla wszystkich u¿ytkowników.
 220 Mo¿na stworzyæ tak¿e w³asne menu.
 221 Konwencj± jest utworzenie katalogu
 222 .IR "~/.blackbox/" " (lub " "~/blackbox/" ")"
 223 w katalogu domowym i utworzenie w nim pliku menu, np.
 224 .I menu
 225 lub skopiowanie do niego globalnego menu.
 226 Nastêpnie trzeba powiedzieæ Blackboxowi, ¿eby korzysta³ z naszego menu zamiast
 227 domy¶lnego.
 228 Robi siê to dodaj±c (albo zmieniaj±c) warto¶æ zasobu w pliku
 229 .I ~/.blackboxrc
 230 , np.:
 231 .EX
 232 session.menuFile:       ~/.blackbox/menu
 233 .EE
 234 ¯eby zmiany odnios³y skutek Blackbox musi zostaæ zrestartowany.
 235 Upewnij siê, ¿e twoje menu nadaje siê do u¿ytku i wybierz `Restart'
 236 z domy¶lnego menu.
 237 .SS Sk³adnia menu
 238 Sk³adnia menu jest bardzo prosta i bardzo efektywna.
 239 Jest co najwy¿ej trzy pola w jednej linii menu.
 240 S± one postaci:
 241 .EX
 242 [tag] (etykietka lub nazwa pliku) {komenda lub nazwa pliku}
 243 .EE
 244 Nastêpuj±ce tagi mog± byæ u¿yte:
 245 .TP
 246 .B [begin] (etykietka dla g³ównego menu)
 247 Ten tag mówi Blackboxowi, ¿eby zacz±³ przetwarzaæ plik.
 248 Tag ten jest wymagany. Je¶li go nie ma w twoim pliku z menu,
 249 zostanie u¿yte menu domy¶lne.
 250 .TP
 251 .B [end]
 252 To informuje Blackboxa o koñcu menu (menu g³ównego b±d¼ jakiego¶ podmenu).
 253 Musi byæ przynajmniej jeden [end] w twoim menu odpowiadaj±cy [begin].
 254 .TP
 255 .B [exec] (etykietka dla komendy) {komenda pow³oki}
 256 Wstaw polecenie do menu.
 257 Je¶li wybierzesz te polecenie z menu, Blackbox wykona odpowiadaj±c± mu
 258 komendê pow³oki.
 259 .TP
 260 .B [exit] (etykietka dla wyj¶cia)
 261 Wybranie tego elementu z menu koñczy dzia³anie Blackboxa, chocia¿
 262 dzia³aj±ce programy nie s± zamykane.
 263 .TP
 264 .B [include] (nazwa_pliku)
 265 do³±cza menu z pliku
 266 .I nazwa_pliku
 267 do bie¿±cego menu. Nazwa pliku mo¿e byæ pe³n± ¶cie¿k± do pliku lub mo¿e
 268 zaczynaæ siê na
 269 .IR ~/ ,
 270 co zostanie zast±pione twoim katalogiem domowym (np.
 271 .EX
 272 [include] (~/blackbox/stylesmenu)
 273 .EE
 274 do³±cza plik
 275 .I /home/bhughes/blackbox/stylesmenu
 276 do mojego menu).
 277 .TP
 278 .B [nop] (etykietka - opcjonalnie)
 279 Wstawia nic nie robi±cy element do menu.
 280 Mo¿e byæ on pomocny do formatowania menu w bloki lub sekcje, je¶li sobie tego
 281 ¿yczymy.
 282 .B [nop]
 283 mo¿na dodaæ etykietkê, ale nie jest ona wymagana i je¶li siê jej nie poda
 284 wy¶wietlona bêdzie pusta linia.
 285 .TP
 286 .B [style] (etykietka) {nazwa pliku}
 287 Po wybraniu tego elementu z menu, Blackbox czyta
 288 plik stylów
 289 .I nazwa pliku
 290 i stosuje tekstury, kolory i czcionki z tego pliku do bie¿±cej sesji.
 291 .TP
 292 .B [stylesdir] (nazwa katalogu)
 293 Czyta wszystkie nazwy plików (nazwy katalogów s± pomijane) z podanego katalogu
 294 i tworzy elementy menu dla ka¿dego pliku. Blackbox przyjmuje, ¿e ka¿dy plik
 295 jest poprawnym plikiem stylów. Gdy u¿ytkownik wybierze plik stylów, Blackbox
 296 zastosuje go do bie¿±cej sesji.
 297 Etykiety tworzone w menu s± nazwami plików stylów.
 298 .TP
 299 .B [stylesmenu] (etykietka) {nazwa katalogu}
 300 Tworzy podmenu z etykiet±
 301 .I etykietka
 302 (która staje siê tak¿e nazw± podmenu) i wstawia wszystkie nazwy plików
 303 w podanym katalogu do tego podmenu w taki sam sposób jak robi to
 304 .B [stylesdir]
 305 .IP
 306 .RB Obydwa\  [stylesdir] \ i\  [stylesmenu]
 307 pozwalaj± instalowaæ pliki stylów bez edytowania pliku menu.
 308 .TP
 309 .B [submenu] (etykietka) {tytu³ dla menu - opcjonalnie}
 310 To mówi Blackboxowi o utworzeniu i przetwarzaniu nowego menu.
 311 To menu jest wstawiane jako podmenu do menu nadrzêdnego.
 312 Menu s± przetwarzane rekurencyjnie. Nie ma wiêc ograniczeñ na liczbê
 313 poziomów czy zagnie¿d¿eñ menu jakie mo¿esz mieæ.
 314 Tytu³ nowego menu jest opcjonalny; je¶li nie podasz ¿adnego, tytu³
 315 menu bêdzie taki sam jak etykietka.
 316 Tag
 317 .B [end]
 318 jest wymagany na koñcu podmenu.
 319 .TP
 320 .B [reconfig] (etykietka)
 321 Gdy wybrany jest ten element z menu, Blackbox ponownie czyta bie¿±ce
 322 pliki: menu i stylów, i stosuje zmiany.
 323 To przydaje siê, gdy stworzysz nowy styl lub temat, bo nie musisz
 324 ci±gle restartowaæ Blackboxa za ka¿dym razem, gdy nagrywasz swój
 325 styl.
 326 Chocia¿, Blackbox automatycznie czyta menu, gdy siê tylko ono
 327 zmieni.
 328 .TP
 329 .B [restart] (etykietka) {komenda pow³oki - opcjonalnie}
 330 To ka¿e Blackboxowi zrestartowaæ.
 331 Je¶li podana jest komenda, Blackbox koñczy i uruchamia komendê
 332 (która zwykle jest nazw± innego menad¿era okien).
 333 Je¶li komenda pow³oki nie by³a podana Blackbox uruchamia siê ponownie.
 334 .TP
 335 .B [config] (etykietka)
 336 Wstawia podmenu generowane przez Blackboxa zawieraj±ce wiele opcji
 337 konfiguracyjnych, takich jak: rozmieszczenie okien, sposób ich uaktywniania,
 338 przesuwania, itd.
 339 .TP
 340 .B [workspaces] (etykietka)
 341 To mówi Blackboxowi, ¿eby do³±czyæ podmenu "biurkowe" bezpo¶rednio
 342 do twojego menu.
 343 To jest przydatne u¿ytkownikom, którzy nie mog± bezpo¶rednio u¿yæ menu
 344 "biurkowego" (np. nie posiadaj± trzyprzyciskowej myszki).
 345 .PP
 346 Ka¿da linia zaczynaj±ca siê od '#' jest traktowana jak komentarz i pomijana
 347 przez Blackboxa.
 348 W polach etykietek/poleceñ/nazw plików mo¿esz u¿yæ znaków takich jak:
 349 .B (
 350 ,
 351 .B )
 352 ,
 353 .B {
 354 ,
 355 .B }
 356  poprzedzaj±c je
 357 .B \\\\
 358 , np.
 359 .EX
 360 [exec] (\\(my cool\\) \\{XTERM\\}) {xterm -T \\"cool XTERM\\"}
 361 .EE
 362 U¿ycie `\\\\' wstawi znak backslasha w pole etykietki/polecenia/nazwy pliku.
 363 .SS Przyk³ad menu
 364 Teraz po³±czymy razem kilka elementów.
 365 Tutaj krótki przyk³ad menu:
 366 .PP
 367 .nf
 368 # Blackbox menu file
 369 [begin] (Blackbox 0.62.1pre0)
 370   [exec] (rxvt) {rxvt -ls}
 371   [exec] (Mozilla) {mozilla}
 372   [exec] (The GIMP) {gimp}
 373   [submenu] (Window Manager)
 374     [exec] (Edit Menus) {nedit .blackbox/Menu}
 375     [submenu] (Style) {Which Style?}
 376       [stylesdir] (~/.blackbox/styles)
 377       [stylesmenu] (Blackbox Styles) {/usr/X11R6/share/blackbox/styles}
 378     [end]
 379     [config] (Config Options)
 380     [reconfig] (Reconfigure)
 381     [restart] (Restart)
 382   [end]
 383   [exit] (Log Out)
 384 [end]
 385 # end of menu file
 386 .fi
 387 .SH STYLE
 388 Blackbox pozwala ci u¿ywaæ wyspecjalizowanych plików zawieraj±cych zasoby
 389 .IR X (1).
 390 Mo¿esz w nich ustawiæ kolory, tekstury, czcionki, które wp³ywaj± na wygl±d
 391 obrze¿y okien, menu i paska tytu³owego.
 392 .PP
 393 Domy¶lna instalacja Blackboxa dostarcza klika plików stylów.
 394 Zwykle s± one umieszczane w
 395 .IR /usr/X11R6/share/blackbox/styles .
 396 Studiuj±c lub edytuj±c zawarto¶æ tych plików mo¿na siê dowiedzieæ, jak dzia³a
 397 mechanizma stylów w Blackboxie.
 398 Mo¿esz u¿yæ w menu
 399 .BR [style] ", " [stylesdir] " i " [stylesmenu]
 400 by móc wybieraæ i zmieniaæ miêdzy stylami w locie.
 401 .PP
 402 Mo¿esz te¿ utworzyæ katalog w swoim katalogu domowym (zwykle zwany
 403 .I ~/.blackbox/styles)
 404 i umie¶ciæ w nim w³asne pliki stylów.
 405 Oczywi¶cie mo¿esz dowolnie nazwaæ ten katalog, ale wiele tematów, które mo¿na
 406 ¶ci±gn±æ z internetu przyjmuje nazwê
 407 .I styles
 408 (popieraj±c schemat nazewnictwa bb.themes.org).
 409 .PP
 410 ¯eby zrozumieæ, jak dzia³a mechanizm stylów, musisz mieæ trochê wiedzy na temat
 411 zasobów X.
 412 .PP
 413 Zasoby X sk³adaj± siê z klucza i warto¶ci.
 414 Klucz jest zbudowany z wielu mniejszych kluczy (czasami zwanych potomkami)
 415 oddzielonych przez kropkê (`.').
 416 Klucze mog± tak¿e zawieraæ gwiazdkê (`*'), która pe³ni funkcjê d¿okera,
 417 co oznacza, ¿e jedna linia tekstu mo¿e pasowaæ do wielu kluczy.
 418 To siê przydaje, gdy style s± oparte na jednym lub dwóch kolorach.
 419 .PP
 420 Blackbox pozwala skonfigurowaæ swoje cztery g³ówne komponenty:
 421 pasek tytu³owy, slit (szczelinê ???), menu i dekoracje okien.
 422 .PP
 423 Okienko, które pokazuje wspó³rzêdne x-y, gdy siê przeci±ga okna, zapo¿ycza
 424 swój styl z paska tytu³owego przeci±ganego okna.
 425 .PP
 426 Kilka prostych przyk³adów:
 427 .EX
 428 toolbar.clock.color:    green
 429 .EE
 430 To ustawia zasób kolor zegara na pasku narzêdzi na `zielony'. Inny przyk³ad:
 431 .EX
 432 menu*color:     rgb:3/4/5
 433 .EE
 434 To ustawia zasób `color' menu
 435 .I i wszystkich `potomków'
 436 na `rgb:3/4/5'.
 437 (Opis nazw kolorów znajdziesz w
 438 .IR X (1).)
 439 Ten powy¿szy stosuje siê te¿ do
 440 .IR menu.title.color " i " menu.frame.color .
 441 A z
 442 .EX
 443 *font:  -b&h-lucida-medium-r-normal-*-*-140-*
 444 .EE
 445 ustawiasz zasób `font' dla wszystkich kluczy o tej nazwie na raz.
 446 (¯eby dowiedzieæ siê jakie czcionki s± zainstalowane w twoim systemie mo¿esz u¿yæ
 447 programów, takich jak:
 448 .IR xfontsel "(1), " gtkfontsel ", czy " xlsfonts "(1).)"
 449 .PP
 450 To, co czyni Blackboxa tak widowiskowym, jest jego zdolno¶c do renderowania tekstur
 451 w locie.
 452 Opis tekstury jest podany w podobny sposób jak opis kolorów przedstawiony wy¿ej,
 453 np.:
 454 .ta \w'toolbar.clock.colorTo:\ 'u
 455 .EX
 456 toolbar.clock:  Raised Gradient Diagonal Bevel1
 457 toolbar.clock.color:    rgb:8/6/4
 458 toolbar.clock.colorTo:  rgb:4/3/2
 459 .EE
 460 Nie przejmuj siê; zaraz to wyja¶nimy!
 461 Opis tekstury zawiera do piêciu pól, które s± nastêpuj±ce:
 462 .TP
 463 .B Flat / Raised / Sunken
 464 daje komponentowi p³aski, podniesiony albo zapadniêty wygl±d.
 465 .TP
 466 .B Gradient / Solid
 467 mówi Blackboxowi by rysowaæ teksturê z gradacj± albo rysowaæ j± jednolitym kolorem.
 468 .TP
 469 .B Horizontal / Vertical / Diagonal / Crossdiagonal / Pipecross / Elliptic / Rectangle / Pyramid
 470 Wybiera jedn± z tych tekstur. Dzia³aj± one tylko wtedy, gdy
 471 .B Gradient
 472 jest te¿ podany!
 473 .TP
 474 .B Interlaced
 475 mówi Blackboxowi by przeplataæ teksturê (¶ciemniaæ co drug± liniê).
 476 Opcja ta jest najczê¶ciej u¿ywana przy teksturach z gradacj±, chocia¿
 477 od wersji 0.60.3 dzia³a tak¿e w teksturach z jednolitym kolorem.
 478 .TP
 479 .B Bevel1 / Bevel2
 480 mówi Blackboxowi który typ bevel (co to jest bevel?) u¿yæ.
 481 Domy¶lnym jest Bevel1.
 482 Cieniowanie zaczyna siê na krawêdzi obrazka.
 483 Bevel2 jest alternatywny.
 484 Cieniowanie zaczyna siê jeden piksel od krawêdzi obrazka.
 485 .PP
 486 Zamiast opisu mo¿na u¿yæ opcji
 487 .B ParentRelative
 488 , która sprawia, ¿e komponent pojawia siê jako czê¶æ
 489 swojego rodzica (nadrzêdnego komponentu), np.
 490 ca³kowicie przezroczysta.
 491 .PP
 492 Wszystkie tekstury z gradacj± zbudowane s± z dwóch kolorów:
 493 .IR color " i " colorTo " ."
 494 color to pocz±tkowy kolor gradientu, colorTo - koñcowy.
 495 Gdy
 496 .B Interlaced
 497 jest u¿ywane w trybie
 498 .B Solid
 499 .I colorTo
 500 jest u¿ywane do podania koloru przeplotu.
 501 .PP
 502 Có¿, tutaj jest kompletna lista komponentów; tak¿e, wszystkie komponenty razem
 503 z rodzajami warto¶ci, które mog± przyjmowaæ.
 504 Komentarze s± poprzedzone znakiem wykrzyknika (!), który jest tak¿e u¿ywany
 505 do komentarzy w plikach stylów Blackboxa, jak i w plikach zasobów X.
 506 .PP
 507 .ta \w'window.button.unfocus.picColor:\ 'u
 508 .nf
 509 .\"
 510 .\" Komentarze tak¿e nale¿y t³umaczyæ!
 511 .\"
 512 ! Pasek narzêdzi.
 513 toolbar:        Tekstura
 514 toolbar.color:  Kolor
 515 toolbar.colorTo:        Kolor
 516
 517 ! Przyciski paska narzêdzi.
 518 toolbar.button: Tekstura albo \fIParentRelative\fR
 519 toolbar.button.color:   Kolor
 520 toolbar.button.colorTo: Kolor
 521
 522 ! Kolory strza³ek
 523 toolbar.button.picColor:        Kolor
 524
 525 ! Przyciski w stanie `wci¶niêty'
 526 toolbar.button.pressed: Tekstura \fI(np. Sunken)\fR albo \fIParentRelative\fR
 527 toolbar.button.pressed.color:   Kolor
 528 toolbar.button.pressed.colorTo: Kolor
 529
 530 ! Kolor, gdy wci¶niêty przycisk strza³ki.
 531 toolbar.button.pressed.picColor:        Kolor
 532
 533 ! Etykietka paska narzêdzi.
 534 toolbar.label:  Tekstura lub \fIParentRelative\fR
 535 toolbar.label.color:    Kolor
 536 toolbar.label.colorTo:  Kolor
 537 toolbar.label.textColor:        Kolor
 538
 539 ! Etykietka okna paska narzêdzi.
 540 toolbar.windowLabel:    Tekstura lub \fIParentRelative\fR
 541 toolbar.windowLabel.color:      Kolor
 542 toolbar.windowLabel.colorTo:    Kolor
 543 toolbar.windowLabel.textColor:  Kolor
 544
 545 ! Zegarek na pasku narzêdzi.
 546 toolbar.clock:  Tekstura lub \fIParentRelative\fR
 547 toolbar.clock.color:    Kolor
 548 toolbar.clock.colorTo:  Kolor
 549 toolbar.clock.textColor:        Kolor
 550
 551 ! W jaki sposób powinien byæ rozmieszczony tekst na pasku narzêdzi.
 552 toolbar.justify:        \fIcenter\fR, \fIleft\fR, albo \fIright\fR
 553
 554 ! Czcionka u¿ywana dla wszystkich komponentów paska narzêdzi.
 555 toolbar.font:   Czcionka \fI(np. -*-helvetica-medium-r-normal-*-*-100-*)\fR
 556
 557 ! Pasek tytu³owy menu.
 558 menu.title:     Tekstura
 559 menu.title.color:       Kolor
 560 menu.title.colorTo:     Kolor
 561 menu.title.textColor:   Kolor
 562 menu.title.font:        Czcionka
 563 menu.title.justify:     \fIcenter\fR, \fIleft\fR, albo \fIright\fR
 564
 565 ! Ramka menu.
 566 menu.frame:     Tekstura
 567 menu.frame.color:       Kolor
 568 menu.frame.colorTo:     Kolor
 569 menu.frame.textColor:   Kolor
 570 menu.frame.disableColor:        Kolor
 571 menu.frame.font:        Czcionka
 572 menu.frame.justify:     \fIcenter\fR, \fIleft\fR, or \fIright\fR
 573
 574 ! Kulki dla elementów podmenu.
 575 menu.bullet:    \fIempty\fR, \fItriangle\fR, \fIsquare\fR, lub \fIdiamond\fR
 576 menu.bullet.position:   \fIright\fR lub \fIleft\fR
 577
 578 ! Pod¶wietlony element menu.
 579 menu.hilite:    Tekstura (np. \fIRaised\fR)
 580 menu.hilite.color:      Kolor
 581 menu.hilite.colorTo:    Kolor
 582 menu.hilite.textColor:  Kolor
 583
 584 ! Aktywne okno.
 585 window.title.focus:     Tekstura
 586 window.title.focus.color:       Kolor
 587 window.title.focus.colorTo:     Kolor
 588
 589 ! Nieaktywne okno.
 590 window.title.unfocus:   Tekstura
 591 window.title.unfocus.color:     Kolor
 592 window.title.unfocus.colorTo:   Kolor
 593
 594 ! Etykietka okna.
 595 window.label.focus:     Tekstura albo \fIParentRelative\fR
 596 window.label.focus.color:       Kolor
 597 window.label.focus.colorTo:     Kolor
 598 window.label.focus.textColor:   Kolor
 599
 600 window.label.unfocus:   Tekstura albo \fIParentRelative\fR
 601 window.label.unfocus.color:     Kolor
 602 window.label.unfocus.colorTo:   Kolor
 603 window.label.unfocus.textColor: Kolor
 604
 605 ! Pasek z uchwytami do zmieniania rozmiarów okna.
 606 window.handle.focus:    Tekstura
 607 window.handle.focus.color:      Kolor
 608 window.handle.focus.colorTo:    Kolor
 609
 610 window.handle.unfocus:  Tekstura
 611 window.handle.unfocus.color:    Kolor
 612 window.handle.unfocus.colorTo:  Kolor
 613
 614 ! Uchwyty do zmieniania rozmiarów okna.
 615 window.grip.focus:      Tekstura
 616 window.grip.focus.color:        Kolor
 617 window.grip.focus.colorTo:      Kolor
 618
 619 window.grip.unfocus:    Tekstura
 620 window.grip.unfocus.color:      Kolor
 621 window.grip.unfocus.colorTo:    Kolor
 622
 623 ! Przyciski na pasku tytu³owym okna.
 624 window.button.focus:    Tekstura albo \fIParentRelative\fR
 625 window.button.focus.color:      Kolor
 626 window.button.focus.colorTo:    Kolor
 627 window.button.focus.picColor:   Kolor
 628
 629 window.button.unfocus:  Tekstura albo \fIParentRelative\fR
 630 window.button.unfocus.color:    Kolor
 631 window.button.unfocus.colorTo:  Kolor
 632 window.button.unfocus.picColor: Kolor
 633
 634 window.button.pressed:  Tekstura (np. \fISunken\fR)
 635 window.button.pressed.color:    Kolor
 636 window.button.pressed.colorTo:  Kolor
 637
 638 ! Ramka wokó³ okna.
 639 window.frame.focusColor:        Kolor
 640 window.frame.unfocusColor:      Kolor
 641
 642 ! Czcionka i justyfikacja dla etykiet okien.
 643 window.font:    Czcionka
 644 window.justify: \fIcenter\fR, \fIleft\fR, lub \fIright\fR
 645
 646 ! Ró¿ne zasoby.
 647
 648 ! Obrze¿e mo¿e byæ rysowane wokó³ wszystkich komponentów.
 649 borderWidth:    liczba pikseli, np. \fI1\fR
 650 borderColor:    Kolor
 651
 652 bevelWidth:     liczba pikseli > 0
 653 handleWidth:    liczba pikseli > 0
 654
 655 ! Szeroko¶æ ramki okna (od wersji 0.61 w³±cznie).
 656 ! Gdy nie podana frameWidth przyjmuje warto¶æ bevelWidth.
 657 frameWidth:     liczba pikseli >= 0
 658
 659
 660 ! To polecenie jest wykonywane za ka¿dym razem gdy wybierany jest styl.
 661 ! Zwykle ³adny wstawia ³adny obrazek do g³ównego okna.
 662
 663 rootCommand:    Polecenie pow³oki, np. \fIbsetroot -mod 4 4 -fg rgb:    5/6/6 -bg grey20\fR
 664
 665 ! Niektóre programy z bbtools wykorzystuj± te stare, pochodz±ce z wersji 0.51, zasoby.
 666 menuFont:       Czcionka
 667 titleFont:      Czcionka
 668 .fi
 669 .PP
 670 Có¿, wygl±da to na d³ug± listê, ale pamiêtaj, ¿e, gdy tworzysz swój w³asny styl,
 671 mo¿esz ³atwo ustawiæ wiele kluczy jedn± komend±, np.
 672 .EX
 673 .ta \w'*unfocus.textColor:\ 'u
 674 *color: slategrey
 675 *colorTo:       darkslategrey
 676 *unfocus.color: darkslategrey
 677 *unfocus.colorTo:       black
 678 *textColor:     white
 679 *unfocus.textColor:     lightgrey
 680 *font:  lucidasans-10
 681 .EE
 682 To s± mi³e oku domy¶lne ustawienia dla wielu komponentów.
 683 .SH THE SLIT (SZCZELINA)
 684 Slit jest specjalnym oknem Blackboxa, które zawiera dokowalne aplikacje, np.
 685 `bbtools' lub aplety Window Makera.
 686 Aplikacje wykonuj±ce siê w `szczelinie' nie posiadaj± w³asnych obramowañ;
 687 zamiast tego s± one oprawione w szczelinie i s± zawsze widoczne na pulpicie
 688 (biurku).
 689 Po klikniêciu przycisku 3 myszy (prawego) na krawêdzi szczeliny pojawi siê
 690 menu. Z tego menu mo¿na wybraæ po³o¿enie szczeliny na ekranie, czy aplikacje
 691 zawarte w szczelinie powinny byæ grupowane poziomo czy pionowo, i czy powinny
 692 siê ukrywaæ gdy przesunie siê wska¼nik myszy w inne miejsce.
 693 .PP
 694 Wiêkszo¶æ dokowalnych aplikacji u¿ywa opcji
 695 .B -w
 696 , ¿eby uruchomiæ siê w szczelinie.
 697 Na przyk³ad mo¿esz wstawiæ w swoim
 698 .IR ~/.xinitrc :
 699 .EX
 700 bbmail -w &
 701 bbpager -w &
 702 exec blackbox
 703 .EE
 704 Oczywi¶cie, ¿eby u¿ywaæ szczeliny musisz mieæ wkompilowan± jej obs³ugê
 705 (to jest domy¶lnie ustawione).
 706 .SH PLIK ZASOBÓW
 707 Zwykle plik
 708 .I ~/.blackboxrc
 709 jest tworzony i zarz±dzany przez Blackboxa.
 710 Wszystkie opcje menu z
 711 .B [config]
 712 (pocz±wszy od 0.60.x w³±cznie), ostatnio wybrany plik stylów, nazwy twoich
 713 biurek i inne s± automatycznie zapisywane w tym pliku.
 714 Aczkolwiek, s± tam zasoby, które mo¿esz edytowaæ samodzielnie:
 715 .TP
 716 .B session.menuFile:
 717 To mówi Blackboxowi gdzie szukaæ plku z menu.
 718 .TP
 719 .B session.screen0.toolbar.widthPercent:
 720 To decyduje ile procentowo miejsca zajmie pasek narzêdzi.
 721 Domy¶ln± warto¶ci± jest
 722 .IR 66 .
 723 .TP
 724 .B session.screen0.strftimeFormat:
 725 To decyduje w jaki sposób czas jest wy¶wietlany na pasku narzêdzi.
 726 Wykorzystywany jest format
 727 .IR strftime (3).
 728 Domy¶ln± warto¶ci± jest:
 729 .IR "%I:%M %p" .
 730 .TP
 731 .B session.autoRaiseDelay:
 732 To ustala opó¼nienie (w milisekundach). Po tym czasie okno, w którym znajduje
 733 siê wska¼nik myszy zostanie uaktywnione o ile wybrana by³a opcja Auto Raise
 734 (Automatyczne uaktywanianie).
 735 Domy¶ln± warto¶ci± jest:
 736 .IR 250 .
 737 .TP
 738 .B session.doubleClickInterval:
 739 ustala maksymalny odstêp (w milisekundach) pomiêdzy dwoma klikniêciami myszy,
 740 by by³y one traktowane jako podwójne klikniêcie.
 741 Domy¶ln± warto¶ci± jest:
 742 .IR 250 .
 743 .TP
 744 .B session.screen0.edgeSnapThreshold:
 745 Gdy przemieszczasz okno po ekranie, Blackbox jest w stanie szybko dosun±æ
 746 je do krawêdzi ekranu. U³atwia to rozmieszczanie okien.
 747 Ta zmienna ustala odleg³o¶æ (w pikselach), przy której okno bêdzie dosuwane
 748 do krawêdzi ekranu.
 749 Domy¶ln± warto¶ci± jest:
 750 .IR 0 .
 751 .TP
 752 .B session.cacheMax:
 753 mówi Blackboxowi ile pamiêci (w kB) mo¿e zu¿yæ na buforowanie obrazków
 754 (piksmap) na serwerze X.
 755 Je¶li twojej maszynie brakuje pamiêci mo¿esz zmniejszyæ tê warto¶æ.
 756 Domy¶lnie jest:
 757 .IR 200 .
 758 .TP
 759 .B session.cacheLife:
 760 mówi Blackboxowi jak d³ugo (w minutach) nieu¿ywane obrazki maj± pozostawaæ
 761 w pamiêci serwera X.
 762 Domy¶ln± warto¶ci± jest:
 763 .IR 5 .
 764 .TP
 765 .B session.colorsPerChannel:
 766 ustala ile kolorów wzi±æ z serwera X w trybie pseudokolor. Kana³ mo¿e byæ
 767 czerwony, zielony lub niebieski.
 768 Blackbox przydzieli (warto¶æ tej zmiennej) ^ 3 (do potêgi trzeciej) kolorów,
 769 które bêd± zawsze dostêpne.
 770 Warto¶æ ta musi byæ miêdzy 2 a 6.
 771 Gdy u¿ywasz Blackboxa na displeju w trybie 8-bitowym, warto¶æ tego zasobu
 772 musi byæ równa 4.
 773 Domy¶lnie jest:
 774 .IR 4.
 775 .PP
 776 Gdy u¿ywasz wielu pulpitów (biurek) oprócz
 777 .B screen0
 778 mo¿esz u¿yæ tak¿e kluczy
 779 .B screen1, 2
 780 itd. dla odpowiednich pulpitów.
 781 .SH ZMIENNE ¦RODOWISKOWE
 782 .TP
 783 .B HOME
 784 Blackbox u¿ywa
 785 .RB $ HOME
 786 ¿eby znale¼æ plik
 787 .I .blackboxrc
 788 i odszukaæ plik stylów oraz nazwy katalogów.
 789 .TP
 790 .B DISPLAY
 791 Gdy ¿aden inny displej nie jest podany w linii poleceñ, Blackbox wykorzysta
 792 displej z tej zmiennej.
 793 .SH AUTOR i ZAS£U¯ENI
 794 Ca³y kod by³ na pocz±tku napisany i rozwijany przez Brada Hughesa
 795 .nh \" hyphenation off
 796 (blackbox@alug.org)
 797 .hy \" on again
 798 a potem Jeffa Ravena
 799 .nh
 800 (jraven@psu.edu).
 801 .hy
 802 Obecnie maintainerem jest Sean 'Shaleh' Perry
 803 .nh
 804 (shaleh@debian.org)
 805 .hy
 806 z udzia³em i poprawkami wielu indywidualno¶ci z ca³ego ¶wiata.
 807 .PP
 808 Oficjalna strona Blackboxa:
 809 .nh
 810 .B http://blackbox.alug.org/
 811 .hy
 812 .br
 813 B³êdy i usprawnienia nale¿y zg³aszaæ na:
 814 .nh
 815 .B http://sf.net/projects/blackboxwm
 816 .hy
 817 .br
 818 Tam te¿ mo¿na znale¼æ aktualn± wersjê Blackboxa.
 819
 820 Wiele tematów i innych dodatków:
 821 .nh
 822 .B http://bb.themes.org/
 823 .hy
 824 .PP
 825 Ta strona manuala zosta³a posk³adana przez Wilberta Berendsena
 826 .nh
 827 (wbsoft@xs4all.nl).
 828 .hy
 829 Wiele innych wersji jêzykowych bêdzie dostêpnych.
 830 .SH T£UMACZENIE
 831 Witold Filipczyk (juandon@pld.org.pl)
 832 .SH ZOBACZ TAK¯E
 833 .IR bsetroot (1), \ bbkeys (1)  \" nie tutaj, jeszcze ;-(