Autor: Jeremy Reed
Polskie tłumaczenie: Tomasz 'zolvio' Korzeniak. Jeśli zauważysz jakieś błędy lub nieścisłości, skontaktuj się ze mną: zolvio@interia.pl

Oryginalny dokument w języku angielskim znajduje się tu (Original document in English): http://www.reedmedia.net/misc/blackbox/faq.html

Tłumaczenie rosyjskie (russkij jazyk): http://gazette.linux.ru.net/etc/bb-faq.html. (Poprzednio na http://alterart.boom.ru/linux/bb-faq.html.) (Podziękowania dla: Pavel < cobalt @ non-conformism.com >.)

Tłumaczenie na język francuski (francais): http://tranber1.free.fr/bb_faq_fr-0.2.html

Od autora (Jeremy Reed): Informacja zebrana z list dyskusyjnych, mailingowych, innych źródeł i od różnych osób: John Kennis, Gregory J. Barlow, beef(niggard.org), Brett Williams, Bradley T. Hughes, Steve Carter, Chris Brown, Aaron M., David W. Talmage, Kevin Miller, Brock Sides, Jesse Becker, Jan Ruediger, Matthew R. Briggs, Mark Charlebois, s_rasul, Sean 'Shaleh' Perry, Matthew Weier O'Phinney, i wielu innych.. (oficjalna strona: http://blackboxwm.sourceforge.net/.)

I have used Blackbox for over three years and I have not tried all the options, tools or patches. Please send any clarifications and suggestions for this FAQ to jeremy@reedmedia.net. Please do not send questions to me, unless you have an answer with it; consider reading this FAQ and the manual page, and then asking the mailing list if you have questions.

1 Ogólne
1.1 Czym jest Blackbox?
1.2 Czym jest menedżer okien?

2 Skróty klawiaturowe
2.1 Dlaczego nie mogę używać klawiszy do zmieniania okien? Modyfikatory (Modifiers) ani skróty klawiaturowe nie działają. Co stało się z obsługą skrótów klawiaturowych?
2.2 Jak mogę definiować skróty klawiaturowe służące do zmiany okien?
2.3 Co to jest Mod1?
2.4 Jakie są powszechnie stosowane skróty klawiaturowe?
2.5 Skróty klawiaturowe się gubią, np. CTRL-S nie wywołuje polecenia 'save' w nedit.
2.6 Czy mogę otwierać menu za pomocą klawiatury?

3 Instalacja
3.1 W jaki sposób mogę automatycznie uruchomić program xyz?
3.2 Jak mogę skompilować Blackboksa pod systemami Solaris lub SunOS?

4 Różne
4.1 Kiedy zminimalizuję okno, nie widzę aplikacji. Gdzie są ikony?
4.2 Czy mogę umieścić ikony na pulpicie Blackboksa?
4.3 Przesuwanie i odświeżanie zawartości okien jest bardzo wolne. Co robić?
4.4 Czy da się uruchamiać aplikacje z zadaną lokalizacją i/lub rozmiarem?
4.5 Czy są jakieś domyślne/globalne opcje, które zmuszają Blackboksa do pamiętania położenia, rozmiaru, atrybutów itp. właściwości okien?

5 Używanie
5.1 Jakie operacje można wykonywać myszką?
5.2 Jak mogę zmienić tło?
5.3 Czy da się ustawić inny obraz dla każdego pulpitu wirtualnego?
5.4 Do czego służy opcja Stick w menu okna?
5.5 W jaki sposób przywrócić zminimalizowane okno aplikacji?
5.6 Jak zmienić rozmiar lub przesunąć pasek narzędzi (toolbar)? W jaki sposób mogę umieścić pasek na górze ekranu, zamiast na dole?
5.7 Czy da się usunąć pasek?
5.8 Jak zmienić rozmiar okna?
5.9 Jak spowodować żeby okno po maksymalizacji zajmowało cały ekran?
5.10 Dlaczego okna wskakują pod pasek / slit. Jak zapewnić, żeby otwierające się okna nie przykrywały paska/ slitu?
5.11 Jak zmaksymalizować okno pionowo? Jak zmaksymalizować poziomo, przez całą szerokość ekranu?

