Una | 尤娜

一个基于Spring Boot 2.0构建的Java博客系统

序言

实现尤娜主题渲染标签的目的是为了能够加快主题皮肤的制作,对于不熟悉Java语言或者对Spring Boot不太了解的朋友也能快速的定制出自己的博客主题。尤娜主题渲染标签是在Freemarker框架的基础上实现的,沿用了Freemarker的基础标签,如逻辑判断(if语句,if…else语句,多重if…else语句,switch语句等),数据迭代(对象数组,分页),数据格式化(时间格式化)以及数据排序等。尤娜主题渲染标签分为全局常量,内容标签,格式化函数,脚本函数和分页函数五类,在接下来的内容中,将做详细介绍。下面是Freemarker的基本原理图,对Freemarker不是太熟悉的朋友可访问其官网(https://freemarker.apache.org/) 了解更多详细的知识。

全局常量

全局常量主要针对尤娜博客的基本配置信息,如站点名称,域名,Logo,备案号,版权信息等。下表列出了尤娜主题渲染标签所包含的所有全局常量标签(una-boot-v1.2.2版本):

KEY VALUE DEMO
copyright 版权号 ${copyright!’’}
domain 域名 ${domain!’’}
description 站点简介 ${description!’’}
email 联系邮箱 ${email!’’}
favicon 浏览器小图标,Base64格式 ${favicon!’’}
gitalk_client_id Gitalk评论插件ID ${gitalk_client_id!’’}
gitalk_client_secret Gitalk评论插件密钥 ${gitalk_client_secret!’’}
gitalk_admin Gitalk仓库管理员 ${gitalk_admin!’’}
gitalk_owner Gitalk仓库所有者 ${gitalk_owner!’’}
gitalk_repo Gitalk仓库名称 ${gitalk_repo!’’}
gitalk_enabled Gitalk评论插件开关 ${gitalk_enabled}
icp ICP备案号 ${icp!’’}
iscp 网安备案号 ${iscp!’’}
keywords 网站关键词 ${keywords!’’}
logo Logo,Base64格式 ${logo!’’}
title 网站标题 ${title!’’}
theme 网站主题名称,默认为default ${theme}
una 网站的上下文路径 ${una}

提示:

在使用全局常量时,最好做空值处理(!’xxxx’),提供一个默认值,因为尤娜主题渲染标签是在Freemarker的基础上实现的,Freemarker就像一个玻璃制品,好用漂亮,但易碎!!!最好是在取值时做好空值处理。