Kotlin Hands-On 项目启动与配置教程

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

Kotlin Hands-On 项目是一个开源的互动教程，旨在帮助开发者学习和掌握 Kotlin 语言。项目的目录结构如下：

• .github/: 存放 GitHub Actions 工作流配置文件。
• assets/: 存放项目中使用的图片和其他资源文件。
• lab-name/: 每个实验室（lab）的文件夹，包含对应的Markdown教程文件和资源。
  • 00_description.md: 实验室描述文件，显示在教程列表中。
  • 01_Introduction.md: 实验室介绍文件，概述实验室内容。
  • NN_{step-title}.md: 每个步骤的Markdown文件，其中NN是步骤编号，{step-title}是步骤标题。
• LICENSE: 项目许可证文件，本项目采用 Apache-2.0 许可。
• README.md: 项目自述文件，提供项目概述和贡献指南。

2. 项目的启动文件介绍

项目的启动主要是通过阅读 README.md 文件开始的。该文件提供了项目的总体描述、如何开始学习教程以及如何贡献自己的内容。

对于每个实验室（lab），通常会有一个对应的步骤文件 01_Introduction.md，该文件会引导用户了解即将进行的学习内容，并通常会展示一个完成后的结果截图。

3. 项目的配置文件介绍

项目的配置主要是通过 .github/workflows 目录下的 GitHub Actions 工作流文件进行的。这些配置文件用于自动化项目的构建、测试和其他相关任务。

以下是一些主要配置文件的简要介绍：

• chore(workflow): change repo of verifier action: 这个文件用于更改验证器操作的存储库。
• java: 这个文件配置了用于构建和测试 Java 项目的步骤。
• kotlin: 这个文件配置了用于构建和测试 Kotlin 项目的步骤。

项目的每个实验室（lab）通常会有自己的 gitignore 文件，用于指定在 Git 仓库中应该忽略的文件和目录，例如构建产物、IDE配置文件等。

每个实验室的代码库也会有一个 README.md 文件，其中包含了项目许可证信息、JetBrains GitHub 标签和指向对应实验室的链接。此外，项目的主分支（master）通常包含项目的初始状态，而最终状态和完整的提交历史则存储在 final 分支中。