项目简介
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 上启动成功!
来源:https://www.cnblogs.com/johnlearning/p/16177338.html
本站部分图文来源于网络,如有侵权请联系删除。