PipeWorld 使用与安装指南
pipeworldDataflow 'spreadsheet' desktop environment项目地址:https://gitcode.com/gh_mirrors/pi/pipeworld
1. 项目目录结构及介绍
PipeWorld 是一个受 userland 启发的缩放式数据流工具和桌面环境,它结合了shell脚本的可编程处理、电子表格的交互式视觉编程模型、显示服务器的场景图、交互控制、进程间通信(IPC)等特性,所有这些整合在一个具有缩放平铺窗口管理的模型中。下面是其主要目录结构及其简介:
- root
scripts/
: 存储命令表,可以定义并执行一系列操作来设置工作空间或测试变更。pipeworld/
: 核心源码和资源所在目录。devmaps/
: 包含主题配置和地图,允许在运行时通过表达式切换主题。keybindings.lua
: 默认输入绑定,用户可以在此添加自定义键绑定。commands.lua
: 存储可供键绑定映射的各种命令。
gitignore
,LICENSE
,README.md
, 等标准GitHub项目文件。IDEAS.md
,HACKING.md
,TODO.md
: 分别记录项目构想、开发指导、待办事项。
2. 项目的启动文件介绍
项目的主要启动入口是通过执行脚本或指定路径给Arcan的方式进行。通常,启动PipeWorld可以通过以下两种方法之一:
- 直接通过Arcan显示服务器调用项目路径:
arcan /path/to/pipeworld/pipeworld
- 如果已经将PipeWorld添加到Arcan的应用程序路径(
arcan/appl
或/usr/share/arcan/appl
),则可以直接简化命令:arcan pipeworld
这要求你的系统中已有一个工作的Arcan环境,并且建议直接使用最新的master分支以避免可能因依赖包带来的奇怪行为。
3. 项目的配置文件介绍
主要配置文件
keybindings.lua
: 此文件存储默认的输入绑定信息,对于定制用户的交互体验至关重要。你可以在这里添加自己的键绑定,以便与pipeworld/commands.lua
中的命令相匹配。commands.lua
: 这个文件包含了项目可用的所有命令集合,理解这部分可以帮助用户或开发者扩展功能和响应不同的用户输入事件。
主题与个性化配置
pipeworld/devmaps/themes/
: 这个目录保存了主题相关的Lua脚本,允许用户在运行期间动态改变界面主题。默认情况下,default.lua
会被自动应用且为空,方便用户直接修改而不影响版本控制系统。
特殊配置需求
- 对于更细粒度的调整,如输入控制、视感外观等,查看
bindings.lua
和config.lua
文件将是必要的,尤其是当你需要适配不同桌面环境或个人偏好时。
本指南提供了快速了解PipeWorld的基本结构、启动流程以及配置调整的方向。深入探索每个部分的细节,将帮助用户更好地定制和利用这个强大的数据流工具与桌面环境。
pipeworldDataflow 'spreadsheet' desktop environment项目地址:https://gitcode.com/gh_mirrors/pi/pipeworld