hexo-theme-stellar 1.40.0 → 1.42.0

package/layout/_partial/main/post_list/post_card.ejs

@@ -1,47 +1,16 @@
 <%
-const poster = post.poster;
 var obj = {
   image: post.cover
 };
-if (poster) {
-  obj.headline = poster.headline;
-  obj.topic = poster.topic;
-  obj.caption = poster.caption;
-  obj.color = poster.color;
-}
 function div_default() {
   var el = '';
   el += '<article class="md-text">';
 
-  // 封面
-  if (obj.image || theme.article.auto_cover) {
-    var cover_url;
-    if (obj.image != undefined) {
-      if (obj.image.includes('/')) {
-        cover_url = obj.image;
-      } else {
-        cover_url = 'https://source.unsplash.com/1280x640/?' + obj.image;
-      }
-    } else {
-      // 自动以 tags 作为关键词搜索封面
-      if (post.tags) {
-        var params = '';
-        post.tags.reverse().forEach((tag, i) => {
-          if (i > 0) {
-            params += ',';
-          }
-          params += tag.name;
-        });
-        cover_url = 'https://source.unsplash.com/1280x640/?' + params;
-      } else {
-        cover_url = 'https://source.unsplash.com/random/1280x640';
-      }
-    }
-    if (cover_url) {
-      el += '<div class="post-cover">';
-      el += '<img src="' + escape_html(cover_url) + '"/>';
-      el += '</div>';
-    }
+  // 封面：仅当显式 cover 为完整 URL 时渲染（Unsplash 自动封面接口已失效，不再生成）
+  if (obj.image && obj.image.includes('/')) {
+    el += '<div class="post-cover">';
+    el += '<img src="' + escape_html(obj.image) + '"/>';
+    el += '</div>';
   }
 
   // 标题
@@ -100,7 +69,7 @@ function div_default() {
       if (i >= 5) {
         return;
       }
-      el += `<span class="cap tag-chip">#${escape_html(tag.name)}</span>`;
+      el += `<span class="cap tag-chip">${icon('default:hashtag')}${escape_html(tag.name)}</span>`;
     });
     el += '</span>';
   }
