Blackbox は Open Group の X Window System Ver. 11 Release 6 以降のためのウィンドウマネージャの一つです。Blackbox は C++ で書か れていて画像処理こそ Window Maker に似ていますがそれを除いて他のど のウィンドウマネージャともコードを共有しません。Blackbox は Bradley T. Hughes (bhughes@tcac.net)とJeff Raven(jraven@psu.edu)に よって書かれています。

この文書はAnthony Deaver(bishop@themes.org)、Jason Collins(jdc@themes.org)、そして Blackbox のプログラマのprogrammers Bradley T. Hughes(bhughes@tcac.net)とJeff Raven(jraven@psu.edu)が 保守しています。

The Blackbox.Themes.Org Staff is:

もしBlackbox Guideに貢献したいと思ったならe-mailをbb@themes.orgまでコメント、意見、 追補などを添えて送って下さい。

このガイドがBlackboxのv0.5x.xシリーズのために書かれていること に注意して下さい。ベータ版の0.6x.xシリーズのためのガイドはまだ編集 中です^[1]。

Blackboxはftp://blackbox.wiw.org/pub/blackbox/ からダウンロードできます。ダウンロートしたらコンパイルしたいディレ クトリ内にファイルを置いて、次のように入力します:

    bash$ tar zxvf blackbox-x.xx.x.tar.gz          (1)
   

ファイルを展開した後でできたディレクトリ内に cdします。

Blackbox をコンパイルする方法は次のとおりです:

configureシェルスクリプトはコンパイル時の システム依存のさまざまな変数に対する正しい値を推測します。そして Blackboxの各ディレクトリ内にMakefileを生成する のにこれらの値を使います。

最終的に、将来そのときの調整項目を再構築するためのシェルスク リプトconfig.status、再び configureを実行するときの速度を速めるために結果 を保存するconfig.cache、そして コンパイラの出 力を含んでいるconfig.log(主に configureのデバッグをするのに便利です)を生成しま す。

もしあなたが Blackbox をコンパイルするのに特殊な作業が必要な ら configure がチェックしているかどうか明確にして diff か説明を bhughes@tcac.net に送って下されば次のリリースに入れるかどうかを考え ることができす。もし何か保存しておきたくないものが config.cacheに含まれていれば消すか編集して下さ い。configure.inはautoconf というプログラムによってconfigureを生成するのに 使われます。configure.inはあなたがより新しいバー ジョンのautoconfを使って、 configureを変更するか再生成するときにだけ必要と なります。

いくつかのシステムではconfigureスクリプト が関知しない、コンパイルあるいはリンクのための特殊なオプションを必 要とします。変数について configure 初期値を環境 変数で定義できます。Bourne 互換シェルを使っているならコマンドライン で次のようにします:

    bash$ CC=c89 CFLAGS=-O2 LIBS=-lposix ./configure
   

あるいはenvプログラムを持つシステム上では 次のようにもできます:

    bash$ env CPPFLAGS=-I/usr/local/include LDFLAGS=-s
    bash$ ./configure
   

Blackbox はいくつかの configure オプション でその機能特性を変えてコンパイルすることができます:

Blackbox は実行時に指定することのできるいくつかのコマンド行オ プションを持っています。blackbox -display[display] とすれば Blackbox は指定されたディスプ レイ(例えば :1.0)で実行されます。blackbox --versionとすると Blackbox のバージョン情報が表示されます。 blackbox --helpとするとコマンド行オプションを表 示します。さらにバージョン 0.51 で追加されたものとして、 blackbox -rc [file] とすると Blackboxは ~/.blackboxrc以外の初期化ファイルを読み込んで 起動します。

他のウィンドウマネージャと同じようにウィンドウを制御する一番 のツールがウィンドウの上部のバーです。このバーにはウィンドウタイト ルが表示され、最小化、最大化、終了の三つのボタンがついています。最 小化ボタンは左側に、他の二つのボタンは右側にあります。ウィンドウは フルスクリーン、垂直方向、水平方向の三つの方法で最大化できます。最 大化ボタンを左クリックすると両方向に、中央クリックすると垂直方向に、 右クリックすると水平方向に最大化されます。ウィンドウのタイトルバー の中央を左マウスボタンでダブルクリックするとウィンドウはシェード(折 畳む)されます。ウィンドウを左クリックすると前面に出、中央クリックす ると後面に下がります。ウィンドウのタイトルバーを右クリックするとよ り多くのウィンドウ操作が次のようなメニューを通じて利用可能になりま す:

Send to ...メニューはウィンドウを 移動させたいデスクトップの名前を選択し、デスクトップ間でウィンドウ を移動させることができます。ウィンドウを閉じるKill Clientを除いた他のすべては上のようにそれぞれに記述さ れたとおりのことができます。ウィンドウはタイトルバーあるいはウィン ドウの外周のフレームのどこかを移動させたい方向にクリック、トラッグ して移動できます。ウィンドウ移動時にはウィンドウの上部左隅の座標が 画面中央に表示されます。ウィンドウの下部の隅をクリック、ドラッグし て好みの大きさにリサイズすることができます。ウィンドウの大きさはそ の間に画面中央に表示されます。

