hexo-theme-volantis 5.7.6 → 5.7.7

package/CHANGELOG.md

@@ -1,5 +1,19 @@
 # Changelog
 
+## [5.7.7](https://github.com/volantis-x/hexo-theme-volantis/compare/v5.7.6...5.7.7) (2022-11-24)
+
+
+### Bug Fixes
+
+* **#824:** 边界条件 ([13f4e0e](https://github.com/volantis-x/hexo-theme-volantis/commit/13f4e0e6be464519a1ea3e020b5da1b1396c1254))
+* yml string to list ([11ab545](https://github.com/volantis-x/hexo-theme-volantis/commit/11ab545b52967e639938be00f78cc6bdefa885d4))
+
+
+### Performance Improvements
+
+* **debug:** description 的配置检查改为warn警告并使用默认值 [#801](https://github.com/volantis-x/hexo-theme-volantis/issues/801) ([f82f547](https://github.com/volantis-x/hexo-theme-volantis/commit/f82f54718b081439ea40e5a105ba81be15c60de0))
+* **readmore:** readmore:false 优先级高于 auto_excerpt:true ([302bf4e](https://github.com/volantis-x/hexo-theme-volantis/commit/302bf4e101689c0df9e0b8cbb1778dd18a8d5567))
+
 ## [5.7.6](https://github.com/volantis-x/hexo-theme-volantis/compare/v5.7.5...v5.7.6) (2022-09-05)
 
 

package/layout/_partial/_cover/dock.ejs

@@ -14,7 +14,7 @@
     <div class='menu navigation'>
       <div class='list-h'>
         <% if (theme.cover.features) { %>
-          <% (theme.cover.features || []).forEach(function(value){ %>
+          <% getList(theme.cover.features).forEach(function(value){ %>
             <a href="<%= url_for(value.url) %>"
               <% if (value.rel) { %>
                 rel="<%- value.rel %>"

package/layout/_partial/_cover/featured.ejs

@@ -14,7 +14,7 @@
     <div class='menu navigation'>
       <div class='list-h'>
         <% if (theme.cover.features) { %>
-          <% (theme.cover.features || []).forEach(function(value){ %>
+          <% getList(theme.cover.features).forEach(function(value){ %>
             <a href="<%= url_for(value.url) %>"
               <% if (value.rel) { %>
                 rel="<%- value.rel %>"

package/layout/_partial/_cover/focus.ejs

@@ -14,7 +14,7 @@
     <div class='menu navigation'>
       <div class='list-h'>
         <% if (theme.cover.features) { %>
-          <% (theme.cover.features || []).forEach(function(value){ %>
+          <% getList(theme.cover.features).forEach(function(value){ %>
             <a href="<%= url_for(value.url) %>"
               <% if (value.rel) { %>
                 rel="<%- value.rel %>"

package/layout/_partial/_cover/search.ejs

@@ -22,7 +22,7 @@
     <div class='menu navigation'>
       <div class='list-h'>
         <% if (theme.cover.features) { %>
-          <% (theme.cover.features || []).forEach(function(value){ %>
+          <% getList(theme.cover.features).forEach(function(value){ %>
             <a href="<%= url_for(value.url) %>"
               <% if (value.rel) { %>
                 rel="<%- value.rel %>"

package/layout/_partial/article.ejs

@@ -33,7 +33,7 @@
           </section>
           <section class='body'>
             <ul>
-              <% (page.references||[]).forEach(function(row){ %>
+              <% getList(page.references).forEach(function(row){ %>
                 <li>
                   <a href="<%- url_for(row.url) %>" rel="external nofollow noopener noreferrer" target="_blank">
                   <%- row.title || url_for(row.url) %>
@@ -104,7 +104,7 @@
         <% } else { %>
           <div class='copyright'>
             <blockquote>
-              <% (footer_widget.copyright.content||[]).forEach(function(row){ %>
+              <% getList(footer_widget.copyright.content).forEach(function(row){ %>
                 <% if (row == 'permalink') { %>
                   <p><%- footer_widget.copyright.permalink %><a href="<%- decodeURI(page.permalink) %>"><%- decodeURI(page.permalink) %></a></p>
                 <% } else { %>
@@ -119,7 +119,7 @@
       <% if (['post'].includes(page.layout) && footer_widget.donate && footer_widget.donate.enable == true) { %>
         <div class='donate'>
           <div class='imgs'>
-            <% (footer_widget.donate.images||[]).forEach(function(url){ %>
+            <% getList(footer_widget.donate.images).forEach(function(url){ %>
               <img src='<%- url_for(url) %>'>
             <% }) %>
           </div>

package/layout/_partial/footer.ejs

@@ -20,7 +20,7 @@
       <% if (item == 'social') { %>
         <br>
         <div class="social-wrapper" itemprop="about" itemscope itemtype="http://schema.org/Thing">
-          <% (theme.site_footer.social||[]).forEach(function(value){ %>
+          <% getList(theme.site_footer.social).forEach(function(value){ %>
             <% if (value.url && (value.icon || value.img || value.avatar)) { %>
               <a href="<%= url_for(value.url) %>"
                 class="social <%- value.icon %> flat-btn"

package/layout/_partial/head.ejs

@@ -8,7 +8,7 @@
   <!-- 渲染优化 -->
   <%_ if (theme.dns_prefetch && theme.dns_prefetch.length){ _%>
     <meta http-equiv='x-dns-prefetch-control' content='on' />
-    <%_ ([...theme.dns_prefetch]).forEach(function(item){ _%>
+    <%_ getList(theme.dns_prefetch).forEach(function(item){ _%>
       <link rel='dns-prefetch' href='<%- item %>'>
       <link rel="preconnect" href="<%- item %>" crossorigin>
     <%_ }) _%>
@@ -26,7 +26,7 @@
   <meta content="telephone=no" name="format-detection">
   <!-- import head_begin begin -->
   <%_ if (config.import && config.import.head_begin){ _%>
-    <%_ ([...config.import.head_begin]).forEach(function(item){ _%>
+    <%_ getList(config.import.head_begin).forEach(function(item){ _%>
       <%- item %>
     <%_ }) _%>
   <%_ } _%>
@@ -41,13 +41,9 @@
   <%- generate_preload_fontfamily(theme) %>
   <!-- feed -->
   <%_ if (config.feed && config.feed.path){ _%>
-    <%_ if (typeof(config.feed.path)=="string"){ _%>
-      <%- feed_tag(config.feed.path, {title: config.title}) %>
-    <%_ }else{ _%>
-      <%_ ([...config.feed.path]).forEach(function(item){ _%>
-        <%- feed_tag(item, {title: config.title}) %>
-      <%_ }) _%>
-    <%_ } _%>
+    <%_ getList(config.feed.path).forEach(function(item){ _%>
+      <%- feed_tag(item, {title: config.title}) %>
+    <%_ }) _%>
   <%_ } _%>
   <!-- 页面元数据 -->
   <%- generate_title(config, theme, page) %>
@@ -72,7 +68,7 @@
   <%- partial('scripts/global') %>
   <!-- import head_end begin -->
   <%_ if (config.import && config.import.head_end){ _%>
-    <%_ ([...config.import.head_end]).forEach(function(item){ _%>
+    <%_ getList(config.import.head_end).forEach(function(item){ _%>
       <%- item %>
     <%_ }) _%>
   <%_ } _%>

package/layout/_partial/header.ejs

@@ -77,7 +77,7 @@
                 </a>
                 <% if (value.rows) { %>
                   <ul class="list-v">
-                    <% value.rows.forEach(function(value){ %>
+                    <% getList(value.rows).forEach(function(value){ %>
                       <% menu(value, type) %>
                     <%})%>
                   </ul>
@@ -85,7 +85,7 @@
               </li>
             <% } %>
           <% } %>
-          <% menu_list.forEach(function(value){ %>
+          <% getList(menu_list).forEach(function(value){ %>
             <% menu(value, 'pc') %>
           <% }) %>
 				</ul>
@@ -106,7 +106,7 @@
 				<li>
           <a class="s-menu fa-solid fa-bars fa-fw" target="_self" href="/" onclick="return false;" title="menu"></a>
           <ul class="menu-phone list-v navigation white-box">
-            <% menu_list.forEach(function(value){ %>
+            <% getList(menu_list).forEach(function(value){ %>
               <% menu(value, 'mobile') %>
             <% }) %>
           </ul>

package/layout/_partial/meta.ejs

@@ -35,7 +35,7 @@ if (post.bottom_meta == false) {
         <%- post.title %>
       </h1>
       <div class='new-meta-box'>
-        <% (topMetas).forEach(function(meta) { %>
+        <% getList(topMetas).forEach(function(meta) { %>
           <% if (meta in theme.article.body.meta_library){ %>
             <%- partial('../_meta/' + meta, {post: post}) %>
           <% } %>
@@ -53,7 +53,7 @@ if (post.bottom_meta == false) {
 <% } else if (position == 'bottom') { %>
   <div class='article-meta' id="bottom">
     <div class='new-meta-box'>
-      <% (bottomMetas).forEach(function(meta){ %>
+      <% getList(bottomMetas).forEach(function(meta){ %>
         <% if (meta in theme.article.body.meta_library) { %>
           <%- partial('../_meta/' + meta, {post: post}) %>
         <% } %>

package/layout/_partial/post.ejs

@@ -21,7 +21,7 @@
     showCat = true;
   }
   let showReadmore = false;
-  if (theme.article.preview.readmore == 'always' || theme.article.preview.auto_excerpt || ((post.readmore != false) && (post.excerpt || post.description || post.link))) {
+  if (theme.article.preview.readmore == 'always' || ((post.readmore != false) && (theme.article.preview.auto_excerpt || post.excerpt || post.description || post.link))) {
     showReadmore = true;
   }
   %>

package/layout/_partial/scripts/global.ejs

@@ -363,8 +363,11 @@
     volantis.requestAnimationFrame(loop)
   }
   volantis.scroll.handleScrollEvents()
+  volantis.scroll.ele = null;
   // 触发页面滚动至目标元素位置
-  volantis.scroll.to = (ele, option = {}) =>{
+  volantis.scroll.to = (ele, option = {}) => {
+    if (!ele) return;
+    volantis.scroll.ele = ele;
     // 默认配置
     opt = {
       top: ele.getBoundingClientRect().top + document.documentElement.scrollTop,
@@ -390,8 +393,11 @@
     // 用于处理 lazyload 引起的 cls 导致的定位失败问题
     // option.observer = false
     if (option.observer) {
-      setTimeout(()=>{
-        volantis.scroll.unengine.push(()=>{
+      setTimeout(() => {
+        if (volantis.scroll.ele != ele) {
+          return
+        }
+        volantis.scroll.unengine.push(() => {
           let me = ele.getBoundingClientRect().top
           if(!(me >= -option.observerDic && me <= option.observerDic)){
             volantis.scroll.to(ele, option)

package/layout/_plugins/_page_plugins/index.ejs

@@ -1,5 +1,5 @@
 <%_
-(page.plugins||[]).forEach(function(item){
+getList(page.plugins).forEach(function(item){
   try {
       if (typeof item == "string") { _%>
         <%- partial( item + "/index") %>
@@ -13,12 +13,12 @@
     没有找到页面插件：${item}
     请检查是否存在该插件，或者检查插件名称是否正确：${item}
     出问题的页面：${page.path}
-    see: https://volantis.js.org/v5/page-settings/#页面插件-page-plugins
+    see: https://volantis.js.org/v6/page-settings/#页面插件-page-plugins
 ================================================================================
     There is no page plugin: ${item}
     Please check if the plugin exists, or check the plugin name is correct: ${item}
     The page that has problem: ${page.path}
-    see: https://volantis.js.org/v5/page-settings/#页面插件-page-plugins
+    see: https://volantis.js.org/v6/page-settings/#页面插件-page-plugins
 =================================================================================`);
   }
 

package/layout/_plugins/aplayer/script.ejs

@@ -26,7 +26,7 @@
               const aplayerItem = item.aplayer; if(!aplayerItem) return;
               const rightAplayerCheck = '<%= theme.rightmenu.layout.includes("music") %>' === 'true'
                 && item.meta.id === '<%= theme.plugins.aplayer.id %>';
-              if(rightAplayerCheck) RightMenuAplayer.checkAPlayer();
+              if(rightAplayerCheck && typeof RightMenuAplayer !="undefined") RightMenuAplayer.checkAPlayer();
               if(aplayerItem.events.events.play.every(item => {return item.name !== 'messagePlay'})) {
                 aplayerItem.on('play', function messagePlay() {
                   let index = aplayerItem.list.index;

package/layout/_plugins/comments/discuss/script.ejs

@@ -1,5 +1,5 @@
 <script>
-  volantis.layoutHelper("comments",`<div id="discuss_container"><i class="fa-solid fa-cog fa-spin fa-fw fa-2x"></i></div>`)
+  volantis.layoutHelper("comments",`<div id="discuss_container"></div>`)
   function load_discuss() {
     if(!document.querySelectorAll("#discuss_container")[0])return;
     volantis.js("<%- theme.comments.discuss.js %>", pjax_discuss)

package/layout/_plugins/highlight/prismjs/script.ejs

@@ -1,7 +1,7 @@
-<% (theme.plugins.prismjs.js||[]).forEach(function(item) { %>
+<% getList(theme.plugins.prismjs.js).forEach(function(item) { %>
   <%- js(item) %>
 <% }) %>
-<% (theme.plugins.prismjs.css||[]).forEach(function(item) { %>
+<% getList(theme.plugins.prismjs.css).forEach(function(item) { %>
   <%- css(item) %>
 <% }) %>
 <script>

package/layout/_plugins/share/layout.ejs

@@ -1,6 +1,6 @@
 <div class="new-meta-item share -mob-share-list">
   <div class="-mob-share-list share-body">
-    <% (theme.article.body.meta_library.share||[]).forEach(function(item){ %>
+    <% getList(theme.article.body.meta_library.share).forEach(function(item){ %>
       <% if (item.id == 'qrcode'){ %>
         <% var src = qrcode(url,{margin:1,size:8}); %>
         <div class='hoverbox'>

package/layout/_widget/_pre.ejs

@@ -1,7 +1,7 @@
 <%
 var pf = [];
 if (item.display) {
-  item.display.forEach(function(p){
+  getList(item.display).forEach(function(p){
     pf.push(p);
   });
 } else {

package/layout/_widget/blogger.ejs

@@ -28,7 +28,7 @@
     <% } %>
     <% if (item.social && item.social.length > 0) { %>
       <div class="social-wrapper">
-        <% (item.social||[]).forEach(function(value){ %>
+        <% getList(item.social).forEach(function(value){ %>
           <% if (value.url && (value.icon || value.img || value.avatar)) { %>
             <a href="<%= url_for(value.url) %>"
               class="social <%- value.icon %> flat-btn"

package/layout/_widget/copyright.ejs

@@ -3,7 +3,7 @@
   <div class='content'>
     <% if (item.blockquote == true) { %>
       <blockquote>
-        <% (item.content||[]).forEach(function(row){ %>
+        <% getList(item.content).forEach(function(row){ %>
           <% if (row == 'permalink') { %>
             <p><%- item.permalink %><a href=<%- page.permalink %>><%- page.permalink %></a></p>
           <% } else { %>
@@ -12,7 +12,7 @@
         <% }) %>
       </blockquote>
     <% } else { %>
-      <% (item.content||[]).forEach(function(row){ %>
+      <% getList(item.content).forEach(function(row){ %>
         <% if (row == 'permalink') { %>
           <p><%- item.permalink %><a href=<%- page.permalink %>><%- page.permalink %></a></p>
         <% } else { %>

package/layout/_widget/grid.ejs

@@ -3,7 +3,7 @@
   <%- partial('header', {item: item}) %>
   <div class='content'>
     <div class="grid navigation<%- item.fixed ? ' fixed' : '' %>">
-      <% (item.rows||[]).forEach(function(row){ %>
+      <% getList(item.rows).forEach(function(row){ %>
         <a class="flat-box" href="<%- url_for(row.url) %>"
           <% if (row.rel) { %>
             rel="<%- row.rel %>"

package/layout/_widget/list.ejs

@@ -3,7 +3,7 @@
   <%- partial('header', {item: item}) %>
   <div class='content'>
     <ul class="list entry navigation">
-      <% (item.rows||[]).forEach(function(row){ %>
+      <% getList(item.rows).forEach(function(row){ %>
         <li><a class="flat-box" title="<%- url_for(row.url) %>" href="<%- url_for(row.url) %>"
           <% if (row.rel) { %>
             rel="<%- row.rel %>"

package/layout/_widget/load.ejs

@@ -1,7 +1,7 @@
 <%
   let widget_library_temp = [];
 %>
-<% (widgets||[]).forEach(function(widget){ %>
+<% getList(widgets).forEach(function(widget){ %>
   <% if (theme.sidebar.widget_library && (widget in theme.sidebar.widget_library)){ %>
     <% let w = theme.sidebar.widget_library[widget]; w.id = widget; %>
     <% if(w.sticky) { %>
@@ -22,7 +22,7 @@
 
 <%
 let widget_pjax_length = 0;
-page.sidebar.forEach(function(e){
+getList(page.sidebar).forEach(function(e){
   if (e&&theme.sidebar.widget_library&&theme.sidebar.widget_library[e]) {
     let widget_pjax_flag = theme.sidebar.widget_library[e].pjaxReload
     let widget_stickys = theme.sidebar.widget_library[e].sticky

package/layout/_widget/qrcode.ejs

@@ -2,7 +2,7 @@
 <section class="widget <%- item.class %> <%- page.widget_platform %> <%- page.widget_pjax %>">
   <%- partial('header', {item: item}) %>
   <div class='content article-entry'>
-    <% (item.images||[]).forEach(function(url){ %>
+    <% getList(item.images).forEach(function(url){ %>
       <img src='<%- url_for(url) %>'
       <% if (item.height) { %>
         height='<%- item.height %>'

package/layout/_widget/references.ejs

@@ -4,7 +4,7 @@ if (item.rows == undefined) {
   var itms = new Array();
   let id = item.id || 'references';
   if (id in page) {
-    (page[id]||[]).forEach(function(ref) {
+    getList(page[id]).forEach(function(ref) {
       if (ref.name || ref.url) {
         item.rows.push(ref);
       }

package/layout/_widget/text.ejs

@@ -2,7 +2,7 @@
 <section class="widget <%- item.class %> <%- page.widget_platform %> <%- page.widget_pjax %>">
   <%- partial('header', {item: item}) %>
   <div class='content'>
-    <% (item.content||[]).forEach(function(row){ %>
+    <% getList(item.content).forEach(function(row){ %>
       <%- markdown(row) %>
     <% }) %>
   </div>

package/layout/archive.ejs

@@ -26,7 +26,7 @@
 									<% if (post.icon) { %>
 										&nbsp;<i class="<%- post.icon %>" aria-hidden="true"></i>
 									<% } %>
-									<% (post.icons && post.icons||[]).forEach(function(icon){ %>
+									<% getList(post.icons).forEach(function(icon){ %>
 										&nbsp;<i class="<%- icon %>" aria-hidden="true"></i>
 									<% }) %>
 								</a>

package/layout/friends.ejs

@@ -4,7 +4,7 @@
     <%- partial('_partial/meta',{post: page, position: 'top'}) %>
     <%- page.excerpt %>
     <% if (site.data.friends){ %>
-      <% site.data.friends.forEach((group, i) => { %>
+      <% getList(site.data.friends).forEach((group, i) => { %>
         <div class='friends-group'>
           <br>
           <h2 class='friend-header'>
@@ -15,7 +15,7 @@
           <%} %>
           <% if (theme.pages.friends.layout_scheme == 'traditional') { %>
             <div class='friend-content'>
-              <% (group.items||[]).forEach(function(item){ %>
+              <% getList(group.items).forEach(function(item){ %>
                 <% if (item.url && item.title) { %>
                   <a class='friend-card'
                     target="_blank" rel="external noopener noreferrer" href="<%- url_for(item.url || '/') %>">
@@ -28,7 +28,7 @@
                       <p class="friend-name"><%- item.title %></p>
                       <% if (item.keywords) { %>
                         <div class='friend-tags-wrapper'>
-                        <% (item.keywords||[]).forEach(function(keyword){ %>
+                        <% getList(item.keywords).forEach(function(keyword){ %>
                           <p class="tags"><i class="fa-solid fa-hashtag fa-fw" aria-hidden="true"></i><%= keyword %></p>
                         <% }) %>
                         </div>
@@ -45,7 +45,7 @@
             </div>
           <% } else { %>
             <div class='simpleuser-group'>
-              <% (group.items||[]).forEach(function(item){ %>
+              <% getList(group.items).forEach(function(item){ %>
                 <% if (item.url && item.title) { %>
                   <a class="simpleuser" target="_blank" rel="external noopener noreferrer" href="<%- url_for(item.url || '/') %>">
                     <img src="<%- item.avatar || (theme.plugins.lazyload && theme.plugins.lazyload.loadingImg) %>"/>

package/layout/layout.ejs

@@ -5,7 +5,7 @@
   <body itemscope itemtype="http://schema.org/WebPage">
     <!-- import body_begin begin-->
     <%_ if (config.import && config.import.body_begin){ _%>
-      <%_ ([...config.import.body_begin]).forEach(function(item){ _%>
+      <%_ getList(config.import.body_begin).forEach(function(item){ _%>
         <%- item %>
       <%_ }) _%>
     <%_ } _%>
@@ -33,7 +33,7 @@
     </div>
     <!-- import body_end begin-->
     <%_ if (config.import && config.import.body_end){ _%>
-      <%_ ([...config.import.body_end]).forEach(function(item){ _%>
+      <%_ getList(config.import.body_end).forEach(function(item){ _%>
         <%- item %>
       <%_ }) _%>
     <%_ } _%>

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "hexo-theme-volantis",
-  "version": "5.7.6",
+  "version": "5.7.7",
   "description": "Elegant and powerful theme for Hexo.",
   "main": "package.json",
   "scripts": {

package/scripts/events/lib/check-configuration.js

@@ -3,17 +3,19 @@ module.exports =(hexo) => {
     let config = hexo.config;
     let themeConfig = hexo.theme.config;
     if (!config.title) {
-      return `title 未配置！
+      config.title = `Volantis`
+      hexo.log.warn(`title 未配置！
 请在站点配置 _config.yml 中配置 title
 see: https://hexo.io/zh-cn/docs/configuration
-title is not configured!`
+title is not configured!`)
     }
     if (!config.description) {
-      return `description 未配置！
+      config.description = `Volantis 是一个功能丰富、高度模块化的 Hexo 博客主题。得益于其强大的模块化特性，您可以轻松搭建一个极简风格的博客，也可以仿照官网搭建一个多人协作的、包含文档模块的大体量综合型博客。`
+      hexo.log.warn(`description 未配置！
 请在站点配置 _config.yml 中配置 description
 description主要用于SEO，告诉搜索引擎一个关于您站点的简单描述，通常建议在其中包含您网站的关键词。
 see: https://hexo.io/zh-cn/docs/configuration
-description is not configured!`
+description is not configured!`);
     }
     if (themeConfig?.search?.service===`google`||themeConfig?.search?.service===`algolia`||themeConfig?.search?.service===`azure`||themeConfig?.search?.service===`baidu`) {
       return `原 google, algolia, azure, baidu 站内搜索 系祖传代码, 且文档丢失, 不便后续维护 在 5.0 版本被移除

package/scripts/helpers/getList.js

@@ -0,0 +1,11 @@
+// yml string to list
+// yml 太烂了
+
+hexo.extend.helper.register('getList', function (list) {
+  if (!list) return []
+  if (typeof list == "string") {
+    return [list]
+  } else {
+    return [...list]
+  }
+});