Matchbox Summary 1 (××, ××)

1. About matchbox Window Manager:
1. About startup:
When X-server is started and the display environment variable is set, run the following command to start matchbox-windowmanager:
$ Matchbox-window-manager [Options]
Here, we generally do not need to use the command line to specify [Options], which can be specified through the configuration file (provided that the support of x resource is not disabled during compilation ), the configuration file is generally :~ /. Xdefaults and (installation directory)/share/matchbox/defaults. However, if the option is specified using the command line, the option of the command line takes precedence over the configuration file.
For details about [Options], see the documentation, for example:
-Display <string>
Specifies the X Window to be connected. The default window is determined by the display environment variable.
-Theme <string>
Specifies the topic to be used and the corresponding configuration file :~ /. Theme/[theme name]/matchbox and (installation directory)/share/themes/. If none of them exist, use this: (installation directory)/share/themes/default/matchbox.
......
2. Topics:
The topic can be configured. The configuration file is in: (installation directory)/share/themes/[selected theme name]/matchbox
Use the command line to configure the theme. Enter the following command:
$ Matchbox-remote-T <theme name>
Matchbox-remote is a command line tool that can control matchbox externally. If xsettings support is available during compilation, you can also use the gnome2/GPE/kde3 desktop configuration tool to configure themes.
3. Shortcut Keys:
The related configuration files are: (install prefix)/share/matchbox/kbdconfig and ~ /. Matchbox/kdbconfig
The format of each line in the configuration file is as follows:
<Keys definition >=< action>
Example:
<Ctrl> <alt> P = Prev
Press CTRL + ALT + P to switch to the previous window.
<Ctrl> X =! Xterm
Press Ctrl + X to start a new xterm terminal.
For more examples, refer to the kbdconfig file that has been installed.
You can also use gconf to configure shortcuts (gconf is a gnome-like Windows Registry and can set some parameters)
4. built-in tools
A simple script that can execute matchbox Window Manager, desktop, and panel. You can run the following command:
$ Matchbox-session
The executed script file is :~ /. Matchbox/session and/etc/matchbox/session

[References]
[1] http://matchbox-project.org/documentation/manual/wm.html

######################################## #
Ii. About matchbox-panel-Manager
Matchbox-panel-manager is a GTK-based application used to manage panel applications. These applets include the Start Menu, user information tools such as battery display, CPU monitoring, and clocks.
1. Usage and Configuration:
Run the Panel on X Server and set the display environment variables correctly. Input:
$ Matchbox-Panel [Options]
There are many options here. For more information, see the documentation. For example:
-Display,-D, specify the displayed window number.
-- ID: Specifies the Panel ID.
-- Titlebar
You must specify the parent window to the window title bar again on the panel.
......
You can re-specify the parent window in the title bar of the main program window by using matchbox-panel ??). Use -- titlebar
This requires defining a panel field (using the <Panel> tag) in the window frame of the "theme. xml" configuration file of matchbox WM. Some options will not work at this time.
Example:

A transparent, 60-pixel panel:

Matchbox-panel -- size 60 -- orientation east -- bgtrans Yes &

Run two panels at the top and bottom of the display:

Matchbox-panel -- orientation North & matchbox-panel -- ID 2 -- orientation South &
Setting the background in the command line overwrites all settings that affect the background in the topic configuration file.

2. Panel tools:
Panel tools generally recognize the following options:
-- Display, -- offset, -- no-session meaning read the document by yourself.
The Panel program can also use the system_tray_id environment variable to specify the Panel ID it calls.
1) MB-applet-menu-launcher (Start Menu ):
By reading (installation directory)/share/applications/(and ~ The. desktop file in/. applications.
Its structure is defined by the. directory file in (installation directory)/share/matchbox/vfolders.
2) MB-applet-launcher (program running)
Run the following two commands:
MB-applet-launcher [Options...] <XPM | png filename> <command>]
Or
MB-applet-launcher -- desktop <. desktop file>
For [Options] of the first command line method, refer to the documentation.
3) Others:
MB-applet-clock
A simple clock.
MB-applet-Wireless
Signal strength of the wireless network.
MB-applet-system-Monitor
CPU and memory usage monitoring.
MB-applet-Battery
Battery.
[References]
[2] http://matchbox-project.org/documentation/manual/panel.html

 

######################################## #
Iii. About matchbox Desktop
Desktop is at the bottom of the window stack and provides the most primitive program running mode, but can be expanded.
1. Usage and Configuration:
After the display environment variable and X Server are started, run matchbox-desktop with the following command:
$ Matchbox-desktop [Options]

About [Options] Options:

-Display: Specify the connection window number.
-- BG
-- Icon-size Icon size
-- Pixel spacing between icon-padding
... Let's not talk about anything else. Read the document ....
The following is about BG:
Different backgrounds are described in the following format:
*

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]

The topic of desktop can also be configured, And it follow the current window manager ???).

2. About the plug-in module:
Matchbox-desktop is formed by dynamically loading module entities.
Matchbox starts with three modules: the main program running module (which uses the. desktop file), simple task management module, and simple file browser.
Use the following modules: (installation directory)/lib/matchbox/mb1_top_modules or ~ /. Matchbox/mb1_top_modules.
You can refer to the examples of the desktop/modules directory to easily write your own modules.

3. Add icons and folders:

The. desktop file of the initialization type will detect: (installation directory)/share/applications and ~ /Applications, where the. desktop file contains information about program entities, such as names, icons, and executed commands.
Example:
[Desktop entry]
Name = figment
Comment = An outliner
Exec = figment
Iconw.figment.png
Type = Application
Categories = application; core;
Here, the icon object should not specify a path, and the file name should be specified directly. The corresponding image is in: (installation directory)/share/pixmaps. If you need another icon, You need to append a [contry_code] to the corresponding key. About matchbox-desktop, how to store the above object creation Folder Information in: (installation directory)/share/matchbox/vfolder and ~ /. Matchbox/vfolders.
The Directory should contain a root. Order file, a root. directory file, and some. Directory files (these files can be dispensable and used to describe each folder ).

The. directory file is similar to the. desktop file, but it is used to describe folders, while the. desktop file describes applications. The root. Order file specifies which and in what order to display directory files.

. Directory should have a configuration key. The value of this key is compared with the category key of the. desktop file. This determines the end of The. desktop file in that folder. If the match key is set to 'fallback', all directories that are not matched will end here. (The meaning is not clear ????????)

[References]
[3] http://matchbox-project.org/documentation/manual/mbdesktop.html