Lokke 项目启动与配置教程

1. 项目目录结构及介绍

Lokke 项目是一个将 Clojure 语言方言实现为 Guile 扩展的开源项目。以下是项目的目录结构及其简要介绍：

lokke/
├── bin/                      # 存放可执行文件
├── build-aux/                # 构建辅助文件
├── ci/                       # 持续集成相关脚本
├── dev/                      # 开发辅助文件
├── doc/                      # 文档目录
├── example/                  # 示例代码
├── gen-makefile              # 生成 Makefile 的脚本
├── hello.clj                 # 示例 Clojure 文件
├── INSTALL                   # 安装指南
├── Lokke.1.in                # Lokke 手册页模板
├── Makefile.am.in            # Makefile 模板
├── README.md                 # 项目说明文件
├── configure.ac              # 自动配置脚本
├── copying                   # 法律文件
├── design.md                 # 设计文档
├── epl-1.0                   # 许可证文件
├── install.sh                # 安装脚本
├── lgpl-2.1                  # 许可证文件
└── setup                     # 设置脚本

• bin/: 包含 Lokke 的可执行文件。
• build-aux/: 构建过程中的辅助文件，如编译器和链接器脚本。
• ci/: 持续集成脚本，用于自动化测试和构建。
• dev/: 开发辅助文件，如开发工具的配置。
• doc/: 文档目录，包含项目文档。
• example/: 包含示例代码，展示如何使用 Lokke。
• gen-makefile: 脚本用于生成 Makefile 文件。
• hello.clj: 一个简单的 Clojure 示例文件。
• INSTALL: 包含安装指南的文本文件。
• Lokke.1.in: Lokke 的手册页模板。
• Makefile.am.in: Makefile 模板文件。
• README.md: 项目说明文件，包含项目简介和安装说明。
• configure.ac: 自动配置脚本，用于生成 Makefile。
• copying: 包含项目使用的许可协议。
• design.md: 包含项目设计文档。
• epl-1.0 和 lgpl-2.1: 项目的许可证文件。
• setup: 设置脚本，用于项目初始化。

2. 项目的启动文件介绍

项目的启动文件主要是 bin/ 目录下的 lokke 可执行文件。此文件是项目的入口点，可以用来运行 Clojure 程序或启动 REPL。

运行示例：

./lok -l hello.clj

上述命令会加载并执行 hello.clj 文件。

启动 REPL：

./lok

启动后会进入 Lokke 的 REPL 环境，可以交互式地编写和执行 Clojure 代码。

3. 项目的配置文件介绍

Lokke 项目的配置文件主要包括 ~/.config/lokke/interactive.scm 和环境变量。

• ~/.config/lokke/interactive.scm: Lokke REPL 的配置文件，用于设置 REPL 环境和行为。例如，可以在此文件中添加 readline 支持以启用历史记录和命令行编辑功能。

  (use-modules (ice-9 readline))
  (activate-readline)
  

• 环境变量：项目使用环境变量来设置一些配置选项，例如：

  • GUILE_LOAD_PATH: 设置 Guile 的加载路径，用于指定 Lokke 寻找命名空间的位置。
  • LOKKE_HISTORY: 设置 REPL 历史记录文件的存储位置。

  export GUILE_LOAD_PATH=/path/to/lokke/modules:$GUILE_LOAD_PATH
  export LOKKE_HISTORY=/path/to/history/file
  

确保正确配置这些文件和环境变量，以使 Lokke 正常运行和交互。