本文適合剛學習完 Java 語言基礎的人群，跟著本文可了解和運行 Tale 項目。示例均在 Windows 操作系統下演示

本文作者：HelloGitHub-秦人

?

HelloGitHub 推出的《講解開源項目》[1]系列，今天給大家帶來一款基于 Java 語言的輕量級博客開源項目——Tale

它擁有小、美、快、穩的特點。該項目完全開源、免費，能夠讓你快速搭建包含前、后臺的博客系統，大大節省了搭建私人博客的時間，開箱即用。讓你可以專注于創作，讓有故事的人更方便的表達想法。

Tale 的項目地址：https://github.com/otale/tale

想要快速搭建一套自己的博客，那就跟著本文的步驟。你只需要花 5 分鐘，就能擁有一個屬于自己的私人博客了，并且可以對整個項目有一個完成的概念和感覺。下面是搭建完成的效果圖：

那就讓我們開始吧！

一、技術棧

Tale 基于的技術如下：

?Blade 框架：快速搭建 Web 應用程序的開源框架，該框架代碼簡潔、風格優雅。?Jetbrick-template 模板引擎：適合于動態 HTML 頁面輸出或者代碼生成，可替代 JSP 頁面或者 Velocity 等模板。指令和 Velocity 相似，表達式和 Java 保持一致，易學易用。?SQLite 數據庫：是一種嵌入式數據庫,它的數據庫就是一個文件。

二、項目結構

該項目采用 MVC 模式：Model 數據層、View 展現層，Controller 邏輯層。下面簡單介紹下項目的結構，便于我們翻閱源碼、開發和運行。項目結構如下圖：

項目分為前端、后臺兩部分，下面我們分開來介紹：

2.1 后臺代碼目錄說明

?annotation：自定義注解目錄，包括系統日志的注解類?bootstarp：初始化操作目錄，包括初始化進程類， sqlite數據庫初始化類，公共常量類等。?controller：業務的控制器目錄，包括文章控制器，分類控制器，初始化博客的控制器等。?extension：底層公用代碼目錄，包括后臺公共函數，主題公共函數。?hooks：攔截器/過濾器目錄，做一些攔截器的操作。?model：數據模型目錄，包括數據庫模型，參數模型，業務模型?service：業務層目錄，包括站點，系統配置，分類，標簽，文章，評論的業務類。?task：定時任務目錄，可自定時添加定時任務。?utils：業務層工具類目錄，包括圖像工具類，緩存工具類，公用工具類。?validators：驗證器目錄，包括保存文章的校驗，添加評論的校驗功能。?Application：入口類，在 IDE 中可直接運行。

2.2 前臺代碼目錄說明

?plugins：插架存放目錄，此目錄作者廢棄了?static：靜態資源目錄，包括 css、images、js 和第三方插件?templates：模板資源目錄，包括后臺管理界面、公共模板和主題模板，支持擴展主題?application*.properties：項目環境配置文件

Tale 的項目的結構很簡單和清晰，想把它運行起來也超級簡單。你是不是開始手癢癢了，那接下來我們一起讓它運行起來吧。

三、實戰操作

3.1 準備工作

1.確保本地已安裝 Java8 開發環境：2. 確保本地已安裝 maven 工具：

3.2 下載項目

通過?git clone?命令把項目下載到本地：

git clone https://github.com/otale/tale.git

3.3 運行項目

我這里介紹了兩種運行方式：通過 IDE 運行和命令行運行。

3.3.1 方法一：通過 IDE 運行

1. 將項目導入到 IDE 中，這里我使用的是開發工具是 IDEA：

2.找到?com.tale.Application?類，直接運行：

? 3.運行成功，如下圖：

3.3.2 命令行運行

1. 切換到項目源碼路徑，編譯源碼命令如下：

mvn clean package -Pprod -Dmaven.test.skip=true

?

2. 切換到?tale\target\dist\?目錄

?

?

3.解壓 tale.zip 壓縮文件

?

4. 運行?tale-latest.jar

java?-jar??tale-latest.jar

5. 啟動成功如下圖：

3.4 項目啟動成功

1. 初始化配置，訪問：http://127.0.0.1:9000/ 首次登錄，需要填寫配置信息：

2. 登錄后臺管理系統，后臺系統鏈接：http://127.0.0.1:9000/admin/login 輸入管理員賬號和密碼：admin 即可登錄：

?

后臺管理頁面如下圖：

3.博客前臺頁面，博客前臺鏈接：http://127.0.0.1:9000/

?

Tale 博客包含的功能就不一一介紹了，跟著項目的文檔，在 web 頁面“點點點”就可以了。那么快去寫自己博客上的第一篇博客吧！

四、最后

教程至此，這個項目應該已經在你的本地跑起來了。是不是很有成就感？后面怎么玩就看你自己了：部署到服務器正式上線、定制自己專屬的功能、給項目貢獻代碼等，都是可以的。

本教程是針對有一定 Java 編程基礎，但又不知道如果運行本項目的小伙伴。如果你是老手歡迎直接閱讀下面參考資料，獲取更多更詳細的資料。

References

[1]?《講解開源項目》:?https://github.com/HelloGitHub-Team/Article[2]?tale wiki:?https://github.com/otale/tale/wiki[3]?Blade 官方文檔:?https://lets-blade.com/docs/why-blade.html[4]?jetbrick-template 項目地址:?https://gitee.com/sub/jetbrick-template[5]?Blade 項目地址:?https://github.com/lets-blade/blade

?

關注公眾號加入交流群，一起討論有趣的技術話題

?

『講解開源項目系列』——讓對開源項目感興趣的人不再畏懼、讓開源項目的發起者不再孤單。跟著我們的文章，你會發現編程的樂趣、使用和發現參與開源項目如此簡單。歡迎聯系我（微信：xueweihan，備注：講解）加入我們，讓更多人愛上開源、貢獻開源～

總結

以上是生活随笔為你收集整理的5分钟搭建私人Java博客系统——Tale的全部內容，希望文章能夠幫你解決所遇到的問題。

如果覺得生活随笔網站內容還不錯，歡迎將生活随笔推薦給好友。