作者：流浪舟
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，以上就是简单的玩一玩开源项目，具体大家可自行研究，有问题或探讨可以关注我公众号加群！
公众号：小码之光