Maru 项目启动与配置教程

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

Maru 项目是一个轻量级的自托管 Lisp 方言，其源代码托管在 GitHub 上。项目的目录结构如下：

• boot.l: 包含启动时的核心代码。
• default.nix: Nix 系统的配置文件，用于创建一个与作者开发环境相同的环境。
• doc/: 包含项目的文档，介绍了项目的细节和使用方式。
• eval.c: C 语言编写的评估器，是启动过程中的一个基础组件。
• eval.l: Lisp 语言编写的评估器，是项目的核心文件之一。
• manifest.scm: Scheme 文件，用于生成构建系统的配置。
• Makefile: Makefile 文件，用于编译和测试项目。
• README.md: 项目说明文件，包含项目的基本信息和如何开始使用。
• source/: 包含项目的主要 Lisp 源代码。
• tests/: 包含项目的测试代码。
• tools-for-build/: 包含构建过程中使用的工具代码。
• .envrc: 环境变量配置文件。
• .gitignore: Git 忽略文件，用于指定 Git 应该忽略的文件和目录。

2. 项目的启动文件介绍

项目的启动主要依赖于以下几个文件：

• boot.l: 这是启动脚本，负责初始化环境和加载其它必要的组件。
• eval.c 和 eval.l: 这两个文件共同构成了项目的评估器，eval.c 是 C 语言版本，用于初期启动，而 eval.l 是 Lisp 语言版本，是项目的核心。

在启动项目时，通常会先运行 Makefile 中的 make 命令，该命令会编译和链接相关的源代码文件，生成可执行文件，并运行自托管的 Lisp 解释器。

3. 项目的配置文件介绍

项目的配置主要涉及以下文件：

• default.nix: 如果你在 Nix 系统上工作，这个文件将帮助你设置一个隔离的开发环境，确保依赖项的版本与其他开发者一致。
• manifest.scm: 这个文件用于配置构建系统，定义了构建过程中的各种参数和依赖。
• Makefile: 这个文件是项目构建的核心，定义了编译、测试等构建步骤。

对于大多数用户来说，最直接的配置是通过修改 Makefile 文件来实现，例如，更改编译选项或指定不同的后端平台。如果你使用的是 Nix 系统，default.nix 文件可以确保你的开发环境与作者的环境保持一致。

在开始之前，请确保你已经阅读了 README.md 文件，它提供了关于如何获取依赖、编译和测试项目的详细说明。