Hawck 项目使用教程

Hawck 项目使用教程

hawck Key-rebinding daemon for Linux (Wayland/X11/Console) 项目地址: https://gitcode.com/gh_mirrors/ha/hawck

1. 项目目录结构及介绍

Hawck 项目的目录结构如下：

hawck/
├── bin/
│   └── dependencies/
├── changelogs/
├── docs/
├── icons/
├── images/
├── keymaps/
├── src/
│   └── tools/
├── tests/
├── clang-format
├── gitignore
├── gitmodules
├── Doxyfile
├── LICENSE
├── README.md
├── install.sh
├── meson.build
└── meson_options.txt

目录介绍

• bin/: 包含项目的二进制文件和依赖文件。
  • dependencies/: 包含项目的依赖文件。
• changelogs/: 包含项目的变更日志。
• docs/: 包含项目的文档文件。
• icons/: 包含项目的图标文件。
• images/: 包含项目的图片文件。
• keymaps/: 包含项目的键盘映射文件。
• src/: 包含项目的源代码文件。
  • tools/: 包含项目的工具文件。
• tests/: 包含项目的测试文件。
• clang-format: 包含项目的代码格式化配置文件。
• gitignore: 包含项目的 Git 忽略文件。
• gitmodules: 包含项目的 Git 子模块配置文件。
• Doxyfile: 包含项目的 Doxygen 配置文件。
• LICENSE: 包含项目的许可证文件。
• README.md: 包含项目的介绍和使用说明。
• install.sh: 包含项目的安装脚本。
• meson.build: 包含项目的 Meson 构建配置文件。
• meson_options.txt: 包含项目的 Meson 构建选项配置文件。

2. 项目启动文件介绍

Hawck 项目的启动文件主要包括以下几个部分：

2.1 install.sh

install.sh 是项目的安装脚本，用于在系统中安装 Hawck。该脚本会自动安装项目的依赖，并配置系统以支持 Hawck 的运行。

2.2 hawck-inputd

hawck-inputd 是 Hawck 的输入守护进程，负责拦截键盘输入并将其传递给宏守护进程进行处理。该进程运行在 hawck-input 用户下，并属于 input 和 hawck-uinput 组。

2.3 hawck-macrod

hawck-macrod 是 Hawck 的宏守护进程，负责接收来自输入守护进程的键盘输入，并根据 Lua 脚本执行相应的操作。该进程运行在桌面用户下，并负责处理和修改键盘输入。

3. 项目配置文件介绍

Hawck 项目的配置文件主要包括以下几个部分：

3.1 ~/local/share/hawck/cfg.lua

cfg.lua 是 Hawck 的主配置文件，用于设置键盘布局和其他全局配置。用户可以根据自己的键盘布局设置相应的配置项。

keymap = "no"  -- 设置为 "us"、"de"、"no-latin1" 等，根据你的键盘布局

3.2 ~/config/hawck/scripts/

scripts/ 目录包含用户自定义的 Lua 脚本，用于定义键盘映射和操作。用户可以在此目录下创建新的脚本文件，并通过 hawck-add 命令将其添加到 Hawck 中。

3.3 /var/lib/hawck-input/keys/

keys/ 目录包含 Hawck 输入守护进程拦截的键盘输入记录。用户可以通过查看此目录下的文件了解哪些键被拦截和处理。

3.4 hawck-add

hawck-add 是一个命令行工具，用于将新的脚本文件添加到 Hawck 中。用户可以通过此工具将自定义的 Lua 脚本添加到 Hawck 中，并使其生效。

hawck-add ~/config/hawck/scripts/example.hwk

通过以上配置文件和启动文件的介绍，用户可以更好地理解和使用 Hawck 项目，实现自定义的键盘映射和操作。

hawck Key-rebinding daemon for Linux (Wayland/X11/Console) 项目地址: https://gitcode.com/gh_mirrors/ha/hawck