@@ -110,39 +79,22 @@ function div_default() {
 }
 function div_photo() {
   var el = '';
-  var position = '';
-  if (obj.headline || obj.topic || obj.caption) {
-    if (obj.topic) {
-      position = 'top';
-    } else {
-      position = 'bottom';
-    }
-  }
-  el += '<div class="cover" position="' + position + '" style="--cover-url:url(\'' + escape_html(obj.image.replace(/'/g, '%27')) + '\')">';
+  // 小字取值统一由 subtitle() helper 提供：subtitle > description > excerpt 前 50 字
+  var caption = subtitle(post);
+  // hero 卡片文字区固定 bottom：标题 + 一行小字，不再有 top 布局
+  el += '<div class="cover" position="bottom" style="--cover-url:url(\'' + escape_html(obj.image.replace(/'/g, '%27')) + '\')">';
   el += '<img src="' + escape_html(obj.image) + '"/>';
-  if (position.length > 0) {
-    el += '<div class="cover-info" position="' + position + '"';
-    if (obj.color) {
-      el += 'style="color:' + escape_html(obj.color) + '"';
-    }
-    el += '>';
-    if (obj.topic) {
-      el += '<div class="text topic">' + escape_html(obj.topic) + '</div>';
-    }
-    if (obj.headline) {
-      el += '<div class="text headline">' + escape_html(obj.headline) + '</div>';
-    }
-    if (obj.caption) {
-      el += '<div class="text caption">' + escape_html(obj.caption) + '</div>';
-    }
-    el += '</div>';
-
+  el += '<div class="cover-info" position="bottom" data-text-adaptive="split">';
+  el += '<div class="text headline">' + escape_html(post.title ? post.title : date(post.date, config.date_format)) + '</div>';
+  if (caption.length > 0) {
+    el += '<div class="text caption">' + escape_html(caption) + '</div>';
   }
   el += '</div>';
+  el += '</div>';
   return el;
 }
 function div() {
-  if (obj.image && obj.image.length > 0 && obj.headline != undefined) {
+  if (theme.article.card_style == 'hero' && obj.image && obj.image.length > 0) {
     return div_photo();
   }
   return div_default();

package/layout/_partial/main/post_list/topic_card.ejs

@@ -1,14 +1,35 @@
 <%
 function layoutDiv() {
   var el = '';
+  var bg = topic.cover || topic.icon || theme.default.topic;
+  var label = topic.title || topic.name;
+  var latest = topic.homepage;
   el += '<article class="md-text">';
-  el += `<div class="preview"><img src="${topic.icon ? topic.icon : theme.default.topic}"/></div>`
-  el += '<div class="excerpt">';
-  el += '<h2 class="post-title">' + (topic.title || topic.name) + '</h2>';
+  // 专栏标题（story 文章 h2 样式，置于卡片外）
+  el += '<h2 class="topic-title">' + escape_html(label) + '</h2>';
+  // 专栏描述（标题下方）
   if (topic.description) {
-    el += '<p>' + topic.description + '</p>';
+    el += '<p class="topic-desc">' + escape_html(topic.description) + '</p>';
+  }
+  // 最新文章卡片（整卡跳转最新文章）
+  el += partial('_partial/main/post_list/latest_post_card', {
+    href: pretty_url(latest ? (latest.path || '/') : '/'),
+    background: bg,
+    post: latest
+  });
+  // 其他文章（排除最新，最多 3 条，按发布时间倒序）
+  if (topic.pages && topic.pages.length > 1) {
+    el += '<div class="post-panel">';
+    el += '<div class="posts">';
+    topic.pages.slice(1, 4).forEach(function(post) {
+      el += '<a class="post-link" href="' + pretty_url(post.path) + '">';
+      el += '<span class="title">' + escape_html(post.title) + '</span>';
+      el += '<span class="date">' + escape_html(date(post.date, config.date_format)) + '</span>';
+      el += '</a>';
+    });
+    el += '</div>';
+    el += '</div>';
   }
-  el += '</div>';
   el += '</article>';
   return el;
 }

package/layout/_partial/menubtn.ejs

@@ -1,8 +1,8 @@
 <div class='float-panel'>
   <button type='button' style='display:none' class='laptop-only rightbar-toggle mobile' onclick='sidebar.rightbar()'>
-    <%- icon('default:rightbar') %>
+    <%- icon('default:rightbar', '', true) %>
   </button>
   <button type='button' style='display:none' class='mobile-only leftbar-toggle mobile' onclick='sidebar.leftbar()'>
-    <%- icon('default:leftbar') %>
+    <%- icon('default:leftbar', '', true) %>
   </button>
 </div>

package/layout/_partial/scripts/bootstrap.ejs

@@ -0,0 +1,35 @@
+<script>
+  // 插件注册队列：utils.js 尚未就绪时先缓存注册请求，就绪后统一补跑，
+  // 保证解析期注册的插件不因加载时序丢失。
+  window.stellar = window.stellar || {};
+  window.stellar._pluginQueue = window.stellar._pluginQueue || [];
+  window.stellar.initPlugin = function (fn, name, options) {
+    if (typeof utils === 'object' && typeof utils.initPlugin === 'function') {
+      return utils.initPlugin(fn, name, options);
+    }
+    window.stellar._pluginQueue.push({ fn: fn, name: name, options: options || {} });
+  };
+  window.stellar._flushPlugins = function () {
+    var pending = window.stellar._pluginQueue.splice(0);
+    if (typeof utils !== 'object' || typeof utils.initPlugin !== 'function') return;
+    for (var i = 0; i < pending.length; i++) {
+      try {
+        utils.initPlugin(pending[i].fn, pending[i].name, pending[i].options);
+      } catch (e) {
+        console.error('[Stellar] 插件补注册失败:', e);
+      }
+    }
+  };
+  document.addEventListener('DOMContentLoaded', function () {
+    if (typeof utils === 'object') return;
+    // utils 未就绪时补载；加载成功后由 utils.js 内部补跑插件队列
+    var s = document.createElement('script');
+    s.src = '<%- url_for('/js/utils.js') %>?v=<%- stellar_info('version') %>';
+    s.async = false;
+    s.onerror = function () {
+      console.error('[Stellar] 无法加载 /js/utils.js，已启用内容兜底显示（sr-fallback）');
+      document.documentElement.classList.add('sr-fallback');
+    };
+    document.head.appendChild(s);
+  });
+</script>

package/layout/_partial/scripts/defines.ejs

@@ -156,7 +156,10 @@
     root : `<%- config.root %>`,
     tag_plugins: {
       chat: Object.assign(<%- JSON.stringify(theme.tag_plugins.chat) %>),
-    }
+    },
+    // 图标由构建期生成的 /js/stellar-icons.js 填充（defer，早于 DOMContentLoaded 就绪）
+    icons: {},
+    services: <%- JSON.stringify(theme.data_services || {}) %>,
   };
 
   // required plugins (only load if needs)
@@ -171,11 +174,33 @@
   const def = {
     avatar: `<%- theme.default.avatar %>`,
     cover: `<%- theme.default.cover %>`,
-    loading: `<%- theme.default.loading %>`,
+    loading: `<%- theme.default.loading || (theme.icons && theme.icons['default:loading-placeholder']) %>`,
     data_cache: <%- JSON.stringify(theme.data_cache || {}) %>,
   };
   const deps = {
     marked: `<%- url_for(theme.dependencies.marked) %>`,
     lazyload: `<%- url_for(theme.dependencies.lazyload.js) %>`
   }
+
+  // 主题切换提示文案（供 /js/theme.js 使用）
+  window.__STELLAR_I18N__ = {
+    light: `<%- __('message.theme_switched.light') %>`,
+    dark: `<%- __('message.theme_switched.dark') %>`,
+    auto: `<%- __('message.theme_switched.auto') %>`,
+  };
+
+  // 搜索跳转高亮：URL 带 ?kw= 时按需加载，定位正文中的匹配词
+  (function () {
+    try {
+      if (!window.location.search) return;
+      if (!new URLSearchParams(window.location.search).has('kw')) return;
+      document.addEventListener('DOMContentLoaded', function () {
+        // utils 由 /js/utils.js 定义（同时暴露 window.utils）；
+        // 未就绪时由 bootstrap 队列兜底，此处按就绪状态判断
+        if (typeof utils === 'object' && typeof utils.js === 'function') {
+          utils.js('<%- url_for('/js/search/highlight.js') %>', { defer: true }).catch(function () {});
+        }
+      });
+    } catch (e) {}
+  })();
 </script>

package/layout/_partial/scripts.ejs

@@ -14,22 +14,54 @@ function custom_inject() {
   return el;
 }
 
+// tagtree 脚本仅在与 tagtree 小部件渲染相同的条件下加载（见 _partial/sidebar/index_leftbar.ejs）
+function tagtreeWidgetOnPage() {
+  const leftbar = page && page.leftbar;
+  if (!Array.isArray(leftbar)) {
+    return false;
+  }
+  return leftbar.some(function (w) {
+    if (typeof w === 'string') {
+      return w === 'tagtree';
+    }
+    if (w && typeof w === 'object') {
+      return w.override === 'tagtree' || w.layout === 'tagtree';
+    }
+    return false;
+  });
+}
+
 %>
 <%- partial('scripts/defines') %>
-<%- partial('scripts/utils') %>
-<%- partial('scripts/sidebar') %>
-<%- partial('scripts/tagtree') %>
-<%- partial('scripts/lazyload') %>
 
-<!-- required -->
+<%- partial('scripts/bootstrap') %>
+
+<!-- core: utils 必须同步加载（页尾内联插件片段在解析期即调用 utils.initPlugin） -->
+<script src="<%- url_for('/js/utils.js') %>?v=<%- stellar_info('version') %>"></script>
+<script>
+  // 解析期检测 utils 是否已就绪；未就绪时同步补载，
+  // 保证「utils 先于页尾插件片段定义」的不变量。
+  if (typeof utils === 'undefined') {
+    document.write('<script src="<%- url_for('/js/utils.js') %>?v=<%- stellar_info('version') %>"><\/script>');
+  }
+</script>
+<script defer src="<%- url_for('/js/stellar-icons.js') %>?v=<%- stellar_info('version') %>"></script>
+<!-- 非首屏图标异步加载：占位符替换依赖构建期生成的 js/icons/{ns}.json -->
+<script defer src="<%- url_for('/js/icons.js') %>?v=<%- stellar_info('version') %>" data-version="<%- stellar_info('version') %>"></script>
 <script src="<%- url_for(`${theme.stellar.main_js}?v=${stellar_info('version')}`) %>" defer></script>
+<script defer src="<%- url_for('/js/theme.js') %>?v=<%- stellar_info('version') %>"></script>
 
-<%- partial('scripts/theme') %>
+<% if (tagtreeWidgetOnPage()) { %>
+  <script>window.__STELLAR_TAGTREE__ = { expand_active: <%- JSON.stringify(!!(theme.widgets.tagtree && theme.widgets.tagtree.expand_active)) %> };</script>
+  <script defer src="<%- url_for('/js/tagtree.js') %>?v=<%- stellar_info('version') %>"></script>
+<% } %>
+
+<%- partial('scripts/lazyload') %>
 
 <!-- optional -->
 <%- partial('comments/script') %>
 
-<%- partial('scripts/services') %>
+<script defer src="<%- url_for('/js/services.js') %>?v=<%- stellar_info('version') %>"></script>
 <%- partial('../_plugins/index') %>
 
 <!-- inject -->

package/layout/_partial/sidebar/logo.ejs

@@ -50,7 +50,7 @@ function layoutBack() {
   var el = ''
   el += `<div class="wiki-home-wrap">`
   el += `<a class="wiki-home cap" href="${pretty_url(theme.site_tree.index_wiki.base_dir)}">`
-  el += icon('default:goback')
+  el += icon('default:goback', '', true)
   el += `<span>${__('btn.all_wiki')}</span>`
   el += `</a>`
   el += `</div>`

package/layout/_partial/sidebar/menu.ejs

@@ -15,7 +15,7 @@ function layoutDiv() {
     el += ` style="${style}"`
     el += ` title="${item.title}" href="${pretty_url(item.url)}">`
     if (item.icon?.length > 0) {
-      el += icon(item.icon, 'no-lazy')
+      el += icon(item.icon, 'no-lazy', true)
     }
     el += `<span>${__(item.title)}</span>`
     if (active) {

package/layout/_partial/sidebar/search.ejs

@@ -32,7 +32,7 @@ function layoutDiv() {
     }
   }
   el += `<a class="search-button" onclick="document.getElementById(&quot;search-input&quot;).focus();">`
-  el += icon('default:search')
+  el += icon('default:search', '', true)
   el += `</a>`
   el += `<input type="text" class="search-input" id="search-input"`
   if (filter.length > 0) {

package/layout/_partial/widgets/author.ejs

@@ -26,7 +26,7 @@ function layoutDiv() {
 
     // homepage
     el += `<a class="follow" href="${url_for(author.path)}">`
-    el += icon('solar:documents-bold-duotone')
+    el += icon('default:documents')
     el += __('btn.all_posts')
     el += `</a>`
   el += `</div>`

package/layout/_partial/widgets/components/link.ejs

@@ -12,10 +12,10 @@ function layoutDiv() {
   }
   el += `</div>`
   if (columns == 1 && isActive) {
-    el += icon('default:bookmark.active')
+    el += '<span class="active-dot"></span>'
   }
   el += `</a>`
   return el
 }
 %>
-<%- layoutDiv() %>
+<%- layoutDiv() %>

package/layout/_partial/widgets/ghuser.ejs

@@ -30,7 +30,7 @@ function layoutDiv() {
   if (item.header) {
     el += `<div class="widget-header">`
       el += `<a class="gh-url" href="https://github.com/${item.username}">
-        <svg xmlns="http://www.w3.org/2000/svg" width="32" height="32" viewBox="0 0 24 24"><!-- Icon from TDesign Icons by TDesign - https://github.com/Tencent/tdesign-icons/blob/main/LICENSE --><path fill="currentColor" d="M12 .999c-6.074 0-11 5.05-11 11.278c0 4.983 3.152 9.21 7.523 10.702c.55.104.727-.246.727-.543v-2.1c-3.06.683-3.697-1.33-3.697-1.33c-.5-1.304-1.222-1.65-1.222-1.65c-.998-.7.076-.686.076-.686c1.105.08 1.686 1.163 1.686 1.163c.98 1.724 2.573 1.226 3.201.937c.098-.728.383-1.226.698-1.508c-2.442-.286-5.01-1.253-5.01-5.574c0-1.232.429-2.237 1.132-3.027c-.114-.285-.49-1.432.107-2.985c0 0 .924-.303 3.026 1.156c.877-.25 1.818-.375 2.753-.38c.935.005 1.876.13 2.755.38c2.1-1.459 3.023-1.156 3.023-1.156c.598 1.554.222 2.701.108 2.985c.706.79 1.132 1.796 1.132 3.027c0 4.332-2.573 5.286-5.022 5.565c.394.35.754 1.036.754 2.088v3.095c0 .3.176.652.734.542C19.852 21.484 23 17.258 23 12.277C23 6.048 18.075.999 12 .999"/></svg>
+        ${icon('github:logo-alt')}
         <span>github/${item.username}</span>
         </a>`
     el += `</div>`

package/layout/_partial/widgets/related.ejs

@@ -18,7 +18,7 @@ function relatedPostsInTopic() {
     el += `<a class="item${isActive ? ' active' : ''}" href="${pretty_url(post.path)}">`
     el += `<span class="title">${post.title}</span>`
     if (isActive) {
-      el += icon('default:bookmark.active')
+      el += '<span class="active-dot"></span>'
     }
     el += `</a>`
   }

package/layout/_partial/widgets/toc.ejs

@@ -15,7 +15,7 @@ function layoutTocHeader(title) {
   var el = ''
   el += `<div class="widget-header dis-select">`
   el += `<span class="name">${title || __("meta.toc")}</span>`
-  el += `<a class="cap-action" onclick="sidebar.toggleTOC()" >${icon('default:rightbar')}</a>`
+  el += `<a class="cap-action" onclick="sidebar.toggleTOC()" >${icon('default:rightbar', '', true)}</a>`
   el += `</div>`
   return el
 }
@@ -60,12 +60,12 @@ function layoutDiv(fallback) {
   }
   el += `<div class="widget-footer">`
   el += `<a class="top" onclick="util.scrollTop()">`
-  el += icon('default:upup')
+  el += icon('default:upup', '', true)
   el += `<span>${__('btn.top')}</span>`
   el += `</a>`
   if (hasComments) {
     el += `<a class="buttom" onclick="util.scrollComment()">`
-    el += icon('default:tocomment')
+    el += icon('default:tocomment', '', true)
     el += `<span>${__('btn.comments')}</span>`
     el += `</a>`
   }

package/layout/_partial/widgets/tree.ejs

@@ -27,7 +27,7 @@ function layoutDocTree(pages) {
       el += `<a class="link${isActive}" href="${href}">`
       el += `<span class="toc-text">${p.title}</span>`
       if (isActive.length > 0) {
-        el += icon('default:bookmark.active')
+        el += '<span class="active-dot"></span>'
       }
       el += `</a>`
     }

package/layout/_plugins/adaptive_text.ejs

@@ -0,0 +1,11 @@
+<script>
+  stellar.initPlugin(() => {
+    const els = Array.prototype.slice.call(document.querySelectorAll('[data-text-adaptive]'));
+    if (els.length === 0) return;
+    utils.js('/js/color.js').then(() => utils.js('/js/plugins/adaptive-text.js')).then(() => {
+      if (typeof applyAdaptiveText === 'function') {
+        applyAdaptiveText(els);
+      }
+    });
+  }, 'adaptive-text');
+</script>

package/layout/_plugins/copycode.ejs

@@ -1,5 +1,5 @@
 <script>
-  utils.initPlugin(() => {
+  stellar.initPlugin(() => {
     const codeElements = document.querySelectorAll('.code');
     if (codeElements.length > 0) {
       ctx.copycode = {
@@ -14,4 +14,4 @@
       });
     }
   }, 'copycode');
-</script>
+</script>

package/layout/_plugins/fancybox.ejs

@@ -7,8 +7,9 @@
   };
   // auto=按需：页面存在可弹窗图片才加载；global=全局：所有页面加载
   const isGlobal = ctx.fancybox.mode === 'global';
-  // 评论区图片（artalk/twikoo/waline）显示较小，自动支持放大
-  var selector = '[data-fancybox]:not(.error), .with-fancybox img:not([atk-emoticon]):not([class*="emo"])';
+  // 评论区图片（artalk/twikoo/waline）显示较小，自动支持放大；
+  // 仅绑定各评论服务的评论内容区，编辑器、表情面板等非内容区图片不弹窗
+  var selector = '[data-fancybox]:not(.error), .with-fancybox .atk-content img:not([atk-emoticon]):not([class*="emo"]), .with-fancybox .tk-content img:not([atk-emoticon]):not([class*="emo"]), .with-fancybox .wl-content img:not([atk-emoticon]):not([class*="emo"])';
   if (ctx.fancybox.selector) {
     selector += `, ${ctx.fancybox.selector}`
   }
@@ -31,6 +32,7 @@
     }
   }
   if (needFancybox) {
+    utils.css(`<%- url_for('/css/plugins/fancybox.css') %>?v=<%- stellar_info('version') %>`);
     utils.css(ctx.fancybox.css);
     utils.js(ctx.fancybox.js, { defer: true }).then(function () {
       if (isGlobal) {

package/layout/_plugins/mermaid.ejs

@@ -1,8 +1,9 @@
 <script defer type="text/javascript" src="<%- conf.js %>"></script>
 <script>
-  utils.initPlugin(() => {
+  stellar.initPlugin(() => {
     const els = document.querySelectorAll('.mermaid');
     if (els.length > 0) {
+      utils.css(`<%- url_for('/css/plugins/mermaid.css') %>?v=<%- stellar_info('version') %>`);
       const mermaid_config = {
         startOnLoad: false,
         theme:
@@ -30,4 +31,4 @@
       mermaid.run();
     }
   }, 'mermaid');
-</script>
+</script>

package/layout/_plugins/scrollreveal.ejs

@@ -1,7 +1,20 @@
 <script>
-  utils.initPlugin(() => {
-    const els = Array.prototype.slice.call(document.querySelectorAll('.slide-up'));
-    if (els.length === 0) return;
+  (function () {
+    // 兜底看门狗独立于插件初始化：3 秒内未完成 reveal 时强制显示 .slide-up 内容
+    let fallbackApplied = false;
+    const revealFallback = () => {
+      if (fallbackApplied) return;
+      fallbackApplied = true;
+      document.documentElement.classList.add('sr-fallback');
+    };
+    const watchdog = setTimeout(() => revealFallback(), 3000);
+
+    stellar.initPlugin(() => {
+      const els = Array.prototype.slice.call(document.querySelectorAll('.slide-up'));
+      if (els.length === 0) {
+        clearTimeout(watchdog);
+        return;
+      }
 
     // 吸顶/固定定位容器内的元素始终在视口内（或由容器控制显隐），
     // 但 ScrollReveal 按文档坐标判断可见性，会误判这类元素为不可见，
@@ -45,15 +58,10 @@
         targets.push(el);
       }
     });
-    if (pinnedGroups.size === 0 && targets.length === 0) return;
-
-    // 加载/初始化失败时兜底显示内容，避免整页空白
-    let fallbackApplied = false;
-    const revealFallback = () => {
-      if (fallbackApplied) return;
-      fallbackApplied = true;
-      document.documentElement.classList.add('sr-fallback');
-    };
+    if (pinnedGroups.size === 0 && targets.length === 0) {
+      clearTimeout(watchdog);
+      return;
+    }
 
     const slideUp = {
       distance: `<%- conf.distance %>`,
@@ -64,9 +72,6 @@
       easing: "ease-out"
     };
 
-    // 看门狗：CDN 长时间无响应时强制显示内容
-    const watchdog = setTimeout(() => revealFallback(), 3000);
-
     utils.js(`<%- conf.js %>`, { defer: true })
       .then(() => {
         if (fallbackApplied) return;
@@ -92,5 +97,6 @@
         console.error('[Plugin scrollreveal] 加载失败:', err);
         revealFallback();
       });
-  }, 'scrollreveal');
+    }, 'scrollreveal');
+  })();
 </script>

package/layout/_plugins/search/local_search.ejs

@@ -1,8 +1,9 @@
 <script>
   window.addEventListener('DOMContentLoaded', (event) => {
-    ctx.search = {
+    ctx.search = Object.assign({}, ctx.search, {
       path: `<%- conf.path || '/search.json' %>`,
-    }
+      local_search: <%- JSON.stringify(conf) %>,
+    });
     utils.js('/js/search/local-search.js', { defer: true });
   });
-</script>
+</script>

package/layout/_plugins/swiper.ejs

@@ -1,7 +1,8 @@
 <script>
-  utils.initPlugin(() => {
+  stellar.initPlugin(() => {
     const swiper_api = document.getElementById('swiper-api');
     if (swiper_api != undefined) {
+      utils.css(`<%- url_for('/css/plugins/swiper.css') %>?v=<%- stellar_info('version') %>`);
       utils.css(`<%- conf.css %>`);
       utils.js(`<%- conf.js %>`, { defer: true }).then(function () {
         const effect = swiper_api.getAttribute('effect') || '';

package/layout/categories.ejs

@@ -16,7 +16,7 @@ if (page.menu_id == undefined) {
         nodes.forEach(function(node) {
           el += `<div class="cat-item">`
           el += `<a class="cat${node.parentId ? ' child' : ''}" href="${pretty_url(node.path)}">`
-          el += `<span class="name">${icon('default:category')}${escape_html(node.name)}</span>`
+          el += `<span class="name">${icon(node.children && node.children.length > 0 ? 'default:category-open' : 'default:category')}${escape_html(node.name)}</span>`
           el += `<span class="badge">(${node.count})</span>`
           el += `</a>`
           if (node.children && node.children.length > 0) {

package/layout/index.ejs

@@ -76,11 +76,19 @@ if (pinFlat && is_home_first_page()) {
 function layout_post_card(layout, post, content) {
   var el = '';
   var layout = layout;
-  if (layout == 'post' && post.cover != undefined && post.poster != undefined) {
+  var hero = false;
+  if (layout == 'post' && post.cover != undefined && theme.article.card_style == 'hero') {
     layout += ' photo';
+    hero = true;
   }
   el += `<div class="post-card-wrap${scrollreveal(' ')}">`;
-  el += `<a class="post-card ${layout}" href="${pretty_url(post.link || post.path)}">`
+  if (hero) {
+    // hero 封面卡片：背景图由 .post-card 自身背景承载（跟随 corner-shape 圆角裁剪），
+    // 子图保留用于 hover 变暗/放大滤镜
+    el += `<a class="post-card ${layout}" style="--cover-url:url('${escape_html(post.cover.replace(/'/g, '%27'))}')" href="${pretty_url(post.link || post.path)}">`
+  } else {
+    el += `<a class="post-card ${layout}" href="${pretty_url(post.link || post.path)}">`
+  }
   el += content;
   el += '</a>';
   el += '</div>';

package/layout/index_topic.ejs

@@ -8,9 +8,9 @@ function layout_topic_list(partial) {
       continue
     }
     el += `<div class="post-card-wrap${scrollreveal(' ')}">`
-    el += `<a class="post-card wiki topic" href="${pretty_url(topic.homepage?.path || '/')}">`
+    el += `<div class="post-card topic">`
     el += partial(topic)
-    el += `</a>`
+    el += `</div>`
     el += `</div>`
   }
   return el
@@ -18,7 +18,7 @@ function layout_topic_list(partial) {
 function layoutDiv() {
   var el = ''
   el += partial('_partial/main/navbar/nav_tabs_blog')
-  el += `<div class="post-list wiki topic">`;
+  el += `<div class="post-list topic">`;
   el += layout_topic_list(function(topic) {
     return partial('_partial/main/post_list/topic_card', {topic: topic})
   })
@@ -27,4 +27,4 @@ function layoutDiv() {
 }
 %>
 
-<%- layoutDiv() %>
+<%- layoutDiv() %>

package/layout/page.ejs

@@ -56,6 +56,9 @@ function layoutDiv() {
   }
   el += `</article>`
   if (layout === 'post' || page.wiki || notebook) {
+    if (layout === 'post' && theme.article.tags) {
+      el += partial('_partial/main/article/article_tags')
+    }
     el += partial('_partial/main/article/article_footer')
   }
   if (layout === 'post' || page.wiki) {