作者：流浪舟
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，以上就是簡單的玩一玩開源項目，具體大家可自行研究，有問題或探討可以關注我公眾號加群！
公眾號：小碼之光