ツールバーは現在のワークスペース名、フォーカスされているウィ ンドウのタイトル名、そして時計とワークスペースと現在のワークスペー ス内のウィンドウ間を移動するためのボタンを表示します。ツールバーの 一番左側のラベルには現在のワークスペース名が表示されています。名前 を変えるにはラベルの上で右クリックし、名前を入力し、 Enterを押します。もしまちがってこのラベル上で右ク リックし、名前を変えたくないときは単に Enterを押せ ば名前は変わりません。このラベルの右側のボタンでワークスペース間を 移動します。ワークスペースについての詳細は後述のワークスペースの節 を参照して下さい。これらのボタンの右側のラベルには現在フォーカスさ れたウィンドウのタイトル名が表示されます。さらにこのラベルの右側に は現在のワークスペース内でのウィンドウを切り替えるためのボタンがあ ります。時計はこれらのボタンの右側にあります。時計を設定の詳細な情 報については基本的設定の節を参照して下さい。デフォルトではツールバー はすべてのアプリケーションよりも前面に表示されます。もし後面に下げ たいならツールバー上で中央クリックして下さい。

Blackbox にはウィンドウメニュー、ワークスペースメニュー、ルー トメニューの三つの基本メニューがあります。前述のウィンドウの節で詳 細について述べている、ウィンドウメニューはウィンドウのフレーム上で 右クリックすると表示されます。このメニューは編集不可です。ルートウィ ンドウで中央クリックすると表示される、ワークスペースメニューはすべ てのワークスペースと各ワークスペースにあるウィンドウのリストを表示 します。またこのメニューはワークスペースに加えて最小化、あるいはア イコン化されたウィンドウを表示します。さらにこのメニューによってワー クスペースを追加したり減らしたりできます。ワークスペースメニューも ユーザによる編集は不可です。ルートウィンドウで右クリックすると表示 されるルートメニューは唯一ユーザによる編集の可能なメニューです。こ のメニューでプログラムを実行したり、ウィンドウマネージャを再設定、 あるいは再起動したり、スタイルを変えたり、終了したりできます。ルー トメニューの設定の詳細については後述のメニュー設定の節を参照して下 さい。ワークスペースメニューとルートメニューは両方ともピン止めでき、 開かれたまま移動することができます。ピン止めされたメニューを閉じる にはメニューを右クリックするか、ルートウィンドウを左クリックします。

Blackbox ではたいていのウィンドウマネージャと同じように複数の ウィンドウの属するワークスペースを持つことができます。ワークスペー スの切り替えはさまざまな方法で行うことができます。まずツールバーの 左側のボタンでワークスペースを循環できます。ショートカットキーで同 様のことができます。ショートカットキーは ~/.blackboxrcで定義されます。設定の詳細につい ては後述の基本設定を参照して下さい。デフォルトでは [Ctrl + →(←)] でワークスペースを切り替えられます。最後にルートウィンドウで中央ク リックし、ワークスペースメニューから切り替えたいワークスペース名を 選択することでワークスペースを切り替えられます。ワークスペースを追 加、削除するのにもこのメニューを使います。ワークスペース名を変える には、そのワークスペースに切り替えて、ツールバーのワークスペース名 ラベルの上で右クリックすると変えることができます。好みの名前にして [Enter] を押して下さい。

もっとも基本的な Blackbox のカスタマイズはユーザ固有の設定ファ イルである、~/.blackboxrcで行ないます。このファ イルは初めてBlackbox を起動した後の終了時に生成され、毎回 Blackbox を再起動、あるいは終了するときに書き込まれます。このファイルを編集 したいなら Blackbox は再起動、あるいは終了時にメモリ内に保持された オプションについてこのファイルを上書きするので、必ずBlackbox が実行 されていないときに編集しなければなりません。この節の残りでは ~/.blackboxrc内で利用可能なオプションと各オプ ションについての設定にフォーカスします。次はこのファイルの単純な例 です:

    session.screen0.workspaces: 1
    session.screen0.toolbarOnTop: False
    session.screen0.toolbarWidthPercent: 66
    session.screen0.windowPlacement: SmartPlacement
    session.screen0.slitPlacement: CenterRight
    session.screen0.focusModel: SloppyFocus
    session.screen0.strftimeFormat: %I:%M %p
    session.screen0.workspaceNames: Workspace 1
    session.menuFile: /usr/local/share/Blackbox/menu
    session.windowCycleModifier: Mod1
    session.colormapFocusModel: Click
    session.colorsPerChannel: 4
    session.doubleClickInterval: 250
    session.workspaceChangeModifier: Control
    session.autoRaiseDelay: 250
    session.styleFile: /usr/local/share/Blackbox/styles/default
    session.imageDither: True
    session.moveStyle: Opaque
   

Blackbox のルートメニューを定義するのはシンプルなテキストファ イルです。最初はユーザのカスタマイズメニューをつくるのにデフォルト メニューをホームディレクトリにコピーして編集すると便利です。例えば 次のようにします:

    bash$ mkdir ~/.blackbox
    bash$ cp /usr/local/share/Blackbox/menu ~/.blackbox/Menu
   

けれどもこのファイルはユーザが Blackbox を実行するさいに書き 込みのできさえすればどこでも好きな場所に置けます。

