River
根据 River 的主页
- River 是一个非单体 (non-monolithic) 的 Wayland 合成器。与其他 Wayland 合成器不同，river 没有将合成器和窗口管理器合并为一个程序。相反，用户可以选择任何实现了 river-window-management-v1 协议的窗口管理器。
River 设定的目标是降低进入 Wayland 开发的门槛，并允许其“窗口管理器”更具实验性，因为它们不需要编写整个合成器。这也实现了 Wayland 合成器通常无法完成的操作，例如在不关闭所有窗口的情况下重新加载配置。
注意 本页面介绍的是非单体版本的 River。如果您在寻找动态平铺版本，请参阅 river-classic。
安装
还需要安装一个单独的窗口管理器。更多完整的窗口管理器列表请参阅 River 的 wiki。
堆叠式
- Canoe — 使用 Rust 编写的具有经典外观和感觉的堆叠窗口管理器。
平铺式
- Kwm — 受 dwm 启发并带有内置状态栏的窗口管理器。
其他
- Rill — 一个带有简单动画的极简滚动窗口管理器。
启动
River 可以通过 显示管理器 或使用以下命令启动。
$ river
River 可以使用 "c" 参数启动并选择特定的窗口管理器。
$ river -c foo
配置
River 通过一个可执行的 shell 文件进行配置，默认位于 $XDG_CONFIG_HOME/river/init。默认路径为 ~/.config/river/init。
如果调用时使用了 "c" 参数，River 可以使用不同的配置。
$ river -c customConfPath
选择默认窗口管理器
可以通过将其添加到 River 的配置文件中来将其设为默认窗口管理器。
自启动
由于配置是由 bourne shell 执行的，因此放置在配置中的命令将在启动时执行：某些窗口管理器也允许在其自身配置中设置自动启动。
输入配置
输入配置可以通过多种方式完成。一些窗口管理器本身支持输入配置。
也可以使用独立的输入管理器，例如 Channel 和 kwimAUR。
如果只需要更改键盘布局，请将 环境变量 XKB_DEFAULT_LAYOUT 更改为所需的布局；例如英国键盘使用 "gb"。
故障排除
配置文件不起作用
这可能是由于配置文件缺乏执行权限引起的。请参阅 文件权限和属性。
通过 WebRTC 进行屏幕录制无法工作
请参阅 river-classic#Troubleshooting。