🐛 修复 1.0.1 中的缺陷

README.md

@@ -23,7 +23,7 @@
   </a>
 </p>
 
-> `Joe2.0` 为 [Typecho Themes Joe](https://github.com/HaoOuBa/Joe) 主题的 Halo 版，由于 [社区](https://bbs.halo.run/) 之前有兄弟移植过，这次就叫 Joe2.0 吧，此次在原版主题上做了不少修改和适配，由原版的 php 模板调整为 freemarker， 移除了平台无关的特性，同时增加了一些平台特定的配置，保持灵活性的同时最大限度的移植了原版功能，希望大家喜欢 ❤️ <br>
+> `Joe2.0` 是 [Typecho Themes Joe](https://github.com/HaoOuBa/Joe) 主题的 Halo 版，由于 [社区](https://bbs.halo.run/) 之前有兄弟移植过，这次就叫 Joe2.0 吧，此次在原版主题上做了不少修改和适配，由原版的 php 模板调整为 freemarker， 移除了平台无关的特性，同时增加了一些平台特定的配置，保持灵活性的同时最大限度的移植了原版功能，希望大家喜欢 ❤️ <br>
 > 🌸 同时也要在此感谢原作者 [Joe](https://github.com/HaoOuBa)。
 
 <br>
@@ -52,7 +52,9 @@
 
 ### ⚠️ 注意：
 
-- 安装主题后请务必到 `后台管理 - 博客设置 - 高级选项` 中开启 `API服务` 并配置 `Access key` 为 `joe2.0`，不然部分用到 `Content API` 的页面会请求失败，导致报错。
+- 安装主题后请务必到 `后台管理 - 博客设置 - 高级选项` 中开启 `API服务` 并配置 `Access key` 为 `joe2.0`（注意：这里没必要一定是 joe2.0，可以配置为任意值），不然部分用到 `Content API` 的页面会请求失败，导致报错。
+
+  Tip：如果你后台管理中之前已经配置了其它的 `Access Key`（内容不是 `joe2.0`），那么需要你到本主题设置中的 `基本设置` 配置一下 `AccessKey<必填>`，和你后台中的一致即可（切记一致才行，且不要填写中文或特殊字符）。
 
 - 主题升级后配置项变化较大时可能报错，导致页面渲染不出来。只需要进入当前主题的设置界面执行一下保存操作来更新旧的配置，然后再访问页面即可，有时可能需要先切换到其它主题后再切回来才能看到最新的效果。
 
@@ -257,21 +259,37 @@ Halo 已经提供好了邮件服务，我们只需要配置相关参数即可。
 
 #### 5、如何配置留言页？
 
-目前模板中的留言页面是自定义页面，所以需要你进入 `后台管理-页面` ，点击 `新建页面` 添加留言页，然后把模板目录中的 `leaving.ftl` 的内容复制进去保存，最后进入 `外观-菜单` 添加刚才自定义的留言页，保存后刷新前台页面即可。
+目前主题中的留言页面是自定义页面，所以需要你进入 `后台管理-页面` ，点击 `新建页面` 添加留言页，然后把模板目录中的 `leaving.ftl` 的内容复制进去保存，最后进入 `外观-菜单` 添加刚才自定义的留言页，保存后刷新前台页面即可。
+
+#### 6、自己修改了主题中的 CSS 或 JS 后为什么还是用的以前的？
+
+目前主题默认使用 `CDN` 加载静态资源，要使用自己修改后的版本，需要到 `后台管理-外观-主题设置-其它` 中关闭 `使用CDN加载静态资源` 即可生效。但关闭后同时也失去了 `CDN` 加载的优势，如果你不想关闭，就需要自己单独修改文件引入处的链接。
+
+比如我修改了 `joe.index.min.css` 这个文件，那么就需要到 `template/module/link.ftl` 中找到引入它的地方：
+
+```html
+<link
+  rel="preload stylesheet"
+  as="style"
+  href="${RES_BASE_URL}/source/css/min/joe.index.min.css?v=${theme.version!}"
+/>
+```
+
+把其中的 `${RES_BASE_URL}` 修改为主题自身路径 `${theme_base!}` 即可。
 
-#### 6、如何通过元数据为文章详情页进行单独的功能配置？
+#### 7、如何通过元数据为文章详情页进行单独的功能配置？
 
 - 很多时候，我们希望能够单独控制文章详情页的功能，如分享、打赏、复制、点赞、评论、目录等。主题目前已经为文章详情页暴露了常用的元数据配置，具体大家可以查看 `theme.yaml` 文件中的 `postMetaField` 字段。
 
 - 如果我们想通过这些元数据来单独控制页面功能，可以到 `后台管理-文章-所有文章` 中找到要修改的文章，然后点击设置，再点击底部保存按钮旁的 `高级`，即可在弹框中对元数据进行配置，字段格式和主题配置是一致的，布尔值填 true 或 false，都是字符串形式。
 
 ![文章详情页元数据配置](https://cdn.jsdelivr.net/gh/qinhua/halo-theme-joe2.0@master/source/img/dp/metas.png)
 
-#### 7、如何查看博客后台日志？
+#### 8、如何查看博客后台日志？
 
 有时博客访问不了，想查看后台日志，可以进入 `后台管理-系统-小工具-实时日志` 查看，生成环境可能需要先开启彩蛋（连续点击 `Halo Dashboard` 10 次触发），更多请参见 [Halo 隐藏功能](https://halo.run/archives/use-hidden-features)。
 
-#### 8、Freemarker 相关小技巧
+#### 9、Freemarker 相关小技巧
 
 主要是本人在开发主题过程中积累的一些 `Freemarker` 技能，希望能帮到需要的人。请参见 [FreeMarker 常用技巧](https://www.yuque.com/docs/share/f8a15e0c-3bf2-4c93-b2ef-e3bf2357d09c)
 

journals.ftl

@@ -29,7 +29,7 @@
                 </div>
               </div>
             </div>
-            <ul class="joe_journals__list">
+            <ul class="joe_journals__list${settings.enable_journal_effect?then(' effects','')}">
               <#list journals.content as journal>
                 <li class="joe_journal__item animated wow" data-wow-delay="0.2s" data-cid="${journal.id}" data-clikes="${journal.likes}">
                   <p class="joe_journal_date"><i class="joe-font joe-icon-feather"></i>

mail_template/mail_notice.ftl

@@ -9,11 +9,11 @@
       <div class="email-text" style="padding:20px 28px 10px;background:#fff;">
         <p style="margin:0 0 5px;padding:0;line-height:24px;font-size:13px;color:#6e6e6e;"><span style="font-weight:bold;color:#fa7e5b;">${user.nickname!'博主'}，</span> 您好!</p>
         <p style="margin:0;padding:0;line-height:24px;font-size:13px;color:#6e6e6e;">访客<span style="color:#fa7e5b;"> ${author!'xxx'} </span>在<a href="${pageFullPath!'xxx'}" target="_blank" style="color:#fa7e5b;text-decoration:none;">《${pageTitle!'xxx'}》</a>评论说：
-        <p style="margin:12px 0;padding:18px 20px;color:#6e6e6e;font-size:13px;background:#f8f8f8;background:repeating-linear-gradient(145deg, #f2f6fc, #f2f6fc 15px, #fff 0, #fff 25px);">${content!}</p>
+        <pre style="margin:12px 0;padding:18px 20px;word-break:break-word;color:#6e6e6e;font-size:13px;background:#f8f8f8;background:repeating-linear-gradient(145deg, #f2f6fc, #f2f6fc 15px, #fff 0, #fff 25px);">${content!}</pre>
         <p style="margin:0 0 16px;padding:0;line-height:24px;font-size:13px;color:#6e6e6e;">
           <a href="${pageFullPath!}" target="_blank" style="color:#5caaef;text-decoration:none;">点击查看完整内容</a>
         </p>
-      </div>
+      </pre>
       <div class="email-footer" style="padding:10px 20px;border-top:1px solid #eee;">
         <p style="margin:0;padding:0;line-height:24px;font-size:13px;color:#999;">* 注意：此邮件由 <a href="${blog_url!}" target="_blank" style="color:#fa7e5b;text-decoration:none;">${blog_title!'xxx'}</a> 自动发出，请勿回复。</p>
       </div>

mail_template/mail_reply.ftl

@@ -9,9 +9,9 @@
       <div class="email-text" style="padding:20px 28px 10px;background:#fff;">
         <p style="margin:5px 0 5px;padding:0;line-height:24px;font-size:13px;color:#6e6e6e;"><span style="font-weight:bold;color:#9f98ff">${baseAuthor!'Dear'}，</span> 您好!</p>
         <p style="margin:0;padding:0;line-height:24px;font-size:13px;color:#6e6e6e;">您在<a href="${pageFullPath!}" target="_blank" style="color:#9f98ff;text-decoration:none;"> ${blog_title!} -《${pageTitle!'xxx'}》</a>的留言：
-        <p style="margin:12px 0;padding:18px 20px;color:#6e6e6e;font-size:13px;background:#f8f8f8;background:repeating-linear-gradient(145deg, #f2f6fc, #f2f6fc 15px, #fff 0, #fff 25px);">${baseContent!}</p>
+        <pre style="margin:12px 0;padding:18px 20px;word-break:break-word;color:#6e6e6e;font-size:13px;background:#f8f8f8;background:repeating-linear-gradient(145deg, #f2f6fc, #f2f6fc 15px, #fff 0, #fff 25px);">${baseContent!}</pre>
         <p style="padding:0;line-height:24px;font-size:13px;color:#6e6e6e;"><span style="color:#9f98ff;">${replyAuthor!'xxx'}</span> 给您的回复：
-        <p style="margin:12px 0;padding:18px 20px;color:#6e6e6e;font-size:13px;background:#f8f8f8;background:repeating-linear-gradient(145deg, #f2f6fc, #f2f6fc 15px, #fff 0, #fff 25px);">${replyContent!}</p>
+        <pre style="margin:12px 0;padding:18px 20px;word-break:break-word;color:#6e6e6e;font-size:13px;background:#f8f8f8;background:repeating-linear-gradient(145deg, #f2f6fc, #f2f6fc 15px, #fff 0, #fff 25px);">${replyContent!}</pre>
         <p style="margin:0 0 16px;padding:0;line-height:24px;font-size:13px;color:#6e6e6e;">
           <a href="${pageFullPath!}" target="_blank" style="color:#5c8fef;text-decoration:none;">点击查看完整内容</a>
         </p>

package.json

@@ -1,11 +1,11 @@
 {
   "name": "halo-theme-joe2.0",
-  "version": "1.0.1",
+  "version": "1.0.2",
   "description": "A halo theme joe2.0",
   "main": "index.js",
   "author": "BabyChin",
   "scripts": {
-    "build": "webpack",
+    "build": "webpack && node source/utils/update-version.js",
     "prepare": "husky install",
     "lint:staged": "lint-staged",
     "lint": "stylelint --custom-syntax postcss-less --fix source/css/*.less && eslint --fix source/js/*.js"
@@ -39,6 +39,7 @@
     "@babel/preset-env": "^7.15.6",
     "babel-eslint": "^10.1.0",
     "babel-loader": "^8.2.2",
+    "clean-webpack-plugin": "^4.0.0",
     "compression-webpack-plugin": "^9.0.0",
     "eslint": "^8.2.0",
     "husky": "^7.0.4",

post.ftl

@@ -10,7 +10,8 @@
       <div class="joe_container joe_main_container page-post">
         <div class="joe_main joe_post">
           <#if settings.enable_post_aside && settings.enable_aside_expander><span class="aside-expander">隐藏侧边栏</span></#if>
-          <div class="joe_detail" data-cid="${post.id}" data-clikes="${post.likes}" data-curl="${post.fullPath}">
+          <div class="joe_detail" data-status="${post.status!}" data-cid="${post.id}" data-clikes="${post.likes}" data-curl="${post.fullPath}">
+            <#include "template/module/post_status.ftl">
             <#list categories as category>
               <#if category_index==1>
                 <div class="joe_detail__category">
@@ -35,8 +36,8 @@
                     <span class="line">/</span>
                     <span class="text" >${post.visits} 阅读</span>  
                     <span class="line">/</span>
-                    <span class="text" >${post.wordCount!0} 字</span>
-                    <#if settings.check_baidu_collect!false>
+                    <span class="text">${post.wordCount!0} 字</span>
+                    <#if settings.check_baidu_collect==true && post.status=='PUBLISHED'>
                       <span class="line">/</span>
                       <span class="text" id="joe_baidu_record">正在检测是否收录...</span>
                     </#if>
@@ -64,7 +65,7 @@
               </#if>
             </div>
             <#assign enable_copy = metas.enable_copy!'true'>
-            <article class="joe_detail__article animated fadeIn${settings.enable_code_line_number?string(' line-numbers', '')}${(enable_copy== 'true' && settings.enable_copy==true)?then(' copyable', '')}${settings.enable_indent?string(' indent','')}">
+            <article class="joe_detail__article animated fadeIn${settings.enable_code_line_number?then(' line-numbers', '')}${(enable_copy=='true' && settings.enable_copy==true)?then(' copyable', '')}${settings.enable_indent?then(' indent','')}${settings.enable_single_code_select?then(' single_code_select','')}">
               ${post.formatContent!}
             </article>
             <#assign enable_toc = metas.enable_toc!'true'>
@@ -78,13 +79,13 @@
               </div>
             </#if>
             <#assign enable_like = metas.enable_like!'true'>
-            <#if enable_like=='true' && settings.enable_like==true>
+            <#if enable_like=='true' && settings.enable_like==true && post.status!='DRAFT'>
               <#include "template/module/favorite.ftl">
             </#if>
             <#include "template/module/post_operate.ftl">
             <#import "template/macro/post_copyright.ftl" as pc>
             <@pc.post_copyright post_url="${post.fullPath}"/>
-            <#if settings.enable_clean_mode!=true && settings.enable_post_ads == true>
+            <#if settings.enable_clean_mode!=true && settings.enable_post_ads == true && post.status!='DRAFT'>
               <#include "template/ads/ads_post.ftl">
             </#if>
           </div>
@@ -97,7 +98,7 @@
             </#if>
           </ul>
           <#assign enable_comment = metas.enable_comment!'true'>
-          <#if settings.enable_clean_mode!=true && settings.enable_comment==true>
+          <#if settings.enable_clean_mode!=true && settings.enable_comment==true && post.status!='DRAFT'>
             <div class="joe_comment">
               <#if post.disallowComment == true || enable_comment == 'false'>
                 <div class="joe_comment__close">
@@ -118,7 +119,7 @@
                 <svg class="joe_comment__close-icon" viewBox="0 0 1024 1024" xmlns="http://www.w3.org/2000/svg" width="18" height="18">
                   <path d="M512.307.973c282.317 0 511.181 201.267 511.181 449.587a402.842 402.842 0 0 1-39.27 173.26 232.448 232.448 0 0 0-52.634-45.977c16.384-39.782 25.293-82.688 25.293-127.283 0-211.098-199.117-382.157-444.621-382.157-245.555 0-444.57 171.06-444.57 382.157 0 133.427 79.514 250.88 200.039 319.18v107.982l102.041-65.127a510.157 510.157 0 0 0 142.49 20.122l19.405-.359c19.405-.716 38.758-2.508 57.958-5.427l3.584 13.415a230.607 230.607 0 0 0 22.323 50.688l-20.633 3.328a581.478 581.478 0 0 1-227.123-12.288L236.646 982.426c-19.66 15.001-35.635 7.168-35.635-17.664v-157.39C79.411 725.198 1.024 595.969 1.024 450.56 1.024 202.24 229.939.973 512.307.973zm318.464 617.011c97.485 0 176.794 80.435 176.794 179.2S928.256 976.23 830.77 976.23c-97.433 0-176.742-80.281-176.742-179.046 0-98.816 79.309-179.149 176.742-179.149zM727.757 719.002a131.174 131.174 0 0 0-25.754 78.182c0 71.885 57.805 130.406 128.768 130.406 28.877 0 55.552-9.625 77.056-26.01zm103.014-52.327c-19.712 0-39.117 4.557-56.678 13.312L946.33 854.58c8.499-17.305 13.158-36.864 13.158-57.395 0-71.987-57.805-130.509-128.717-130.509zM512.307 383.13l6.861.358a67.072 67.072 0 0 1 59.853 67.072l-.307 6.86a67.072 67.072 0 0 1-66.407 60.57l-6.81-.358a67.072 67.072 0 0 1-59.852-67.072 67.072 67.072 0 0 1 66.662-67.43zm266.752 0l6.861.358a67.072 67.072 0 0 1 59.853 67.072l-.307 6.86a67.072 67.072 0 0 1-66.407 60.57l-6.81-.358a67.072 67.072 0 0 1-59.852-67.072h-.051l.307-6.86a67.072 67.072 0 0 1 66.406-60.57zm-533.504 0l6.861.358a67.072 67.072 0 0 1 59.853 67.072l-.307 6.86a67.072 67.072 0 0 1-66.407 60.57l-6.81-.358a67.072 67.072 0 0 1-59.852-67.072 67.072 67.072 0 0 1 66.662-67.43z" />
                 </svg>
-                <span>博主关闭了所有页面的评论</span>
+                <span>${(post.status=='DRAFT')?then('预览状态下不可评论','博主关闭了所有页面的评论')}</span>
               </div>
             </div>
           </#if>