SmallWM 项目使用与配置指南

1. 项目目录结构及介绍

SmallWM 是一个基于 Xlib 的轻量级窗口管理器。以下是项目的主要目录结构及文件介绍：

SmallWM/
├── src/                     # 源代码目录
├── test/                    # 测试代码目录
├── Makefile                 # 编译配置文件
├── README.markdown          # 项目说明文件
├── LICENSE.txt              # 项目许可证文件
├── inih/                    # inih 库目录，用于配置文件解析
├── screenshot.png           # 项目屏幕截图
└── Doxyfile                 # Doxygen 文档配置文件

2. 项目的启动文件介绍

为了启动 SmallWM，你需要创建一个启动脚本 smallwm.sh，并将其放置在 /usr/local/bin/ 目录下。以下是启动脚本的内容：

#!/bin/bash

# 如果存在配置文件 .smallwmrc，则首先执行它
if [ -x $HOME/.smallwmrc ]; then
    $HOME/.smallwmrc &
fi

# 启动 SmallWM 窗口管理器
exec /usr/local/bin/smallwm

此外，你需要在 /usr/share/xsessions/ 目录下创建一个桌面入口文件 smallwm.desktop，以便从登录管理器中启动 SmallWM：

[Desktop Entry]
Name=SmallWM
Exec=/usr/local/bin/smallwm.sh
Type=Application

3. 项目的配置文件介绍

SmallWM 的配置文件通常是 smallwmrc，应放置在用户的家目录下的 .config/smallwm/ 目录中。以下是配置文件的示例内容：

[smallwm]
shell=xterm            # Super+LClick 时启动的终端程序
desktops=5             # 虚拟桌面数量
icon-width=75          # 图标宽度
icon-height=20         # 图标高度
border-width=4         # 窗口边框宽度
icon-icons=1           # 是否显示图标内的应用程序图标
log-level=WARNING      # 日志级别
hotkey-mode=focus      # 热键作用模式
dump-file=/dev/null    # 信息转储文件位置

[actions]
# 应用程序类行为，例如：
stalonetray=stick,layer:9,xpos:90,ypos:0 # 将 stalonetray 窗口固定并放置在顶层

[keyboard]
# 键盘快捷键配置，例如：
toggle-stick=asciitilde   # 切换窗口固定状态的快捷键
snap-top=w                # 窗口吸附到顶部的快捷键
snap-bottom=s             # 窗口吸附到底部的快捷键
snap-left=a               # 窗口吸附到左侧的快捷键
snap-right=!d             # 窗口吸附到右侧的快捷键

在配置文件中，你可以自定义快捷键、窗口行为以及其他 SmallWM 的功能选项。根据你的需求和喜好进行调整。