摘要:你只需要花分钟,就能拥有一个属于自己的私人博客了,并且可以对整个项目有一个完成的概念和感觉。指令和相似,表达式和保持一致,易学易用。
本文适合刚学习完 Java 语言基础的人群,跟着本文可了解和运行 Tale 项目。示例均在 Windows 操作系统下演示
本文作者:HelloGitHub-秦人
HelloGitHub 推出的《讲解开源项目》系列,今天给大家带来一款基于 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 准备工作确保本地已安装 Java8 开发环境:
确保本地已安装 maven 工具:
3.2 下载项目通过 git clone 命令把项目下载到本地:
git clone https://github.com/otale/tale.git3.3 运行项目
我这里介绍了两种运行方式:通过 IDE 运行和命令行运行。
3.3.1 通过 IDE 运行将项目导入到 IDE 中,这里我使用的是开发工具是 IDEA:
找到 com.tale.Application 类,直接运行:
运行成功,如下图:
3.3.2 命令行运行
切换到项目源码路径,编译源码命令如下:
mvn clean package -Pprod -Dmaven.test.skip=true
切换路径到 tale argetdist 目录
解压 tale.zip 压缩文件
运行 tale-latest.jar
java -jar tale-latest.jar
启动成功如下图:
3.4 项目启动成功初始化配置,访问:http://127.0.0.1:9000/ 首次登录,需要填写配置信息:
登录后台管理系统,后台系统链接:http://127.0.0.1:9000/admin/l... 输入管理员账号和密码:admin 即可登录:
后台管理页面如下图:
博客前台页面,博客前台链接:http://127.0.0.1:9000/
Tale 博客包含的功能就不一一介绍了,跟着项目的文档,在 web 页面“点点点”就可以了。那么快去写自己博客上的第一篇博客吧!
四、最后教程至此,这个项目应该已经在你的本地跑起来了。是不是很有成就感?后面怎么玩就看你自己了:部署到服务器正式上线、定制自己专属的功能、给项目贡献代码等,都是可以的。
本教程是针对有一定 Java 编程基础,但又不知道如果运行本项目的小伙伴。如果你是老手欢迎直接阅读下面参考资料,获取更多更详细的资料。
五、参考资料tale wiki
Blade 官方文档
jetbrick-template 项目地址
Blade 项目地址
文章版权归作者所有,未经允许请勿转载,若此文章存在违规行为,您可以联系管理员删除。
转载请注明本文地址:https://www.ucloud.cn/yun/76191.html
摘要:探究系统登录验证码的实现后端掘金验证码生成类手把手教程后端博客系统第一章掘金转眼间时间就从月份到现在的十一月份了。提供了与标准不同的工作方式我的后端书架后端掘金我的后端书架月前本书架主要针对后端开发与架构。 Spring Boot干货系列总纲 | 掘金技术征文 - 掘金原本地址:Spring Boot干货系列总纲博客地址:http://tengj.top/ 前言 博主16年认识Spin...
摘要:我采用原生编写后台,因为感觉增删改查的功能很简单,就懒得用框架了其实是不会。浏览模式它也有一个,用来切换文章列表和文章详情,也就是和编辑模式它加载了作为工具栏,然后可以进行文章的撰写与修改。 介绍 项目地址:https://github.com/jrainlau/MintloG (特别乱,参考就好-_-|||)showImg(https://segmentfault.com/img/b...
摘要:这篇文章还是利用宝塔来搭建,宝塔服务器面板,一键全能部署及管理,送你元礼包,点我领取程序的功能如下支持第三方存储目前支持阿里云,华为云,。iFileSpace 是一个在线个人文件管理工具,在线网盘程序,可快速一键搭建私人云盘,支持本地存储和对象存储(目前支持阿里云oss,华为云obs,OneDrive), 如部署在公网服务器,可替代百度网盘等在线网盘,自主搭建,数据完全自主管理!也可部署在家...
阅读 3498·2023-04-25 15:52
阅读 580·2021-11-19 09:40
阅读 2570·2021-09-26 09:47
阅读 1022·2021-09-22 15:17
阅读 3547·2021-08-13 13:25
阅读 2198·2019-08-30 15:56
阅读 3459·2019-08-30 13:56
阅读 2094·2019-08-30 11:27