BQN 项目使用教程

BQN 项目使用教程

BQN An APL-like programming language. Self-hosted! 项目地址: https://gitcode.com/gh_mirrors/bq/BQN

1. 项目目录结构及介绍

BQN 是一种基于数组编程范式的现代编程语言，其项目目录结构清晰，各部分功能明确。以下是项目的主要目录及文件介绍：

.
├── .github/              # GitHub 工作流和文档
├── commentary/           # 项目评论和说明文档
├── community/            # 社区相关文件
├── doc/                  # 项目文档
├── editors/              # 编辑器插件相关文件
├── examples/             # 示例代码
├── fonts/                # 字体文件
├── help/                 # 帮助文档
├── implementation/       # 实现细节
├── spec/                 # 语言规范
├── src/                  # 源代码
├── test/                 # 测试文件
├── tutorial/             # 教程文档
├── LICENSE               # 许可证文件
├── README.md             # 项目说明文件
├── bqn.bqn               # BQN 语言的主要源文件
├── bqn.js                # JavaScript 实现
├── gendocs               # 生成文档的工具
├── keymap.md             # 键盘映射文档
├── logo.svg              # 项目 SVG 标志
├── md.bqn                # Markdown 转换工具
├── rt.bqn                # 运行时相关文件
├── running.md            # 运行指南
├── svg.bqn               # SVG 转换工具
├── vm.bqn                # 虚拟机实现
└── wc.bqn                # 词计数工具

2. 项目的启动文件介绍

在 BQN 项目中，主要启动文件是 bqn.bqn，这是 BQN 语言的核心实现文件。使用 BQN 语言编写的代码将在此文件中被解释和执行。在本地环境或在线环境中，你可以通过以下方式启动 BQN：

• 在本地环境，首先确保安装了 BQN 解释器，然后运行 bqn.bqn 文件。
• 在在线环境，可以访问 BQN 的在线解释器，直接输入 BQN 代码进行执行。

3. 项目的配置文件介绍

BQN 项目的配置文件主要集中在 .github 目录下，这里包含了项目的工作流配置。这些配置文件用于自动化项目的某些任务，例如自动执行测试、文档生成等。

此外，项目中的 md.bqn 文件是一个 Markdown 转换工具，它用于将 BQN 的文档从 Markdown 格式转换为 BQN 格式，以便于在项目文档中使用 BQN 特有的字符和语法。

在开始使用 BQN 项目之前，建议先阅读 README.md 文件，了解项目的总体信息和如何开始使用。随后，可以参考 tutorial/ 目录下的教程，逐步学习 BQN 语言的基础知识。

BQN An APL-like programming language. Self-hosted! 项目地址: https://gitcode.com/gh_mirrors/bq/BQN