6 Wsparcie dla innych środowisk graficznych
6.1 Kpanel (lub inne aplikacje KDE) nie działąją prawidłowo.
6.2 Co ze wsparciem dla GNOME?

7 Slit
7.1 Czym jest Slit?
7.2 Jak mogę włączyć slit?
7.3 Do czego służy menu rozwijane przez kliknięcie na slicie? Jak ustalić położenie slitu?

8 Konfiguracja
8.1 Wyedytowałem plik konfiguracyjny .blackboxrc, lecz po ponownym zalogowaniu moje ustawienia zniknęły.
8.2 W jaki sposób uzyskać pustą pozycję w menu (separator)?
8.3 Jakie są dostępne opcje "fokusu" (uaktywniania okna)?
8.4 Jak ustawić, żeby okno uaktywniało się po określonym czasie wskazywania myszą, np. 500 ms?
8.5 Jak spowodować, żeby okno nowo uruchamianego programu automatycznie było uatywniane?
8.6 W jaki sposób główny pasek (toolbar) wyświetla datę i czas?
8.7 Jak mogę zmusić Blackboksa aby automatycznie tworzył drugi pulpit wirtualny przy starcie?

9 Łatki (patche)
9.1 Gdzie mogę znaleźć dodatki (patche) do Blackboksa?
9.2 Jak używać łatek?

10 Tematy/Style
10.1 Gdzie znajdę więcej stylów i tematów?
10.2 Niektóre style mają przezroczyste paski tytułu i inne dziwne rzeczy. Co się stało?

1.1 Czym jest Blackbox?
Blackbox jest menedżerem okien dla X Window.

1.2 Czym jest menedżer okien?
Menedżer okien to program, który kontroluje wygląd i zachowanie okien na ekranie. Menedżer okien jest po prostu jednym z wielu klientów X Window, lecz jest on w stanie zapewnić wygodę i łatwość obsługi całego graficznego interfejsu użytkownika, np. wyglądu i sposobu obsługi ramki okien czy pasków tytułu; dostarcza menu dla szybkiego i dogodnego uruchamiania programów lub wybierania opcji konfiguracyjnych, umożliwia nakładanie okien, zmianę ich rozmiaru, kształtu i wielu inych opcji. Menedżer okien kontroluje także, które z okien jest aktywne (ma "focus") oraz umożliwia zamykanie, zabijanie (killowanie), ukrywanie, minimalizowanie, maksymalizowanie i zmianę kształtu okien.