次にこのファイルをメニューファイルとして使うために ~/.blackboxrc内の session.menueFile 行を編集し てあなたのメニューファイルへの絶対パスを指定します。

メニューの構文はとても単純で実際的なものです。メニュー行に は最大 3 つまでのフィールドがあります。それらは次のような形式に なっています:

またラベル/コマンド/ファイル名フィールドには次のような任意の エスケープシーケンスを入れることができます。

    [exec] (\(my cool\) \{XTERM\}) {\(xterm -T \\\"cool XTERM\\\"\)}
   

\\ を使ってラベル/コマンド/ファイル名フィールドにバックスラッ シュを入れることができます。

ではこれまでの難解な呪文について見てみましょう。まずメニュー をつくりタイトルをつけるには一対の [begin] と [end] タグが必要です:

    ...
    [begin] (Example \[Menu\])
    [end]
    ...
   

十分単純です。それでは何か項目をリストに加えましょう。 xtermか何かの仮想端末はいつも使いたいものなので メニューに追加すると次のようになります:

    ...
    [begin] (Example \[Menu\])
    [exec] (xterm) {xterm -ls}
    [end]
    ...
   

いい感じ! では irc クライアント、mozilla、Eye of GNOME、そし て他のいくつかの一般的なプログラムを起動するための項目を追加してみ ましょう。こうなります:

    [begin] (Example \[Menu\])
    [exec] (efnet irc) {xterm -e irc fnord irc.efnet.net}
    [exec] (Mozilla Browser) {mozilla}
    [exec] (Eye of GNOME) {eog}
    [exec] (XEmacs) {xemacs}
    [exec] (The GIMP) {gimp}
    [exec] (Video Tune) {xvidtune}
    [end]
   

と、ちょっと待って。このメニューファイルは最初にしてはちょっ と散らかっているように見えます。しかし問題にはならず、単にインデン トし、空白を入れてメニューファイルを整理できますので少しかたづけて みましょう:

    [begin] (Example \[Menu\])
    [exec] (efnet irc)       {xterm -e irc fnord irc.efnet.net}
    [exec] (Mozilla Browser) {mozilla}
    [exec] (Eye of GNOME)    {eog}
    [exec] (XEmacs)          {xemacs}
    [exec] (The GIMP)        {gimp}
    [exec] (Video Tune)      {xvidtune}
    [end]
   

うーん、これで少しは見た目がよくなりました。それではファイル に空白のたぐいを入れ、メニュー自身にもそれを反映させるようにしたい でしょうから [nop] タグを使ってみましょう:

    [begin] (Example \[Menu\])
    [exec] (efnet irc)       {xterm -e irc fnord irc.efnet.net}
    [nop]
    [exec] (Mozilla Browser) {mozilla}
    [exec] (Eye of GNOME)    {eog}
    [exec] (XEmacs)          {xemacs}
    [nop]
    [exec] (The GIMP)        {gimp}
    [nop]
    [exec] (Video Tune)      {xvidtune}
    [end]
   

さてBB.t.o.からダウ ンロードしたすべてのテーマに変えるための項目を入れるサブメニューを つくってみましょう。テーマはthemes.org の文書にあるように~/.blackboxディレクトリ内に置くことと します。

    [begin] (Example \[Menu\])
    [exec] (efnet irc)       {xterm -e irc fnord irc.efnet.net}
    [nop]
    [exec] (Mozilla Browser) {mozilla}
    [exec] (Eye of GNOME)    {eog}
    [exec] (XEmacs)          {xemacs}
    [nop]
    [exec] (The GIMP)        {gimp}
    [nop]
    [exec] (Video Tune)      {xvidtune}
      [submenu] (Themes) {Themes from blackbox.themes.org}
        [style] (Redsky) {~/.blackbox/Styles/Redsky}
        [style] (Blackbox) {~/.blackbox/Styles/blackbox}
        [style] (Blackbox II) {~/.blackbox/Styles/blackbox2}
        [style] (Hardware) {~/.blackbox/Styles/hardware}
        [style] (Nova) {~/.blackbox/Styles/nova}
        [style] (Orbital) {~/.blackbox/Styles/orbital}
        [style] (Orbital II) {~/.blackbox/Styles/orbital2}
        [style] (Seething) {~/.blackbox/Styles/seething}
        [style] (Zero) {~/.blackbox/Styles/zero}
        [style] (Cold Fusion) {~/.blackbox/Styles/coldfusion}
      [end]                                                        
    [end]
      

それではメニューの構文について感じがつかめたのでメニューを完 成させましょう。ダウンロードしたスタイルも Blackbox のデフォルトス タイルについてサブメニューにすることにします。Blackbox の共有ディレ クトリからスタイルを [include] することが必要です。すべてを一緒にす ると次のようになります:

    # custom menu file for Blackbox                                              
    
    [begin] (Example \[Menu\])
      [exec] (efnet irc)       {xterm -e irc fnord irc.efnet.net}
      [nop]
      [exec] (Mozilla Browser) {mozilla}
      [exec] (Eye of GNOME)    {eog}
      [exec] (XEmacs)          {xemacs}
      [nop]
      [exec] (The GIMP)        {gimp}                
      [nop]
      [exec] (Video Tune)      {xvidtune}
      [nop]  (...)
        [submenu] (Themes) {Themes from blackbox.themes.org}
          [style] (Blackbox) {~/.blackbox/Styles/blackbox}
          [style] (Blackbox II) {~/.blackbox/Styles/blackbox2}
          [style] (Hardware) {~/.blackbox/Styles/hardware}
          [style] (Nova) {~/.blackbox/Styles/nova}
          [style] (Orbital) {~/.blackbox/Styles/orbital}
          [style] (Orbital II) {~/.blackbox/Styles/orbital2}
          [style] (Seething) {~/.blackbox/Styles/seething}
          [style] (Zero) {~/.blackbox/Styles/zero}
          [style] (Cold Fusion) {~/.blackbox/Styles/coldfusion}
       
          # include the default style menu... this is assuming
          # Blackbox was installed into /usr/local [nop] [include]
          # (/usr/local/share/Blackbox/styles/stylesmenu) [end]
          # [workspaces] (Workspace list) [submenu] (Restart) {Restart
          # which?}  [restart] (Blackbox)
    
          # let's also give us access to some other window managers
    
          [restart] (Window Maker) {wmaker}
          [restart] (Enlightenment) {enlightenment}
          [restart] (KWM) {kwm}
          [restart] (TWM) {twm}
        [end]
      [nop] (...)
      [reconfig] (Reconfigure)
      [exit] (Quit!)
    [end]
   

メニューファイルは完成です! そして Blackbox がこのメニューファ イルを読めるようにする必要がありますので ~/.blackboxrcを編集します。

ここではメニューファイル名に対するリソースの変更が必要となり ます。そこで次のように変更(あるいは追加します:

    session.menuFile:       /path/to/some/file
   

もしこのリソースが存在すれば変更します。もしなければ追加しま す。メニューの置き場所によって新しいリソースは次のようになります:

    session.menuFile:       /home/user/blackbox/rootmenu
   

そして~/.blackboxrcを保存し、Blackbox を 再起動(再設定が機能しなければ完全に Blackbox を終了し、カラー/フォ ント/などを制御するものだけでなくすべての設定ファイルを再読み込みす る必要があります。すべて正しく操作を終えると Blackbox は自身を再起 動し、新規メニューが利用可能となります。もし何かうまくいかなければ 上のすべてのサンプルを読んで再度必要なタグをとばしたり必要なステッ プを忘れていたりしないかを確かめて下さい。

さて Blackbox についてどこにメニューがあるかといった以上のこ とを説明しました。Blackbox 0.50.0 では自動メニュー更新ができますの で、 session.menuFile を変更しないかぎりメニューを編集しても Blackbox を再起動、再設定する必要はありません。Blackbox はメニュー を構築するのにすべてのファイルのタイムスタンプを監視します。どれか が変化すれば再度読み込まれメニューが更新されます。チェックはルート メニューを開く度に行なわれます。つまり、いつもメニューを再読み込み するわけではなく、改変された時間を見て改変時に再読み込みするわけで す。

bb.t.o.から適切に フォーマットされたスタイル tar ボールをインストールするのは非常に単 純です。最初に適切にディレクトリをつくっていること、~/.blackboxが存在することを確認します。 その下には最低二つのディレクトリStyleとBackgroundsが必要です。もしなければ次 のコマンドを実行します。

    bash$ mkdir -p ~/.blackbox/{Styles,Backgrounds}
   

使いたいスタイルをダウンロードしたら次を実行します:

    bash$ cd ~/.blackbox
    bash$ tar zxvf /path/to/style/tarball
   

この後でメニューファイルに [style] 行を追加します。

Blackbox を取ってきて実行した後、次にあなたは画面上の色/フォ ント/その他を変えたいと思います。Blackbox はその設定情報を読むのに "style" (スタイル)を使います。Blackbox でのスタイルはファイル内の X リソースで構成されています。ちょうどメニューファイルと同じようにス タイルファイルは読み込みアクセス可能で Blackbox がそれを使うことが できれば、ファイルシステム上のどこにも置けます。

第一にどこにどういう名前でファイルを置くか決めなければなりま せん。新規スタイルを results というファイル名で置くことにしましょう。 このファイルは ~/.blackbox/Styles に置きます。メニューファイルと同 じように好みのテキストエディタで新規スタイルをつくります。

X リソースはキーと値から成ります。キーはピリオド(.)で区切られ たいくつかの小さなキーの構成されています。またキーはワイルドカード、 つまり一行のテキストがいくつかのキーに解釈される、アスタリスク(*') を含むことも可能です。これは一、二色をベースにするスタイルでは便利 です。この例はこの節の最後であげられています。Blackbox ではユーザは ツールバー、メニュー、ウィンドウの装飾の三つの主要コンポーネントを 調整できます。それではツールバーの独自のスタイルをつくってみましょ う。

はじめにツールバーとそのコンポーネントの "texture" (テクスチャ) を定義する必要があります。テクスチャは Blackbox に与えられた色をど のように形造る、あるいはまとめるかを指示します。テクスチャは次の要 素から成ります:

さあテクスチャについてわかったのでツールバーのテクスチャを定 義してみましょう。ツールバーはメインフレーム、ボタン、二つのラベル と時計ラベルを持っています。ボタンには二つの状態があり、よって普通 の状態とクリックされた状態の両方についてテクスチャを与えなければな りません。

    ...
    toolbar:                  Raised Diagonal Gradient Bevel1
    toolbar.button:           Raised Diagonal Gradient Bevel1
    toolbar.button.pressed:   Sunken Diagonal Interlaced Gradient Bevel1
    toolbar.clock:            Flat Interlaced Gradient
    toolbar.label:            Flat Interlaced Gradient
    ...
   

次にテクスチャの色を定義します。色は man 1 X に記述されているように適性な X の(RGB データベースから の)色名、あるいは色識別子のどちらによる指定も可能です。色について追 加した後のファイルを見てみましょう:

    ...
    toolbar:                        Raised Diagonal Gradient Bevel1
    toolbar.button:                 Raised Diagonal Gradient Bevel1
    toolbar.button.pressed:         Sunken Diagonal Interlaced Gradient Bevel1
    toolbar.clock:                  Flat Interlaced Gradient
    toolbar.label:                  Flat Interlaced Gradient
    toolbar.color:                  rgb:8/8/7
    toolbar.colorTo:                grey20
    toolbar.button.color:           grey
    toolbar.button.colorTo:         grey20
    toolbar.button.pressed.color:   rgb:4/4/38
    toolbar.button.pressed.colorTo: rgb:f/f/d
    toolbar.clock.color:            grey20
    toolbar.clock.colorTo:          rgb:8/8/7
    toolbar.label.color:            grey20
    toolbar.label.colorTo:          rgb:8/8/7
    toolbar.textColor:              grey85
    ...
   

ちょうどタイプの量を減らすためにワイルドカードをどのように使 うかについて説明するよい機会です。上の例では色値を指定するいくつか の行があります。それらの各行には color か colorTo 設定があります。 もし二つのリソース指定が部分的に一致するなら(すなわち toolbar.clock.colorとtoolbar.label.colorのように)、次の作法でそれら を同時に指定できます:

あなたが気づいたようにすべてのテクスチャは color と colorTo キーを持ちます。これらのキーは gradient (グラディエント)画像のため に必要となります。solid (単色)については一つの色だけが必要です。ま たあなたはツールバー上のテキストについても色を指定していることに注 目するでしょう。すべてのテクスチャがテキスト色を持つわけではなく、 単にベーステクスチャを確かにしています。

次にメニューに移りましょう。Blackbox は C++ で書かれているの で使われているすべてのメニューは一つの一般基礎クラスのサブクラスで す。Blackbox は基礎クラスに対するスタイル指定を読み、Blackbox で使 われるすべてのメニューについて適用します。

メニューはタイトルとフレームの二つの主要部分を持ちます。それ らについて見ることはできませんのでこれら二つの部分について指定する だけです。メニューフレームとメニュータイトルには両方ともテキスト色 指定があり、メニューフレームには前景色と対応する前景テキスト色キー があります。メニューについていくつかのテクスチャを割当て、これまで のスタイルファイルがどのようになるか見てみましょう:

    ...
    toolbar:Raised Diagonal Gradient Bevel1
    toolbar.button:     Raised Diagonal Gradient Bevel1
    toolbar.button.pressed:   Sunken Diagonal Interlaced Gradient Bevel1
    toolbar.clock:Flat Interlaced Gradient
    toolbar.label:Flat Interlaced Gradient
    toolbar.color:rgb:8/8/7
    toolbar.colorTo:    grey20
    toolbar.button.color:     grey
    toolbar.button.colorTo:   grey20
    toolbar.button.pressed.color:   rgb:4/4/38
    toolbar.button.pressed.colorTo: rgb:f/f/d
    toolbar.clock.color:grey20
    toolbar.clock.colorTo:    rgb:8/8/7
    toolbar.label.color:grey20
    toolbar.label.colorTo:    rgb:8/8/7
    toolbar.textColor:  grey85
    menu.title:   Raised Diagonal Interlaced Gradient Bevel1
    menu.frame:   Raised Diagonal Gradient Bevel1
    menu.title.color:   grey20
    menu.title.colorTo: rgb:8/8/7
    menu.title.textColor:     grey85
    menu.frame.color:   rgb:8/8/7
    menu.frame.colorTo: grey10
    menu.frame.textColor:     white
    menu.frame.highlightColor:grey85
    menu.frame.hiTextColor:   grey20
    ...
   

次にウィンドウを設定する必要があります。ウィンドウはフォーカ ス状態と非フォーカス状態を持ち、ボタンに似ています。よってフォーカ スウィンドウと非フォーカスウィンドウのテクスチャは別々に定義します。 タイトルバー上のボタンはフォーカスウィンドウに隷属するので同じに設 定しなければなりません。ボタンは一つの"クリック"された状態を持つの で(focus.pressed状態とunfocus.pressed状態を持つ代りに)その一つの状 態だけについて定義する必要があります。ウィンドウフレームはクライア ントウィンドウの外周に細い枠のことです。同じように理解しましょう。 ウィンドウの設定を追加した後ではスタイルは次のようになります:

    ...
    toolbar:Raised Diagonal Gradient Bevel1
    toolbar.button:     Raised Diagonal Gradient Bevel1
    toolbar.button.pressed:   Sunken Diagonal Interlaced Gradient Bevel1
    toolbar.clock:Flat Interlaced Gradient
    toolbar.label:Flat Interlaced Gradient
    toolbar.color:                  rgb:8/8/7
    toolbar.colorTo:                grey20
    toolbar.button.color:           grey
    toolbar.button.colorTo:         grey20
    toolbar.button.pressed.color:   rgb:4/4/38
    toolbar.button.pressed.colorTo: rgb:f/f/d
    toolbar.clock.color:            grey20
    toolbar.clock.colorTo:          rgb:8/8/7
    toolbar.label.color:            grey20
    toolbar.label.colorTo:          rgb:8/8/7
    toolbar.textColor:              grey85
    menu.title:                     Raised Diagonal Interlaced Gradient Bevel1
    menu.frame:                     Raised Diagonal Gradient Bevel1
    menu.title.color:               grey20
    menu.title.colorTo:             rgb:8/8/7
    menu.title.textColor:           grey85
    menu.frame.color:               rgb:8/8/7
    menu.frame.colorTo:             grey10
    menu.frame.textColor:           white
    menu.frame.highlightColor:      grey85
    menu.frame.hiTextColor:         grey20
    window.focus:                   Raised Diagonal Interlaced Gradient Bevel1
    window.focus.button:            Raised Diagonal Gradient Bevel1
    window.unfocus:                 Raised Diagonal Gradient Bevel1
    window.unfocus.button:          Sunken Diagonal Gradient Bevel1
    window.button.pressed:          Flat Diagonal Interlaced Gradient
    window.frame:                   Raised Solid Bevel1
    window.focus.color:             grey
    window.focus.colorTo:           grey20
    window.focus.textColor:         grey85
    window.focus.button.color:      grey
    window.focus.button.colorTo:    grey20
    window.unfocus.color:           rgb:8/8/7
    window.unfocus.colorTo:         grey20
    window.unfocus.textColor:       grey
    window.unfocus.button.color:    grey20
    window.unfocus.button.colorTo:  grey
    window.button.pressed.color:    rgb:4/4/38
    window.button.pressed.colorTo:  rgb:f/f/d
    window.frame.color:             grey85
    ...
   

それでは 2、3 のその他のオプションを追加してスタイルを終りに します。その他のオプションにはタイトルとメニューフォント、位置調整、 枠色、ベベルとハンドルの幅、ウィンドウの移動スタイル、そしてrootコ マンドを含みます。フォントは適切な X11 フォントか適切なフォント別名 でなければなりません。フォントの試写には xfontsel(か他のもの)のようなユーティリティを使っ て下さい。また今のすべての X フォント名と X サーバ内に保持されてい る別名を出力するにはユーティリティxlsfontを使っ て下さい。位置調整にはLeftJustify、CenterJustify、RightJustifyの三 つのオプションの内の一つを指定できます。

枠色はメニューフレーム、タイトル、ウィンドウのタイトルバー、 ボタン、ハンドルなどのまわりの 1 ピクセルの枠に適用する色です。この 色を設定することであなたのスタイルには劇的な効果があるので、いつも 単に黒のままにするということはしないで下さい。

ベベルとハンドルの幅は Blackbox での装飾の幅とスペースを制御 します。数字を大きくすると与えられたウィンドウに対してよりスペース をとるようになります。ウィンドウ移動スタイルは Blackbox にマウスで ドラッグしてウィンドウを移動するさいの方法を指示し、OpaqueとWireの 二つのオプションがあります。

Blackbox ver 0.51 ではmenu bullet、location、highlightを変更 するオプションが追加されています。menu.bullet.Styleに対するオプショ ンはRound、Empty、Triangle、Square、Diamondです。bullet style とし てRoundが選択されているときは強調表示のまわりはまるく縁取られ、そう でなければ強調表示はルートメニュー内にbullet(鋲、選択したことを示す 印のこと?)を配置するための左か右に指定できる、 square.menu.bulletPositionになります[若干この個所は意味不明のため、 原文をのせると: the highlight has rounded edges when Round is selected as the bullet style, otherwise the highlight is square.menu.bulletPosition can be set to left or right in order to position the bullet in the root menu]。root コマンドはスタイル読み 込み時(あるいは起動、再設定/スタイル変更時)に毎回実行されるコマンド です。これはルートウィンドウに画像や色やパターンを設定するための xvやEsetrootや wmsetbgなどのようなプログラムを実行するために使 われます。単にコマンドを指定し、それが実行されます。

さあ詳細については終わらせて最終的なスタイルを見てみましょう:

    ...
    ! Results - theme for Blackbox 0.50.x
    ! by Brad Hughes bhughes@tcac.net
    ! define the toolbars textures... note that the interlaced option is new
    ! in 0.50.5
    toolbar:                        Raised Diagonal Gradient Bevel1
    toolbar.button:                 Raised Diagonal Gradient Bevel1
    toolbar.button.pressed:         Sunken Diagonal Interlaced Gradient Bevel1
    toolbar.clock:                  Flat Interlaced Gradient
    toolbar.label:                  Flat Interlaced Gradient
    ! toolbar colors
    toolbar.color:                  rgb:8/8/7
    toolbar.colorTo:                grey20
    toolbar.button.color:           grey
    toolbar.button.colorTo:         grey20
    toolbar.button.pressed.color:   rgb:4/4/38
    toolbar.button.pressed.colorTo: rgb:f/f/d
    toolbar.clock.color:            grey20
    toolbar.clock.colorTo:          rgb:8/8/7
    toolbar.label.color:            grey20
    toolbar.label.colorTo:          rgb:8/8/7
    toolbar.textColor:              grey85
    ! menu textures
    menu.title:                     Raised Diagonal Interlaced Gradient Bevel1
    menu.frame:                     Raised Diagonal Gradient Bevel1
    ! menu colors
    menu.title.color:               grey20
    menu.title.colorTo:             rgb:8/8/7
    menu.title.textColor:           grey85
    menu.frame.color:               rgb:8/8/7
    menu.frame.colorTo:             grey10
    menu.frame.textColor:           white
    menu.frame.highlightColor:      grey85
    menu.frame.hiTextColor:         grey20
    ! window textures
    window.focus:                   Raised Diagonal Interlaced Gradient Bevel1
    window.focus.button:            Raised Diagonal Gradient Bevel1
    window.unfocus:                 Raised Diagonal Gradient Bevel1
    window.unfocus.button:          Sunken Diagonal Gradient Bevel1
    window.button.pressed:          Flat Diagonal Interlaced Gradient
    window.frame:                   Raised Solid Bevel1
    ! window colors
    window.focus.color:             grey
    window.focus.colorTo:           grey20
    window.focus.textColor:         grey85
    window.focus.button.color:      grey
    window.focus.button.colorTo:    grey20
    window.unfocus.color:           rgb:8/8/7
    window.unfocus.colorTo:         grey20
    window.unfocus.textColor:       grey
    window.unfocus.button.color:    grey20
    window.unfocus.button.colorTo:  grey
    window.button.pressed.color:    rgb:4/4/38
    window.button.pressed.colorTo:  rgb:f/f/d
    window.frame.color:             grey85
    ! misc...
    borderColor:                    rgb:2/2/1c
    moveStyle:                      Opaque
    menuJustify:                    CenterJustify
    titleJustify:                   CenterJustify
    bevelWidth:                     2
    handleWidth:                    4
    menuFont:                       lucidasans-10
    titleFont:                      lucidasans-bold-10
    rootCommand:                    bsetroot -mod 4 4 -fg rgb:6/6/5c -bg grey20
    !rootCommand:                   bsetbg ~/.blackbox/backgrounds/Image.jpg
    ...
   

いいでしょう! スタイルができました。どんな風に見えるか見てみ ましょう。まず Blackbox に新しいスタイルを使うように指示しなければ なりません。これにはメニューを編集して次をどこかに追加します:

    [style] (Results) {~/.blackbox/Styles/results}
   

Blackbox 0.50.5 より新しいものではメニューは自動的に更新され、 ルートメニューを閉じて開き直すだけで新しいスタイル項目が現れます。 それを選択すると Blackbox は今つくったばかりの新しいスタイルを適用 します。

自分のスタイルをつくったらそれらを他の Blackbox ユーザと共有 できるように bb.t.o. に投稿したいと思うかもしれません。テーマのイン ストールを簡単にするために bb.t.o. は標準的な style のパッケージ化 方法を定式化しています。スタイルを投稿するときにはこれらのガイドラ インに従うことが必須となります。これは決して Blackbox スタイルを用 意するための唯一の方法というわけではありませんが、bb.t.o. にアップ ロードするために唯一の許されている方法です。スタイルを bb.t.o. にアッ プロードするときには三つのものが不可欠となります : スタイルのスクリー ンショット、lsm ファイルとスタイルファイル自身、同じ lsm ファイルと 任意の必須の背景画像を含む tar ボール

スタイルファイルのつくりかたについては節 5.1 を参照して下さい。

lsm ファイルはスタイルについて説明する小さなテキストファイル です。これにはスタイルのタイトル、スタイルの作者、適切なクレディッ ト、そしてスタイルの使い方についてコメントについての情報が含まれて います。例えば:

    Title:      Results                             
    Author:     Brad Hughes <bhughes@tcac.net>
    Version:    0.50.x
    Credits:    I did this!
   

スタイルをつくり、背景画像を選択し、lsm ファイルをつくり、そ れらを~/.blackbox 内 (rootCommand がこれらの場所を使っていることを確認して下さい)の適切 な場所に置きます。lsm ファイルは~/.blackbox内に、スタイルファイルは ~/.blackbox/Styles/内に、そ して背景(もし利用可能なら)は~/.blackbox/Backgrounds/に置かなければ なりません。tar ボールをつくるには次のコマンドを実行します(ここでは スタイルの名前としては MyStyle を使います):

    bash$ cd ~/.blackbox
    bash$ tar zcvf MyStyle.tar.gz MyStyle.lsm Styles/MyStyle Backgrounds/MyStyle.jpg
   

次にあなたの好きなプログラム(gimp、import [imagemagick に入っ ています]、eeyes など)を使ってスクリーンショットを撮ります。

あなたのつくった tar ボールとスクリーンショットをアップロード するには bb.t.o. のスタイルアップロードページを使って下さい。これで 完了です。

Blackbox は Afterstep と Window Maker に共通の Dock アプリケー ションをサポートしています。Dock アプリケーションを配置する、Slit はデフォルトで Blackbox 本体に組込まれています。もしSlitサポートを はずしたければ Blackboxを--disable-slitオプション付で configure して下さい。Slit は Dock アプリケーショ ンが動作していなければ見ることができません(Dock アプリケーションが その中で枠つきで動きます)。

Slit の位置は Slit の上で右クリックし、六つのオプション (TopRight、TopLeft、CenterRight、CenterLeft、BottomRight、あるいは BottomLeft) が選択することで変えることができます。これはまた ~/.blackboxrcでも設定できます。たいていの Dock アプリケーションは実行されると自動的に Slit 内に現れますが、bbtools シリーズのようにそうならないものは Slit 内で現れるために -w(withdrawn) オプションが実行時に必要となります。

今のところ、Blackbox の KDE のサポートは限定的です。このサポー トはconfigureに--enable-kdeオプションをつけて有 効になる、コンパイル時のオプションです。KDE と blackbox と一緒に使 うにはblackboxとkfmと kpanelを動かします。もし X の実行時にはいつも それらを動かすのであれば次のような行を ~/.xinitrc(あるいはxdmなど を使っていれば~/.xsession)に追加して下さい:

          
    kfm &
    kpanel &
    exec blackbox 
   

今のところ Blackbox は (GNOME WM ) specification が貧弱なため に標準的なパッケージでは GNOME をサポートしません。将来的にはGNOME サポートが追加されるかもしれませんが、これは GNOME specification が 修正された後になるでしょう^[2]。

現在はサードパーティの GNOME サポートが Blackbox へのパッチの 形で利用可能です。このパッチは Blackbox Stuff、 blackbox.linuxbox.com、あるいはGNOME @ Winds of Storm で取得できます。

今はユーザはワークスペース移動とウィンドウ切り替えのショート カットのみカスタマイズできます。この設定は ~/.blackboxrcでできます。デフォルトのショート カットキーはワークスペース移動に Control-Left (かRightカーソル矢印キー)で、ウィンドウ切り替えは Alt-Tabと Alt-Shift-Tab です。ショートカットキーを無効にするにはNum Lockか Caps Lockを押しておきます。

Dock アプリケーションを Slit に適切な順番で読み込むには次のよ うにします:

    sleep 1 && wmppp &
    sleep 2 && wmsomething &
    exec blackbox
   

Blackbox メーリングリスト blackbox@troll.no での質問と答です。

パッチはたいていは Blackbox の機能を追加したり省略したり別の もので置きかえたりするためにソースコードを変更します。Blackbox プロ グラマ Brad Hughes は完全なソースツリーのバックアップをとることを勧 めています。一方のツリーはオリジナルのソースコードでもう一方は改変 されたコードを含みます。例えば:

    blackbox-0.50.5.org/
    blackbox-0.50.5.new/
   

これらのパッチをつくるには次のようにします:

    bash$ diff -urN blackbox-0.50.5.org blackbox-0.50.5.new
   

ディレクトリの名前は違っていなければならないことに注意して下 さい。

パッチファイルをあなたが Blackbox をコンパイルした場所から Blackboxディレクトリに移動さ せます。パッチを適用するには次のようにします:

    bash$ patch -p0 < name_of.patch
   

Blackbox ソースを改変したら makeと make install を実行するのを忘れないで下さい。

bsetroot は Blackbox の背景を設定するのに 使うコマンドです。これは画像を設定するのではなくあなたの指定したパ ラメータに基づいて背景画像を生成します。オプションは次のとおりです:

    -display <string>     use display connection
    -fg <color>           use foreground color
    -bg <color>           use background color
    -solid <color>        use solid color
    -mod <x> <y>    use modula pattern
   

Blackbox が一つ以上のワークスペースで起動するためには中央クリッ クか左右両方ボタンクリックでワークスペースメニューを表示し、新規ワー クスペース [New Workspace] を選択し、右クリックしてルートメニューか ら再設定 [Reconfigure] を選択します。再度 Blackbox を起動したときに は二つのワークスペースがあるはずです。たくさん欲しいだけワークスペー スを追加するには同様の操作をします。Blackbox メーリングリストblackbox@troll.noでの質問と 答です。

もしかしたらあなたは "myfont" という TrueType フォントをツー ルバーやメニューやあるいはウィンドウタイトルバーに使いたいと思って いるかもしれません。あなたはこのフォントをインストールし、サイズ 14 で使いたいと思っているとします。スタイルファイル内のリソースに例え ば次のように設定して下さい:

    *Font:  -*-myfont-*-i-*-*-14-*-*-*-*-*-*-*
   

この設定を実行するのに優れたユーティリティが xfontsel です。

少しの単純なステップを必要としますが実際はとても簡単です。