Halo开源博客项目配置
作者:流浪舟
README
简介
Halo [ˈheɪloʊ]
,意为光环。Halo 是一款现代化的个人独立博客系统,给习惯写博客的同学多一个选择。当然,你也可以当成拼音读(哈喽)。
声明
本项目旨在创造一个好的产品以供人们使用(虽然现在并不是太好),并非一个所谓提供学习的项目。所以,不提供任何学习代码的帮助。也请不要在讨论群,issues,论坛发起任何有关代码学习的问题。当然,如果你是要参与代码贡献,我们非常欢迎。
另外,写给想自己拉代码编译运行的同学:
目前我们的开发分支即 master,肯定会有很多小问题,不要运行不起来就跑过来吐槽什么代码开源不完整之类的,多找找自己的原因。同时建议下载最新 release 版本的代码,或者在 master 分支执行
git checkout v1.3.2
。
PS:实在不想写这个声明(影响 README 的美观),但是就目前来看,写在 README 上是有必要的,因为大部分遇到问题的人都不会去仔细阅读文档。
快速开始
下载最新的 Halo 安装包
curl -L https://github.com/halo-dev/halo/releases/download/v1.3.2/halo-1.3.2.jar --output halo-latest.jar
或者
wget https://github.com/halo-dev/halo/releases/download/v1.3.2/halo-1.3.2.jar -O halo-latest.jar
启动 Halo
java -jar halo-latest.jar
详细部署文档请移步:https://halo.run/archives/install-quick-start.html
博客示例
请移步: https://halo.run/p/user-wall.html。
周边
-
后台管理(halo-admin):https://github.com/halo-dev/halo-admin
-
独立评论模块(halo-comment):https://github.com/halo-dev/halo-comment
-
管理 APP(已停止维护):https://github.com/halo-dev/halo-app
-
资源下载:https://dl.halo.run
-
WeHalo 小程序:https://github.com/aquanlerou/WeHalo
启动项目前配置
项目为gradle项目,项目依赖文档配置在build.gradle,开始前确保能自动导入依赖,导入需要花费一些时间。之后可以进行具体的配置,如数据库的配置,找到文件application.yaml文件。
将h2数据库的enabled和web-allow-others改为true
差不多就可以启动整个项目了,怎么启动呢?之前已经有经验了吧,介绍了一个eladmin后台管理系统的项目,难度或者复杂度比这个大一点,其中就讲了具体的项目的启动配置。找到项目中唯一能运行的源代码文件,一般在源代码文档src/main/java里面,找到它,命名一般是AppRun或ApplicationRun或者Application的Java文件,打开能看到有main()函数的,就是项目启动文件。IDEA会自动找到可运行的启动文件,并打开绿色小三角按钮,点击小三角启动它!
可以看到左下角项目在编译运行。
启动后没有乱码和红色报错,说明配置对了。
如果出现乱码的情况,说明编译的时候没有配置好,而编码需要的是UTF-8,找到项目的依赖配置文件build.gradle,添加如下配置。
tasks.withType(JavaCompile) {
options.encoding = 'UTF-8'
}
如果出现红色报错,说明有其他配置问题,很大原因是导入依赖不成功,受到了网速影响,需要重新导入模块。还有问题请加群交流,这里不做详细的解释!
预览图
这个halo博客后台支持markdown语法的编辑,对写博客非常友好!
总结
对比其他博客框架,halo博客是一个动态的博客系统,有前端,有后台,可以自己买个服务器搭一搭。而其他的开源博客,有一部分是没有后台的,修改上传文章主要在线下完成,所以维护起来十分费劲。如果可以的话还可以动手改halo的样式,halo也有其他主题样式供选择。OK,以上就是简单的玩一玩开源项目,具体大家可自行研究,有问题或探讨可以关注我公众号加群!
公众号:小码之光