本文適合剛學習完 Java 語言基礎的人羣,跟着本文可瞭解和運行 Tale 項目。示例均在 Windows 操做系統下演示css
本文做者:HelloGitHub-秦人html
HelloGitHub 推出的《講解開源項目》系列,今天給你們帶來一款基於 Java 語言的輕量級博客開源項目——Tale前端
它擁有小、美、快、穩的特色。該項目徹底開源、免費,可以讓你快速搭建包含前、後臺的博客系統,大大節省了搭建私人博客的時間,開箱即用。讓你能夠專一於創做,讓有故事的人更方便的表達想法。java
Tale 的項目地址:github.com/otale/talegit
想要快速搭建一套本身的博客,那就跟着本文的步驟。你只須要花 5 分鐘,就能擁有一個屬於本身的私人博客了,而且能夠對整個項目有一個完成的概念和感受。下面是搭建完成的效果圖:github
那就讓咱們開始吧!web
Tale 基於的技術以下:sql
該項目採用 MVC 模式:Model 數據層、View 展示層,Controller 邏輯層。下面簡單介紹下項目的結構,便於咱們翻閱源碼、開發和運行。項目結構以下圖:shell
項目分爲前端、後臺兩部分,下面咱們分開來介紹:數據庫
annotation
:自定義註解目錄,包括系統日誌的註解類。bootstarp
:初始化操做目錄,包括初始化進程類, sqlite數據庫初始化類,公共常量類等。controller
:業務的控制器目錄,包括文章控制器,分類控制器,初始化博客的控制器等。extension
:底層公用代碼目錄,包括後臺公共函數,主題公共函數。hooks
:攔截器/過濾器目錄,作一些攔截器的操做。model
:數據模型目錄,包括數據庫模型,參數模型,業務模型。service
:業務層目錄,包括站點,系統配置,分類,標籤,文章,評論的業務類。task
:定時任務目錄,可自定時添加定時任務。utils
:業務層工具類目錄,包括圖像工具類,緩存工具類,公用工具類。validators
:驗證器目錄,包括保存文章的校驗,添加評論的校驗功能。Application
:入口類,在 IDE 中可直接運行。plugins
:插架存放目錄,此目錄做者廢棄了static
:靜態資源目錄,包括 css、images、js 和第三方插件templates
:模板資源目錄,包括後臺管理界面、公共模板和主題模板,支持擴展主題application*.properties
:項目環境配置文件Tale 的項目的結構很簡單和清晰,想把它運行起來也超級簡單。你是否是開始手癢癢了,那接下來咱們一塊兒讓它運行起來吧。
經過 git clone
命令把項目下載到本地:
git clone https://github.com/otale/tale.git
複製代碼
我這裏介紹了兩種運行方式:經過 IDE 運行和命令行運行。
com.tale.Application
類,直接運行:mvn clean package -Pprod -Dmaven.test.skip=true
複製代碼
tale\target\dist\
目錄運行 tale-latest.jar
java -jar tale-latest.jar
複製代碼
啓動成功以下圖:
後臺管理頁面以下圖:
Tale 博客包含的功能就不一一介紹了,跟着項目的文檔,在 web 頁面「點點點」就能夠了。那麼快去寫本身博客上的第一篇博客吧!
教程至此,這個項目應該已經在你的本地跑起來了。是否是頗有成就感?後面怎麼玩就看你本身了:部署到服務器正式上線、定製本身專屬的功能、給項目貢獻代碼等,都是能夠的。
本教程是針對有必定 Java 編程基礎,但又不知道若是運行本項目的小夥伴。若是你是老手歡迎直接閱讀下面參考資料,獲取更多更詳細的資料。
『講解開源項目系列』啓動——讓對開源項目感興趣的人再也不畏懼、讓開源項目的發起者再也不孤單。跟着咱們的文章,你會發現編程的樂趣、使用和發現參與開源項目如此簡單。歡迎聯繫咱們給咱們投稿,讓更多人愛上開源、貢獻開源~