i3-gaps 项目教程

1. 项目目录结构及介绍

i3-gaps 是 i3 窗口管理器的一个分支，主要增加了窗口间的间隙（gaps）功能。以下是 i3-gaps 项目的目录结构及其介绍：

i3-gaps/
├── AnyEvent-I3/
├── contrib/
├── debian/
├── docs/
├── etc/
├── i3-config-wizard/
├── i3-dump-log/
├── i3-input/
├── i3-msg/
├── i3-nagbar/
├── i3bar/
├── include/
├── libi3/
├── man/
├── meson/
├── parser-specs/
├── release-notes/
├── share/
├── src/
├── testcases/
└── travis/

• AnyEvent-I3: 包含与 AnyEvent 相关的文件。
• contrib: 包含一些额外的贡献代码和工具。
• debian: 包含用于 Debian 打包的文件。
• docs: 包含项目的文档文件。
• etc: 包含配置文件和示例配置。
• i3-config-wizard: 配置向导工具。
• i3-dump-log: 日志转储工具。
• i3-input: 输入处理工具。
• i3-msg: 消息发送工具。
• i3-nagbar: 警告栏工具。
• i3bar: 状态栏工具。
• include: 包含头文件。
• libi3: 包含 i3 的核心库文件。
• man: 包含手册页。
• meson: 包含 Meson 构建系统的文件。
• parser-specs: 包含解析器规范文件。
• release-notes: 包含发布说明。
• share: 包含共享资源文件。
• src: 包含源代码文件。
• testcases: 包含测试用例。
• travis: 包含 Travis CI 配置文件。

2. 项目启动文件介绍

i3-gaps 的启动文件位于 src/ 目录下，主要的启动文件是 i3.c。这个文件包含了 i3 窗口管理器的主入口点。

// src/i3.c

int main(int argc, char *argv[]) {
    // 初始化代码
    // ...

    // 主循环
    while (running) {
        // 处理事件
        // ...
    }

    // 清理代码
    // ...

    return 0;
}

i3.c 文件负责初始化 i3 窗口管理器，处理事件循环，并在退出时进行清理。

3. 项目的配置文件介绍

i3-gaps 的配置文件通常位于 ~/.config/i3/config。这个文件包含了 i3 窗口管理器的所有配置选项。

# ~/.config/i3/config

# 设置默认边框为无
default_border pixel 0

# 设置全局间隙
gaps inner 20
gaps outer 10

# 设置特定工作区的间隙
workspace 1 gaps inner 30
workspace 2 gaps outer 15

# 启用智能间隙
smart_gaps on

# 启用智能边框
smart_borders on

# 其他配置选项
# ...

• default_border pixel 0: 设置默认边框为无，以便使用间隙功能。
• gaps inner 20: 设置全局内部间隙为 20 像素。
• gaps outer 10: 设置全局外部间隙为 10 像素。
• workspace 1 gaps inner 30: 设置工作区 1 的内部间隙为 30 像素。
• workspace 2 gaps outer 15: 设置工作区 2 的外部间隙为 15 像素。
• smart_gaps on: 启用智能间隙功能。
• smart_borders on: 启用智能边框功能。

通过编辑这个配置文件，用户可以自定义 i3-gaps 的行为和外观。