项目简介

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。

Halo 开源项目学习(一):项目启动-LMLPHP

Gradle 也需要设置为 JDK 11,依次点击 File -> Settings -> 搜索 Gradle 设置 JDK。

Halo 开源项目学习(一):项目启动-LMLPHP

启动项目

注意事项

项目启动前请做好如下准备:

  1. 确保 JDK 的版本符合要求,本文使用 JDK 11;
  2. 确保所有的依赖都正常导入(本次实践未发生异常);
  3. 确保 resources/templates/themes 目录不为空,正常情况下应该有 anatole 文件夹。为空是因为使用 Git 克隆时没有克隆子模块,可以在 Halo 官网的主题仓库下载 Anatole 主题,解压后重命名为 anatole,并复制到 themes 目录下;
  4. 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

运行项目

点击运行,项目正常启动,控制台打印了如下信息:

Halo 开源项目学习(一):项目启动-LMLPHP

上述信息提示我们访问 127.0.0.1:8090,首次访问该页面时,页面会重定向到初始化页面,用户需要设置博主、博客的相关信息,如用户名、密码等。

Halo 开源项目学习(一):项目启动-LMLPHP

信息填写完毕后,点击安装,之后页面会跳转到登录页面,此时用户可以使用之前设置的账号和密码进行登录。登录成功后进入 'Halo Dashboard' 页面,且系统会自动创建一篇文章 'Hello Halo!'。'Halo Dashboard' 页面是博客的后台管理页面,供管理员使用,访问 127.0.0.1:8090/admin 时就会进入该页面(需登录)。

Halo 开源项目学习(一):项目启动-LMLPHP

博客的主页可访问 127.0.0.1:8090,在该页面可看到博主发表的所有文章。

Halo 开源项目学习(一):项目启动-LMLPHP

至此,Halo 项目在 idea 上启动成功!

04-22 22:59