Halo 是一个优秀的开源博客发布应用，在 GitHub 上广受好评，正好最近在练习写博客，借此记录一下学习 Halo 的过程。
项目下载从 GitHub 上拉取项目源码，Halo 从 1.4.3 开始，最低支持的 JRE 版本为 11，本人下载的是 1.4.13 版本。
前提设置导入项目
因为 Halo 使用 Gradle 构建，所以在 idea 中导入 Gradle 项目，与 Maven 不同，Gradle 项目的依赖在 build.gradle 中添加。
Halo 中主要使用了如下依赖：
- Spring Boot：一个用来简化 Spring 的搭建和开发过程的全新框架；
- Spring Data JPA：持久层框架；
- Spring Web：构建 Web 应用；
- Undertow：高性能 Web 容器；
- Freemarker：模板引擎；
- H2 Database：嵌入式数据库，无需安装；
- MySQL：关系型数据库；
- Lombok：Java 高效开发工具；
- Swagger：生成接口文档；
- Hutool：开源 Java 工具类；
- 七牛云：云存储服务器；
- 阿里云 OSS：提供海量、安全、低成本、高可靠的云存储服务；
- Flexmark：将 Markdown 转化为 HTML。
ieda 设置
Halo 使用的是 JDK 11，所以需要将 idea 中的 JDK 版本设置成 JDK 11。依次点击 File -> Project Structure -> Project SDK 设置 JDK。
Gradle 也需要设置为 JDK 11，依次点击 File -> Settings -> 搜索 Gradle 设置 JDK。
启动项目
注意事项
项目启动前请做好如下准备：
- 确保 JDK 的版本符合要求，本文使用 JDK 11；
- 确保所有的依赖都正常导入（本次实践未发生异常）；
- 确保 resources/templates/themes 目录不为空，正常情况下应该有 anatole 文件夹。为空是因为使用 Git 克隆时没有克隆子模块，可以在 Halo 官网的主题仓库下载 Anatole 主题，解压后重命名为 anatole，并复制到 themes 目录下；
- Halo 默认使用 H2 Database，该数据库无需安装，因此可以直接启动项目。如果希望使用 MySQL，则需要在 application.yaml 文件中注释掉 H2 Database 的配置，并添加 MySQL 的相关配置（数据库名为 'halodb'）：
# MySQL 配置
driver-class-name: com.mysql.cj.jdbc.Driver
url: jdbc:mysql://127.0.0.1:3306/halodb?characterEncoding=utf8&useSSL=false&serverTimezone=Asia/Shanghai&allowPublicKeyRetrieval=true
username: root
password: 123456
运行项目
点击运行，项目正常启动，控制台打印了如下信息：
上述信息提示我们访问 127.0.0.1:8090，首次访问该页面时，页面会重定向到初始化页面，用户需要设置博主、博客的相关信息，如用户名、密码等。
信息填写完毕后，点击安装，之后页面会跳转到登录页面，此时用户可以使用之前设置的账号和密码进行登录。登录成功后进入 'Halo Dashboard' 页面，且系统会自动创建一篇文章 'Hello Halo!'。'Halo Dashboard' 页面是博客的后台管理页面，供管理员使用，访问 127.0.0.1:8090/admin 时就会进入该页面（需登录）。
博客的主页可访问 127.0.0.1:8090，在该页面可看到博主发表的所有文章。
至此，Halo 项目在 idea 上启动成功！