本文适合刚学习完 Java 语言基础的人群,跟着本文可了解和运行 Tale 项目。示例均在 Windows 操作系统下演示
本文作者:HelloGitHub- 秦人
HelloGitHub 推出的 《讲解开源项目》 系列,今天给大家带来一款基于 Java 语言的轻量级博客开源项目—— Tale
它拥有小、美、快、稳的特点。该项目完全开源、免费,能够让你快速搭建包含前、后台的博客系统,大大节省了搭建私人博客的时间,开箱即用。让你可以专注于创作,让有故事的人更方便的表达想法。
Tale 的项目地址: https://github.com/otale/tale
想要快速搭建一套自己的博客,那就跟着本文的步骤。你只需要花 5 分钟,就能拥有一个属于自己的私人博客了,并且可以对整个项目有一个完成的概念和感觉。下面是搭建完成的效果图:
那就让我们开始吧!
Tale 基于的技术如下:
该项目采用 MVC 模式:Model 数据层、View 展现层,Controller 逻辑层。下面简单介绍下项目的结构,便于我们翻阅源码、开发和运行。项目结构如下图:
项目分为前端、后台两部分,下面我们分开来介绍:
annotation bootstarp controller extension hooks model service task utils validators Application
plugins static templates application*.properties
Tale 的项目的结构很简单和清晰,想把它运行起来也超级简单。你是不是开始手痒痒了,那接下来我们一起让它运行起来吧。
确保本地已安装 Java8 开发环境:
确保本地已安装 maven 工具:
通过 git clone
命令把项目下载到本地:
git clone https://github.com/otale/tale.git
我这里介绍了两种运行方式:通过 IDE 运行和命令行运行。
将项目导入到 IDE 中,这里我使用的是开发工具是 IDEA:
找到 com.tale.Application
类,直接运行:
运行成功,如下图:
切换到项目源码路径,编译源码命令如下:
shell mvn clean package -Pprod -Dmaven.test.skip=true
切换路径到 tale/target/dist/
目录
解压 tale.zip 压缩文件
运行 tale-latest.jar
java -jar tale-latest.jar
启动成功如下图:
初始化配置,访问: http://127.0.0.1:9000/ 首次登录,需要填写配置信息:
登录后台管理系统,后台系统链接: http://127.0.0.1:9000/admin/login 输入管理员账号和密码:admin 即可登录:
后台管理页面如下图:
博客前台页面,博客前台链接: http://127.0.0.1:9000/
Tale 博客包含的功能就不一一介绍了,跟着项目的文档,在 web 页面“点点点”就可以了。那么快去写自己博客上的第一篇博客吧!
教程至此,这个项目应该已经在你的本地跑起来了。是不是很有成就感?后面怎么玩就看你自己了:部署到服务器正式上线、定制自己专属的功能、给项目贡献代码等,都是可以的。
本教程是针对有一定 Java 编程基础,但又不知道如果运行本项目的小伙伴。如果你是老手欢迎直接阅读下面参考资料,获取更多更详细的资料。
tale wiki
Blade 官方文档
jetbrick-template 项目地址
Blade 项目地址
欢迎关注 HelloGitHub 公众号,获取更多开源项目的资料和内容
『讲解开源项目系列』启动——让对开源项目感兴趣的人不再畏惧、让开源项目的发起者不再孤单。跟着我们的文章,你会发现编程的乐趣、使用和发现参与开源项目如此简单。欢迎联系我们给我们投稿,让更多人爱上开源、贡献开源~