2 Skróty klawiaturowe
2.1 Dlaczego nie mogę używać klawiszy do zmieniania okien? Modyfikatory (Modifiers) ani skróty klawiaturowe nie działają. Co stało się z obsługą skrótów klawiaturowych?
Począwszy od wersji 0.60.x, Blackbox nie zapewnia obsługi skrótów klawiaturowych. Do tego służy odrębny program, np. bbkeys (http://movingparts.thelinuxcommunity.org/bbkeys.shtml). Blackbox ma być docelowo zgodny z ICCCM (Inter-Client Communications Conventions Manual).

2.2 Jak mogę definiować skróty klawiaturowe służące do zmiany okien?
Zastosuj program bbkeys, albo jeżeli używasz starej wersji (przed 0.60), spróbuj wpisać w swoim pliku .blackboxrc np.

Dostępne możliwości: Shift, Lock, Control, Mod1, Mod2, Mod3, Mod4, Mod5

2.3 Co to jest Mod1?
Mod1 to zazwyczaj Alt. Jest to modyfikator stosowany do przełączania pomiędzy oknami i pulpitami, w Twoim komputerze może to być domyślnie Alt .

2.3 Co to jest Mod1?
Mod1 to zazwyczaj Alt. Jest to modyfikator stosowany do przełączania pomiędzy oknami i pulpitami, w Twoim komputerze może to być domyślnie Alt .

2.4 Jakie są powszechnie stosowane skróty klawiaturowe?
Nowsze wersje Blackboksa nie posiadają obsługi skrótów klawiaturowych. Aby ich używać, musisz zastosować odrębny program, bbkeys. (patrz wyżej). Poniżej są skróty powszechnie stosowane w starszych wersjach (przed 0.60):
Każde naciśnięcie Alt-TAB na obszarze pulpitu nie zakrytym żadnym oknem (tzw. "root window") przełącza pomiędzy aktywnymi oknami.
Shift-Alt-TAB działa analogicznie jak Alt-TAB, lecz okna są przełączane w odwrotnej kolejności.
Kombinacja Ctrl-Alt-{strzałka w lewo, strzałka w prawo} przełącza pomiędzy pulpitami (workspaces).

2.5 Skróty klawiaturowe się gubią, np. CTRL-S nie wywołuje polecenia 'save' w nedit.
Spróbuj wyłączyć Num Lock i Caps Lock spod aplikacji wywołującej problemy.

2.6 Czy mogę otwierać menu za pomocą klawiatury?
Nie jest to obecnie możliwe. Ten temat był szeroko dyskutowany i miejmy nadzieję, że będzie to możliwe w przyszłości.

3 Instalacja
3.1 W jaki sposób mogę automatycznie uruchomić program xyz?
Możesz go uruchomić przed startem Blackboksa poprzez wpis do pliku .xinitrc lub .xsession.

Przykład pliku ~/.xsession:

#!/bin/sh

loadmeter -override -geom 40x94+1+382 &
rxvt -fn 6x13 -geometry 80x24+45+25 &

exec blackbox

3.2 Jak mogę skompilować Blackboksa pod systemami Solaris lub SunOS?
Wersje 0.65.0 i późniejsze powinny się bezproblemowo kompilować pod Solarisem. W starszych wersjach spróbuj: w pliku Makefile, dodaj

-fpermissive 

w CXXFLAGS. Dodaj to do Makefile w src/ i w util/.

Spróbuj następujących opcji z

./configure --x-includes=/usr/openwin/include and --x-libraries=/usr/openwin/lib. 

W zasadzie, gcc nie lubi starego typu plików nagłówkowych do X pod Sunem. Możesz obejść ten problem, robiąc kopie plików nagłówkowych i naprawić je, dodając do wszystkich prototypów deklarację typu zwracanego jako int. Następnie zastosuj:

 ./configure --x-includes= 

4 Różne
4.1 Kiedy zminimalizuję okno, nie widzę aplikacji. Gdzie są ikony?
Blackbox został zaprojektowany jako minimalistyczny, dlatego nie wspiera ikon. Jeżeli coś "zmniejszasz do ikony" (Iconify) to oznacza, że "nie chcesz tego w tej chwili widzieć". Możesz zamiast tego spróbować ukrywania okna (Shade). Ikony są dostępne z poziomu menu Blackboksa: -> Workspace List -> Icons. (Możesz oderwać ten fragment menu lewym przyciskiem myszy i przeciągnąć w dowolne miejsce ekranu. To menu jest też dostępne przez kliknięcie środkowym przyciskiem myszy na obszarze pulpitu).

4.2 Czy mogę umieścić ikony na pulpicie Blackboksa?
Blackbox zasadniczo nie umożliwia obsługi ikon, lecz możesz zastosować odpowiedni program np: kfm (menedżer plików KDE), gmc (menedżer plików GNOME), xfm (menedżer plików dla X), ROX, dfm ...
(Jeżeli używasz dfm, to domyślne ustawnienia tego programu powodują, że kliknięcie na obszarze pulpitu rozwija menu dfm, a nie menu Blackboksa. Możesz to zmienić, odznaczając w menu "dfm x11" pozycję "desktop context menu".)

4.3 Przesuwanie i odświeżanie zawartości okien jest bardzo wolne. Co robić?
Używanie stylu, który w zasobie window.frame ma gradient, może powodować powolne odswieżanie na słabszych komputerach. Zmiana tego zasobu na Raised Solid lub podobny w znaczącym stopniu zwiększy szybkość.
A także... wyedytuj styl, którego używasz, np. /usr/local/share/Blackbox/styles/default, i ustaw moveStyle na Wire zamiast Opaque.
Inny sposób na przyspieszenie Blackboksa:

strip blackbox

4.4 Czy da się uruchamiać aplikacje z zadaną lokalizacją i/lub rozmiarem?
Spróbuj opcji -geometry lub innych opcji linii poleceń służących do ustalania położenia i rozmiaru podczas uruchamiania programów. Albo zastosuj bbappconf lub bblaunch.

4.5 Czy są jakieś domyślne/globalne opcje, które zmuszają Blackboksa do pamiętania położenia, rozmiaru, atrybutów itp. właściwości okien?
Blackbox nie posiada zarządzania sesją (Session management). Aby zachować ustawienia, spróbuj pobrać informacje z programów xwininfo, xlsclients i xprop (w archiwum możesz znaleźć pomysły z bbsnapshot) a następnie uruchom bblaunch lub bbappconf wykorzystując te informacje.

5 Używanie
5.1 Jakie operacje można wykonywać myszką?
Podwójne kliknięcie lewym przyciskiem na pasku tytułu przełącza okno do trybu paska (Shade).
Analogicznie działa Ctrl+lewy przycisk.
Prawy przycisk myszy (lub Crtl+prawy przycisk) na pasku narzędzi rozwija menu umożliwiające m.in. zmianę nazwy bieżącego pulpitu wirtualnego.
Kliknięcie prawym przyciskiem myszy na obszarze pulpitu rozwija główne menu.
Kliknięcie prawym przyciskiem myszy na pasku tytułu okna udostępnia menu okna.
Naciśnięcie lewym klawiszem myszy przycisku maksymalizacji powiększa okno na cały ekran, prawy - w poziomie (horyzontalnie), zaś środkowy - w pionie (wertykalnie).
Kliknięcie środkowym przyciskiem na pasek tytułu deaktywuje okno.
Prawy przycisk myszy służy także do chowania menu.

5.2 Jak mogę zmienić tło?
Blackbox zawiera narzędzia bsetbg i bsetroot, służące do ustawiania tła. Możesz zastosować inne programy, np. wmsetbg, XV, xsetroot, Esetroot, xli, ImageMagick's display i wiele innych. Na przykład:

xv -root -quit -max -smooth ~/blackbox/styles/LoveHewett/Love1.jpg

lub

display -window root /home/fred/images/animals/cougar01.jpg

5.3 Czy da się ustawić inny obraz dla każdego pulpitu wirtualnego?
Niestety nie.

5.4 Do czego służy opcja Stick w menu okna?
Służy do "przyklejania" okna aplikacji do pulpitu, tak że będzie widoczne na wszystkich pulpitach wirtualnych.

5.5 W jaki sposób przywrócić zminimalizowane okno aplikacji?
Środkowy przycisk myszki wywołuje menu, w którym znajduje się pozycja 'Icons', zawierająca listę zminimalizowanych aplikacji.

5.6 Jak zmienić rozmiar lub przesunąć pasek narzędzi (toolbar)? W jaki sposób mogę umieścić pasek na górze ekranu, zamiast na dole?
(fragment pliku .blackboxrc )

session.screen0.toolbarWidthPercent:    [0-100] ; percentage
session.screen0.toolbarPlacement:       [bottom|top]

Położenie paska można ustawić także za pomocą menu rozwijanego po kliknięciu prawym przyciskiem myszy na pasku.

5.7 Czy da się usunąć pasek?
Łatka służąca do usuwania paska jest do pobrania z http://blackbox.linuxbox.com/

5.8 Jak zmienić rozmiar okna?
Kliknij lewym przyciskiem myszy na jeden z dolnych narożników okna (uchwytów) i przeciągnij do żądanego rozmiaru. Innym sposobem jest naciśnięcie klawisza "Mod" (z reguły jest to Alt), kliknięcie prawym przyciskiem myszy i przeciągnięcie do odpowiedniego rozmiaru. W obydwu przypadkach pokaże się małe okienko dialogowe wyświetlający rozmiar okna aplikacji, ponadto wskaźnik myszy zmieni się na kątowy.

5.9 Jak spowodować żeby okno po maksymalizacji zajmowało cały ekran?
Wybierz opcję "Full Maximization" z menu Blackbox -> Configuration oraz odznacz "Always on top" w menu konfiguracji paska.

5.10 Dlaczego okna wskakują pod pasek / slit. Jak zapewnić, żeby otwierające się okna nie przykrywały paska/ slitu?
Wybierz opcję "Always on top" w menu konfiguracji paska; odznacz "Full Maximization" z menu Blackbox -> Configuration.

5.11 Jak zmaksymalizować okno pionowo? Jak zmaksymalizować poziomo, przez całą szerokość ekranu?
Kliknij myszką na przycisk maksymalizacji: Środkowym spowodujesz maksymalizację w pionie, prawym w poziomie, natomiast lewy przycisk zapewni powiększenie okna na cały ekran, zobacz także opis opcji "Full Maximalization" powyżej.

6 Wsparcie dla innych środowisk graficznych
6.1 Kpanel (lub inne aplikacje KDE) nie działąją prawidłowo.
Skompiluj Blackboksa ze wsparciem dla KDE:

./configure --enable-kde

Jeśli masz Blackboksa z kde-support, a kpanel nie działa, możesz spróbować:

kpanel -no-KDE-compliant-window-manager

Więcej informacji na temat używania KDE pod Blackboksem znajdziesz w Integrating KDE and Blackbox HOWTO : http://www.draknor.net/kbb/howto/index.html.

6.2 Co ze wsparciem dla GNOME?
Możesz dodać minimalne wsparcie dla GNOME stosując łatkę pobraną z: http://gnome.windsofstorm.net.

7 Slit
7.1 Czym jest Slit?
Slit (dosłownie "szczelina") jest oknem służącym do zaczepiania aplikacji dokujących w stylu WindowMakera.
Slit będzie widoczny tylko wtedy, jeśli będziesz używać aplikacji dokujących.
Aplikacja dokująca (dockapp) jest zwykłym programem, który wykonuje zazwyczaj jakąś pojedynczą operację, np. wyświetla czas lub użycie procesora. Aplikacje dokujące można uruchamiać bezpośrednio; są one widoczne w postaci małych okienek w jakimkolwiek menedżerze okien.
Szczególną cechą aplikacji dokujących jest to, że mogą tracić niektóre cechy typowe dla okien programów, np. paski tytułu, paski przesuwu, uchwyty itp. Z drugiej strony, zazwyczaj są one przyczepione do panelu dokującego (Wharf/Dock/Slit). Dzięki temu są zawsze widoczne na ekranie, bez względu na aktualnie używany pulpit wirtualny; ponadto są zgrupowane i nie trzeba ich szukać po całym ekranie; czasami można je tak skonfigurować, żeby były zawsze na wierzchu.
Aktualnie, wszystkie aplikacje dokujące WindowMakera oraz aplikacje napisane pod AfterStep (wykorzystujące "wharf") działają pod Blackboksem.
Aplikacje dokujące można pobrać z: http://bbtools.windsofstorm.net
http://bensinclair.com/dockapp/
http://windowmaker.mezaway.org/
http://www.linuks.mine.nu/dockapp

Zrzuty ekranu: http://blackbox.wiw.org/screenshots/blackbox-theme.{gif,jpg,tif}
http://themes.org/current/FORTYoz-current.jpg
(located on the far right side, center screen.)

[nop] (--------)

[nop]

session.screen#.focusModel: AutoRaiseSloppyFocus
session.autoRaiseDelay: 500

session.screen0.strftimeFormat: %I:%M%P %m/%d/%y

session.screen0.strftimeFormat: %I:%M %p

patch -p0 &li; name.patch

gzip -cd name.patch.gz | patch -p0

-p0 : blackbox/src/Window.cc
-p1 : src/Window.cc
-p2 : Window.cc