diff --git a/README.md b/README.md index 3496d6e..aa1e9cd 100644 --- a/README.md +++ b/README.md @@ -1,21 +1,21 @@

-halo-theme-dream +halo-theme-dream2.0

-

halo-theme-dream

+

halo-theme-dream2.0

-releases -license -downloads -size -commits -donate +releases +license +downloads +size +commits +donate

- +本仓库为 `Halo 2.x` 主题仓库,如果你使用的是 `Halo 1.x` ,请前往:https://github.com/nineya/halo-theme-dream ## 一、预览 -![玖涯博客](https://cdn.jsdelivr.net/gh/nineya/halo-theme-dream@master/preview.png) +![玖涯博客](https://cdn.jsdelivr.net/gh/nineya/halo-theme-dream2.0@master/preview.png) 预览:[主题预览](https://github.com/nineya/halo-theme-dream/discussions/72) > 如果你有计划长期使用 `Dream` 主题,也来[这里](https://github.com/nineya/halo-theme-dream/discussions/72)留下你的博客链接吧。 @@ -32,70 +32,27 @@ 欢迎参与主题开发的一些问题探讨 + + ## 三、版本适配关系 | 主题版本 | 适配Halo版本 | 测试用Halo版本 | | ----------- | --------------------------- | -------------- | -| 1.x | 1.4.x及以下(不保证适配性) | 1.4.8 | -| 2.0.0-2.0.1 | 1.4.x | 1.4.8 | -| 2.0.2+ | 1.5.x ~ 1.6.1 | 1.6.1 | - - -> 主题未在配置要求中对 Halo 最低版本限制得太死,但 Halo 不同版本开发接口略有不同,在不适配的版本中无法保证完全兼容。 -> -> 相对来说,测试用的 Halo 版本具有最好的适配性,是主题推荐的 `Halo` 版本。 +| 1.x | 2.0.0+ | 2.3.0 | ## 四、安装 & 更新 -### 4.1 安装包安装 & 更新 -1. 进入主题 `Release` 界面:https://github.com/nineya/halo-theme-dream/releases 下载主题压缩包 `halo-theme-dream.zip` 压缩包文件; -2. 进入博客后台管理 `外观->主题->安装->本地上传`,选择下载的 `halo-theme-dream.zip` 安装包进行上传; + +1. 进入主题 `Release` 界面:https://github.com/nineya/halo-theme-dream2.0/releases 下载主题压缩包 `halo-theme-dream.zip` 压缩包文件; +2. 进入博客后台管理 `主题->主题管理->安装主题`,选择下载的 `halo-theme-dream.zip` 安装包进行上传; 3. 等待安装完成; -4. 更新主题时同样前往主题 `Release` 界面下载主题安装包,然后通过 `外观->主题->Dream->更多->从主题包更新` 方法上传安装包进行更新。 +4. 更新主题时同样前往主题 `Release` 界面下载主题安装包,然后通过 `主题->主题管理->Dream->升级` 方法上传安装包进行更新。 -### 4.2 在线安装 & 更新 - -1. 复制主题仓库地址 `https://github.com/nineya/halo-theme-dream.git` - -2. 进入博客后台管理 `外观->主题->安装->远程下载`,黏贴仓库地址进行安装; -3. 等待安装完成; -4. 在线更新主题时,通过 ``外观->主题->Dream->更多->在线更新` 方法进行更新。 - -> 在线安装 & 更新的方式不推荐: -> -> 1. 因为由于 `GitHub` 的网络问题,很大几率会安装& 更新失败; -> 2. 主题是经过源码编译的,直接从仓库下载包含了主题的源码以及开发所需的相关文件,这些文件并不是安装主题所需要的。 - - - -### 4.3 安装配置邮件模板 - -配置邮件模板需要登录服务器添加模板文件,并重启 `Halo`。 - -1. 登录服务器,按步骤执行如下命令: -```bash -# 创建邮件模板目录 -mkdir -r ~/.halo/templates/common/mail_template/ -cd ~/.halo/templates/common/mail_template/ - -# 创建mail_notice.ftl文件 -vi mail_notice.ftl -## 文件内容如下(只需这一行即可): -<#include "../../themes/dream/mail_template/mail_notice.ftl"> - -# 创建mail_reply.ftl文件 -vi mail_reply.ftl -## 文件内容如下(只需这一行即可): -<#include "../../themes/dream/mail_template/mail_reply.ftl" -``` - -2. 重启 `Halo` - ## 五、参与主题开发 > 推荐使用 IDEA 进行主题开发,能够比较好的支持 FreeMarker。 @@ -105,10 +62,15 @@ vi mail_reply.ftl - 主题目录下执行 `npm i` 安装依赖; 2. npm 命令 + + - `npm run lint` 执行代码风格校验。 + - `npm run zip` 执行安装包打包,在无须重新编译 `js/css` 时使用。 + - `npm run build` 执行主题打包操作,主题将被打包为压缩包文件存放在 `dist/` 目录下,同时 `source` 目录下的文件也将被更新。 - `npm run build --devel` 开发模式进行主题打包,`js` 和 `css` 不会被做压缩和混淆处理,方便排查问题。 - - `npm run cdn --tag=$version` 创建 `FreeCDN` 清单文件,必须指定 `tag` 参数,值为本地代码将发布到 `GitHub` 仓库的版本标签。 - `npm run release --tag=$version` 发布模式执行主题打包操作,将自动更新主题中的版本号,并使用这个版本标签重新创建 `FreeCDN` 清单文件。 + + ## 六、打赏项目 diff --git a/templates/category.html b/templates/category.html index 2f0c0f5..5b5194c 100644 --- a/templates/category.html +++ b/templates/category.html @@ -1,20 +1,21 @@ -<#include "templates/layout_pjax.ftl"> -<@layout title="分类:${category.name!} - ${blog_title!}" canonical="${category.fullPath!}"> - <#if (posts.content)?? && posts.content?size gt 0> + + + +
+ + 该分类下没有文章,回主页看看吧 +
+
- <#include "templates/main/article_list.ftl"> - <@article_list posts.content/> - <#include "templates/main/pagination.ftl"> - <@pagination method="categoryPosts" datas=posts slug="${category.slug!}" display="${settings.page_number!5}" /> - <#else> -
- - 该分类下没有文章,回主页看看吧 -
- - + + + + + diff --git a/templates/common/config.html b/templates/common/config.html index e3b6145..848762e 100644 --- a/templates/common/config.html +++ b/templates/common/config.html @@ -1,4 +1,4 @@ - +