Matchbox總結1（××，××）

一、關於Matchbox Window Manager：
1，關於啟動：
當X－server啟動並且DISPLAY環境變數已經設定好了，通過如下命令列方式來啟動matchbox-windowmanager:
$matchbox-window-manager [options]
這裡，我們一般不用使用命令列來指定[options],可以通過設定檔來指定（前提是在編譯的時候 X Resource 的支援沒有被disabled），設定檔一般就在： ~/.Xdefaults 和 (安裝目錄)/share/matchbox/defaults這兩個位置。但如果我們用命令列指定了選項，則命令列的選項優先於設定檔。
關於[options]，可以參見文檔，例如有：
-display <string>
指明了要串連的X視窗,預設的視窗由DISPLAY環境變數來決定。
-theme <string>
指明了將要使用的主題，相應的設定檔：~/.theme/[theme name]/matchbox 和 (安裝目錄)/share/themes/，如果都沒有，則使用這個：(安裝目錄)/share/themes/Default/matchbox 。
......
2.關於主題：
主題可以配置，設定檔在： (安裝目錄)/share/themes/[selected theme name]/matchbox
用命令列來配置主題簡單，輸入如下命令：
$matchbox-remote -t <theme name>
matchbox-remote 是一個可以在外部控制Matchbox的命令列工具,如果在編譯的時候，有XSettings support，你還可以使用Gnome2 / GPE / KDE3 的案頭組態工具來配置主題。
3.關於快速鍵：
相關的設定檔在：(install prefix)/share/matchbox/kbdconfig和 ~/.matchbox/kdbconfig
設定檔中每行的定義如下格式：
<keys definition>=<action>
舉例：
<ctrl><alt>p=prev
指定按ctrl+alt+p將切換到前一個視窗
<ctrl>x=!xterm
指定按ctrl+x將啟動一個新的xterm終端
我們可以參考已經安裝的kbdconfig檔案來獲得更多的例子。
我們也可利用gconf來配置快速鍵（gconf是GNome的類似Windows註冊表的東西可以設定一些參數）
4.內建工具
一個簡單的可以執行 Matchbox window manager,desktop和panel的指令碼，可以輸入如下命令來運行：
$matchbox-session
執行的指令檔是：~/.matchbox/session 和 /etc/matchbox/session

【參考文獻】
[1] http://matchbox-project.org/documentation/manual/wm.html

#########################################
二、關於Matchbox-panel-manager
matchbox-panel-manager（面板管理器） 是基於GTK的應用程式，用來管理面板的應用程式。 這些小程式包括：開始菜單，使用者資訊的工具如：電池電量顯示，cpu等監視，鐘錶。
1.關於用法和配置：
運行面板需要X Server運行，並且DISPLAY環境變數的正確設定。輸入：
$matchbox-panel [options]
這裡的選項有許多，可參見文檔。例如：
－display,-d，指定顯示的視窗號。
--id，指定面板id號。
--titlebar
要求面板被重新指定父視窗到視窗標題列。
......
可以把matchbox－panel在主程式視窗標題列中重新指定父視窗（翻譯不太確定？？）。利用--titlebar
這需要在Matchbox WM 的 "theme.xml"設定檔的window frame中定義一個panel域（利用<panel>標籤）這時候有些選項將無作用了。
舉例：

一個透明的，60象素寬的面板:

matchbox-panel --size 60 --orientation east --bgtrans yes &

在顯示的頂部和底部運行兩個面板：

matchbox-panel --orientation north & matchbox-panel --id 2 --orientation south &
在命令列設定背景將覆蓋主題設定檔中所有對背景有影響的設定。

2.關於面板工具：
面板工具一般都識別的選項：
--display,--offset,--no-session含義自己看文檔。
面板程式也可以通過SYSTEM_TRAY_ID環境變數來指定它停靠的面板ID。
1)mb-applet-menu-launcher（開始菜單）：
通過讀取(安裝目錄)/share/applications/ ( 和 ~/.applications )中的.desktop 檔案。
它的結構由(安裝目錄)/share/matchbox/vfolders 中的.directory 檔案來定義
2）mb-applet-launcher （程式運行器）
通過如下兩命令：
mb-applet-launcher [options..] <xpm|png filename> <command> ]
或
mb-applet-launcher --desktop <.desktop file>
第一種命令列方式的[options]請參考文檔。
3）其它：
mb-applet-clock
一個簡單的鐘錶.
mb-applet-wireless
無線網路的訊號強度.
mb-applet-system-monitor
cpu、記憶體使用量監視.
mb-applet-battery
電池.
【參考文獻】
[2] http://matchbox-project.org/documentation/manual/panel.html

 

#########################################
三、關於Matchbox Desktop
desktop處於window棧的最底層，提供最原始的程式運行方式，但是能夠擴充。
1，關於用法和配置：
當DISPLAY環境變數和X server啟動之後，通過如下命令運行matchbox-desktop:
$matchbox-desktop [options]

關於[options]選項:

-display         指定串連的視窗號
--bg    後面細說
--icon-size    表徵圖大小
--icon-padding    表徵圖之間的像素間距
....其它不說了，看文檔....
下面是關於bg的：
不同的背景用如下格式描述：
    *

      img-stretched:[filename]
    *

      img-tiled:[filename]
    *

      img-centered:[filename]
    *

      col-solid:[color definition]
    *

      col-gradient-vertical:[start color],[end color]
    *

      col-gradient-horizontal:[start color],[end color]

desktop的主題也是可以配置的，並且它follow當前的window管理器（翻譯不好，不太明白？？？）。

2，關於外掛程式模組：
matchbox-desktop通過動態載入模組實體形成。
matchbox從三個模組開始：主程式運行模組（它使用.desktop檔案）、簡單的任務管理模組，和簡單檔案瀏覽器。
使用的模組在：(安裝目錄)/lib/matchbox/mbdesktop_modules 或者 ~/.matchbox/mbdesktop_modules中設定。
可以參考desktop/modules 目錄的例子，很容易的編寫自己的模組。

3，添加表徵圖和檔案夾：

屬於初始化類型的.desktop檔案將會檢測：(安裝目錄)/share/applications 和 ~/applications，這裡.desktop檔案包括程式實體的資訊比如：名稱，表徵圖，執行的命令等。
舉例：
 [Desktop Entry]
      Name=Figment
      Comment=An Outliner
      Exec=figment
      Icon=figment.png
      Type=Application
      Categories=Application;Core;
這裡Icon實體不應該指定路徑，應該直接指定檔案名稱字，相應的圖片在：(安裝目錄)/share/pixmaps 裡面。如果需要別的表徵圖，需要附加一個[contry_code]到相應的鍵。關於matchbox－desktop如何上述實體建立檔案夾的資訊存放在：(安裝目錄)/share/matchbox/vfolder 和 ~/.matchbox/vfolders/ 中。
目錄中應該包括一個root.order檔案，一個root.directory檔案，和一些.directory檔案（這些檔案可有可無，用來描述每一個檔案夾）。

.directory檔案和.desktop檔案類似，但是它是用來描述檔案夾的，而.desktop檔案描述應用程式。root.order檔案指定了哪些以及用什麼次序來顯示目錄檔案。

.directory應該有一個配置的鍵，這個鍵的值和.desktop檔案的類別機碼比較。這決定了.desktop檔案在那個檔案夾裡面結束。如果匹配鍵設定為'fallback'那麼所有沒有被匹配的目錄都將在這裡結束。(含義不太明白？？？？？？？？)

［參考文獻］
[3] http://matchbox-project.org/documentation/manual/mbdesktop.html