5分钟搭建私人Java博客系统——Tale

本文适合刚学习完 Java 语言基础的人群，跟着本文可了解和运行 Tale 项目。示例均在 Windows 操做系统下演示

本文做者：HelloGitHub-秦人

HelloGitHub 推出的《讲解开源项目》系列，今天给你们带来一款基于 Java 语言的轻量级博客开源项目——Tale

它拥有小、美、快、稳的特色。该项目彻底开源、免费，可以让你快速搭建包含前、后台的博客系统，大大节省了搭建私人博客的时间，开箱即用。让你能够专一于创做，让有故事的人更方便的表达想法。

Tale 的项目地址：github.com/otale/tale

想要快速搭建一套本身的博客，那就跟着本文的步骤。你只须要花 5 分钟，就能拥有一个属于本身的私人博客了，而且能够对整个项目有一个完成的概念和感受。下面是搭建完成的效果图：

那就让咱们开始吧！

1、技术栈

Tale 基于的技术以下：

• Blade 框架：快速搭建 Web 应用程序的开源框架，该框架代码简洁、风格优雅。
• Jetbrick-template 模板引擎：适合于动态 HTML 页面输出或者代码生成，可替代 JSP 页面或者 Velocity 等模板。 指令和 Velocity 类似，表达式和 Java 保持一致，易学易用。
• SQLite 数据库：是一种嵌入式数据库,它的数据库就是一个文件。

2、项目结构

该项目采用 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、实战操做

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 页面“点点点”就能够了。那么快去写本身博客上的第一篇博客吧！

4、最后

教程至此，这个项目应该已经在你的本地跑起来了。是否是颇有成就感？后面怎么玩就看你本身了：部署到服务器正式上线、定制本身专属的功能、给项目贡献代码等，都是能够的。

本教程是针对有必定 Java 编程基础，但又不知道若是运行本项目的小伙伴。若是你是老手欢迎直接阅读下面参考资料，获取更多更详细的资料。

5、参考资料

• tale wiki

• Blade 官方文档

• jetbrick-template 项目地址

• Blade 项目地址

欢迎关注 HelloGitHub 公众号，获取更多开源项目的资料和内容

『讲解开源项目系列』启动——让对开源项目感兴趣的人再也不畏惧、让开源项目的发起者再也不孤单。跟着咱们的文章，你会发现编程的乐趣、使用和发现参与开源项目如此简单。欢迎联系咱们给咱们投稿，让更多人爱上开源、贡献开源～