Tidal Window Manager 项目启动与配置教程

1. 项目的目录结构及介绍

Tidal Window Manager（TidalWM）是一个为 Gnome Shell 设计的简单且直观的平铺窗口管理器插件。以下是项目的目录结构及各部分的简要介绍：

tidalwm/
├── schemas/             # 包含项目的 JSON 配置模式文件
├── extension.js         # 插件的主要 JavaScript 文件，实现了窗口管理的逻辑
├── highlight.js         # 用于突出显示活动窗口的 JavaScript 文件
├── logging.js           # 用于日志记录的 JavaScript 文件
├── metadata.json        # 包含插件元数据的 JSON 文件
├── prefs.js             # 插件的偏好设置 JavaScript 文件
├── spiral.js            # 用于螺旋平铺算法的 JavaScript 文件
├── stylesheet.css       # 插件的 CSS 样式文件
├── tidal.js             # 插件的主要 JavaScript 文件，负责初始化和事件处理
├── README.md            # 项目说明文件，包含项目信息和安装指南
└── LICENSE              # 项目的许可证文件，本项目采用 GPL-3.0 许可

2. 项目的启动文件介绍

项目的启动主要依赖于 extension.js 文件。以下是 extension.js 的主要功能：

• 初始化插件，并注册必要的 Gnome Shell 扩展接口。
• 监听窗口管理相关的事件，如窗口创建、移动和调整大小等。
• 实现窗口的自动平铺逻辑，目前支持螺旋平铺。
• 处理热键事件，如浮动窗口、旋转窗口顺序等。

要启动 TidalWM，您需要将插件文件夹克隆到 Gnome Shell 扩展的目录中，然后登录 Gnome Shell 并激活扩展。

3. 项目的配置文件介绍

TidalWM 的配置主要通过 prefs.js 文件进行。以下是 prefs.js 中的主要配置选项：

• 窗口间隙：设置窗口之间以及窗口与屏幕边缘之间的间隙大小。
• 智能间隙：仅在屏幕上有多个窗口时应用间隙。
• 非活动窗口不透明度：设置非活动窗口的不透明度百分比。
• 高亮活动窗口：为当前活动的窗口绘制彩色边框。
• 边框宽度：设置活动窗口边框的宽度。
• 边框颜色：设置活动窗口边框的颜色。
• 始终浮动：指定一个窗口管理类列表，这些类将不被平铺。
• 平铺选项：包括平铺方式（螺旋、二进制分割等），初始分割方向等。
• 热键配置：定义各种操作的热键，如浮动窗口、旋转窗口顺序、调整窗口大小和位置等。

用户可以通过 Gnome Shell 扩展首选项工具来调整这些设置，以适应个人喜好。