ClojureScript TUI 模板项目教程

ClojureScript TUI 模板项目教程

cljs-tui-template A leiningen template to generate ClojureScript Terminal-User-Interface applications built on web technologies you already know. 项目地址: https://gitcode.com/gh_mirrors/cl/cljs-tui-template

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

<root>
|-- bin/
|   |-- <project-name> - 用于运行编译后的应用的 JS 脚本
|-- docs/
|   |-- intro.md - 文档介绍模板
|-- env/
|   |-- <project_name>/
|       |-- debug/views.cljs - 调试视图，显示当前状态和捕获的文本输出
|       |-- app.cljs - 开发应用入口点，处理重新加载、重新渲染和初始化调试视图
|   |-- dev/user.clj - 仅用于 figwheel 构建
|-- scripts/
|   |-- build - 用于创建生产构建的 bash 脚本
|-- src/
|   |-- <project_name>/
|       |-- demo/
|           |-- views.cljs - 演示应用视图，可以根据需要修改
|       |-- core.cljs - 初始化状态依赖，如 reframe、reagent 和 blessed
|       |-- events.cljs - re-frame 事件处理程序和拦截器，用于更新应用状态数据库
|       |-- keys.cljs - 处理按键和全局键盘事件的工具
|       |-- main.cljs - 生产应用入口点
|       |-- subs.cljs - re-frame 订阅，用于应用状态数据库
|       |-- views.cljs - 通用视图，如基本路由器和垂直菜单组件
|-- test/
|   |-- <project_name>/
|       |-- core_test.cljs - 示例测试，应失败直到修复
|       |-- test_runner.cljs - 仅用于 figwheel 构建，运行测试并确保正确的退出代码
|-- .gitignore
|-- .hgignore
|-- CHANGELOG.md
|-- dev.cljs.edn - figwheel-main 开发配置
|-- figwheel-main.edn - figwheel-main 配置
|-- LICENSE
|-- package.json - 用于管理 npm 模块和发布到 npm 的配置
|-- prod.cljs.edn - figwheel-main 生产配置
|-- project.clj - 仅用于 figwheel 构建
|-- README.md
|-- shadow-cljs.edn - Shadow-cljs 构建配置

2. 项目的启动文件介绍

开发启动文件

• src/<project_name>/app.cljs：开发应用的入口点，处理重新加载、重新渲染和初始化调试视图。
• src/<project_name>/main.cljs：生产应用的入口点。

运行命令

• 开发模式：npm start
• 生产模式：npm run build

3. 项目的配置文件介绍

project.clj

• 用于管理项目的依赖和构建配置，仅用于 figwheel 构建。

shadow-cljs.edn

• Shadow-cljs 构建配置文件，用于管理 ClojureScript 的构建过程。

figwheel-main.edn

• figwheel-main 配置文件，用于管理开发和生产构建。

dev.cljs.edn 和 prod.cljs.edn

• 分别用于 figwheel-main 的开发和生产配置。

package.json

• 用于管理 npm 模块和发布到 npm 的配置。

LICENSE

• 项目许可证文件。

README.md

• 项目介绍和使用说明。

CHANGELOG.md

• 项目变更日志。

cljs-tui-template A leiningen template to generate ClojureScript Terminal-User-Interface applications built on web technologies you already know. 项目地址: https://gitcode.com/gh_mirrors/cl/cljs-tui-template