hexo-theme-stellar 1.22.1 → 1.24.0

package/_config.yml

@@ -1,6 +1,6 @@
 ######## Stellar info ########
 stellar:
-  version: '1.22.1'
+  version: '1.24.0'
   homepage: 'https://xaoxuu.com/wiki/stellar/'
   repo: 'https://github.com/xaoxuu/hexo-theme-stellar'
   cdn_css: # Use cdn links instead of /css/main.css
@@ -8,6 +8,10 @@ stellar:
 
 
 ######## head tags ########
+preconnect:
+  # - https://gcore.jsdelivr.net
+  # - https://unpkg.com
+
 open_graph:
   enable: true
   twitter_id: # for open_graph meta
@@ -55,6 +59,8 @@ breadcrumb:
 article:
   # 如果没有指定封面，是否根据 tags 作为关键词搜索封面图片？
   auto_cover: false # search from https://source.unsplash.com/
+  # 封面图宽高比
+  cover_ratio: 2.4
   # 如果没有指定横幅，是否根据 tags 作为关键词搜索横幅图片？
   auto_banner: false # search from https://source.unsplash.com/
   # 如果没有指定 excerpt 和 description，将自动取多长的内容作为文章摘要？
@@ -107,6 +113,7 @@ comments:
   # giscus
   # https://giscus.app/zh-CN
   giscus:
+    src: https://giscus.app/client.js
     data-repo: xxx/xxx # [在此输入仓库]
     data-repo-id: # [在此输入仓库 ID]
     data-category: # [在此输入分类名]
@@ -208,7 +215,7 @@ footer:
     #   - '[关于本站](/)'
     #   - '[GitHub](/)'
   content: | # 支持 Markdown 格式
-    本站由 [@anonymity](/) 使用 [Stellar](https://github.com/xaoxuu/hexo-theme-stellar) 主题创建。
+    本站由 [${author.name}](/) 使用 [${theme.name} ${theme.version}](${theme.tree}) 主题创建。
     本博客所有文章除特别声明外，均采用 [CC BY-NC-SA 4.0](https://creativecommons.org/licenses/by-nc-sa/4.0/) 许可协议，转载请注明出处。
   # 主题用户越多，开发者维护和更新的积极性就越高，如果您喜欢本主题，请在适当的位置显示主题信息和仓库链接以表支持。
 
@@ -240,7 +247,9 @@ tag_plugins:
   # {% image %}
   image:
     fancybox: false # true, false
-
+  # {% copy xxx %}
+  copy:
+    toast: 复制成功
   # {% timeline %}
   timeline:
     max-height: 80vh
@@ -296,6 +305,7 @@ plugins:
     fcircle: /js/plugins/fcircle.js
     weibo: /js/plugins/weibo.js
     memos: /js/plugins/memos.js
+    marked: /js/plugins/marked.js
 
   marked: https://cdn.bootcdn.net/ajax/libs/marked/4.0.18/marked.min.js
 
@@ -332,7 +342,7 @@ plugins:
     # 可以处理评论区的图片（不支持 iframe 类评论系统）例如：
     # 使用twikoo评论可以写: .tk-content img:not([class*="emo"])
     # 使用waline评论可以写: #waline_container .vcontent img
-    selector: .swiper-slide img, .gallery img # 多个选择器用英文逗号隔开
+    selector: .fancybox img # 多个选择器用英文逗号隔开
 
   # swiper
   swiper:
@@ -352,15 +362,15 @@ plugins:
   # 需在Markdown文件开头加入mathjax: true
   # 推荐使用Pandoc: npm uninstall hexo-renderer-marked --save & npm install hexo-renderer-pandoc --save
   mathjax:
-    enable: false
-    cdn: https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.6/MathJax.js?config=TeX-AMS-MML_HTMLorMML
+    # set <mathjax: true> to enable in page's front-matter
+    js: https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.6/MathJax.js?config=TeX-AMS-MML_HTMLorMML
 
   # Katex - The fastest math typesetting library for the web
   # https://katex.org/docs/autorender.html
   # https://github.com/KaTeX/KaTeX
   # 使用 hexo-renderer-markdown-it-plus 作为公式渲染器：npm uninstall hexo-renderer-marked --save npm install hexo-renderer-markdown-it-plus --save
   katex:
-    enable: false
+    # set <katex: true> to enable in page's front-matter
     min_css: <link rel="stylesheet" href="https://gcore.jsdelivr.net/npm/katex@0.16.4/dist/katex.min.css" integrity="sha384-vKruj+a13U8yHIkAyGgK1J3ArTLzrFGBbBc0tDp4ad/EyewESeXE/Iv67Aj8gKZ0" crossorigin="anonymous">
     min_js: <script defer src="https://gcore.jsdelivr.net/npm/katex@0.16.4/dist/katex.min.js" integrity="sha384-PwRUT/YqbnEjkZO0zZxNqcxACrXe+j766U2amXcgMg5457rve2Y7I6ZJSm2A0mS4" crossorigin="anonymous"></script>
     auto_render_min_js: <script defer src="https://gcore.jsdelivr.net/npm/katex@0.16.4/dist/contrib/auto-render.min.js" integrity="sha384-+VBxd3r6XgURycqtZ117nYw44OOcIax56Z4dCRWbxyPt0Koah1uHoK0o4+/RRE05" crossorigin="anonymous"onload="renderMathInElement(document.body);"></script>
@@ -375,7 +385,8 @@ plugins:
   #   B -->|option 2| C(Section C)
   # ```
   mermaid:
-    enable: false
+    # set <mermaid: true> to enable in page's front-matter
+    style_optimization: false # use custom style in stellar
     # js: https://unpkg.com/mermaid@9.0.0/dist/mermaid.min.js
     js: https://cdn.jsdelivr.net/npm/mermaid@v9/dist/mermaid.min.js
     # Available themes: default | dark | forest | neutral
@@ -387,6 +398,7 @@ plugins:
     js: /js/plugins/copycode.js
     default_text: 'Copy'
     success_text: 'Copied'
+    toast: 复制成功
   
   # AI 摘要
   # https://github.com/zhheo/Post-Abstract-AI
@@ -419,7 +431,7 @@ style:
     # 动态颜色（会根据明暗主题重设明度值，只用关心色相和饱和度即可）
     background: 'hsl(212 16% 98%)' # 浅色背景颜色
     block: 'hsl(212 8% 95%)' # 块背景颜色
-    code: 'hsl(14 100% 48%)' # 行内代码颜色
+    code: 'hsl(220 20% 10%)' # 'hsl(14 100% 48%)' # 行内代码颜色
     text: 'hsl(0 0% 20%)' # 文本颜色
     # 主题色配置（不会根据明暗动态调整，请设置为通用的颜色）
     theme: 'hsl(192 98% 55%)' # 主题色

package/_data/widgets.yml

@@ -34,6 +34,7 @@ recent:
   layout: recent
   rss: # /atom.xml # npm i hexo-generator-feed
   limit: 5 # Count of posts
+
 # TOC (valid only in layout:post/wiki)
 toc:
   layout: toc
@@ -41,6 +42,8 @@ toc:
   min_depth: 2
   max_depth: 5
   fallback: recent # Use a backup widget when toc does not exist.
+  collapse: false # true / false / auto
+
 # github user info
 ghuser:
   layout: ghuser

package/languages/en.yml

@@ -24,6 +24,7 @@ meta:
   comment_title: Join the discussion
   back_to_top: Back to top
   more: 'More %s'
+  created_author: '%s posted on'
   created: 'Posted on'
   updated: 'Updated on'
   license: License

package/languages/zh-CN.yml

@@ -24,6 +24,7 @@ meta:
   comment_title: 快来参与讨论吧
   back_to_top: 回到顶部
   more: '更多「%s」'
+  created_author: 本文由 %s 发布于
   created: 发布于
   updated: 更新于
   license: 许可协议

package/languages/zh-TW.yml

@@ -24,6 +24,7 @@ meta:
   comment_title: 參與討論
   back_to_top: 回到頁首
   more: '更多「%s」'
+  created_author: 本文由 %s 發布於
   created: 發布於
   updated: 更新於
   license: 授權條款

package/layout/_partial/head.ejs

@@ -67,18 +67,38 @@ function og_args() {
   }
   return Object.assign(args, page.open_graph);
 }
+
+function preconnect() {
+  var el = '';
+  for (let href of (theme.preconnect || [])) {
+    el += `<link rel="preconnect" href="${href}" crossorigin>`;
+  }
+  return el;
+}
+
+function custom_inject() {
+  var el = '';
+  for (let item of (config.inject?.head || [])) {
+    el += item;
+  }
+  for (let item of (theme.inject?.head || [])) {
+    el += item;
+  }
+  for (let item of (page.inject?.head || [])) {
+    el += item;
+  }
+  return el;
+}
+
 %>
+
 <head>
-  <%- meta_generator() %>
-  <meta name="hexo-theme" content="<%- stellar_info('tree') %>">
   <meta charset="utf-8">
+  <meta name="hexo-theme" content="<%- stellar_info('tree') %>" theme-name="<%- stellar_info('name') %>" theme-version="<%- stellar_info('version') %>">
   <%- generate_robots() %>
-
+  <%- meta_generator() %>
   <meta http-equiv='x-dns-prefetch-control' content='on' />
-  <link rel='dns-prefetch' href='https://gcore.jsdelivr.net'>
-  <link rel="preconnect" href="https://gcore.jsdelivr.net" crossorigin>
-  <link rel='dns-prefetch' href='//unpkg.com'>
-
+  <%- preconnect() %>
   <meta name="renderer" content="webkit">
   <meta name="force-rendering" content="webkit">
   <meta http-equiv="X-UA-Compatible" content="IE=Edge,chrome=1">
@@ -115,16 +135,6 @@ function og_args() {
     <%- css(theme.style.codeblock.highlightjs_theme) %>
   <% } %>
 
-  <% if (theme.plugins.katex && theme.plugins.katex.enable) { %>
-    <%- theme.plugins.katex.min_css %>
-    <%- theme.plugins.katex.min_js %>
-    <%- theme.plugins.katex.auto_render_min_js %>
-  <% } %>
-
-
-  <% if (config.inject && config.inject.head){ %>
-    <% (config.inject.head||[]).forEach(function(item){ %>
-      <%- item %>
-    <% }) %>
-  <% } %>
+  <%- partial('plugins/parser/head') %>
+  <%- custom_inject() %>
 </head>

package/layout/_partial/main/article/article_footer.ejs

@@ -40,25 +40,36 @@ function layoutDiv() {
   var license = ''
   if (page.layout == 'post') {
     if (theme.article.license && (page.license != false)) {
-      license = markdown(page.license || theme.article.license)
+      license = page.license || theme.article.license
     }
   } else if (page.layout == 'wiki' && page.wiki) {
     let proj = theme.wiki.tree[page.wiki]
     if (page.license != null) {
-      license = markdown(page.license || theme.article.license)
+      license = page.license || theme.article.license
     } else if (proj?.license != null) {
       if (proj.license == true) {
-        license = markdown(theme.article.license)
+        license = theme.article.license
       } else {
-        license = markdown(proj.license)
+        license = proj.license
       }
     }
   }
   if (license.length > 0) {
+    var author = null
+    if (theme.authors) {
+      if (page.author?.length > 0 && theme.authors[page.author] != null) {
+        author = theme.authors[page.author]
+      } else {
+        author = theme.default_author
+      }
+    }
+    if (author) {
+      license = license.replace('${author.name}', author.name).replace('${author.url}', author.url)
+    }
     el += `
     <section id="license">
       <div class="header"><span>${__('meta.license')}</span></div>
-      <div class="body">${license}</div>
+      <div class="body">${markdown(license)}</div>
     </section>
     `
   }

package/layout/_partial/main/footer.ejs

@@ -1,41 +1,35 @@
 <%
-const content = theme.footer.content;
+const content = theme.footer.content?.replace('${author.name}', (config.author || 'Anonymity'))?.replace('${theme.name}', stellar_info('name'))?.replace('${theme.version}', stellar_info('version'))?.replace('${theme.tree}', stellar_info('tree'))
 function layoutDiv() {
-  var el = '';
-  el += '<footer class="page-footer reveal fs12">';
-  el += '<hr>';
+  var el = ''
+  el += '<footer class="page-footer reveal fs12">'
+  el += '<hr>'
   // sitemap
   if (theme.footer.sitemap && Object.keys(theme.footer.sitemap).length > 0) {
-    el += '<div class="sitemap">';
+    el += '<div class="sitemap">'
     for (let group of Object.keys(theme.footer.sitemap)) {
-      let items = theme.footer.sitemap[group];
+      let items = theme.footer.sitemap[group]
       if (items == undefined || items.length == 0) {
-        continue;
+        continue
       }
-      el += '<div class="sitemap-group">';
-      el += '<span class="fs14">' + group + '</span>';
+      el += '<div class="sitemap-group">'
+      el += '<span class="fs14">' + group + '</span>'
       items.forEach((item, i) => {
-        el += '<a href="' + url_for(md_link(item)) + '">';
-        el += __(md_text(item));
-        el += '</a>';
+        el += '<a href="' + url_for(md_link(item)) + '">'
+        el += __(md_text(item))
+        el += '</a>'
       });
-      el += '</div>';
+      el += '</div>'
     }
-    el += '</div>';
+    el += '</div>'
   }
   // footer
-  el += '<div class="text">';
+  el += '<div class="text">'
   if (content) {
-    if ((typeof content == 'string') && content.constructor == String) {
-      el += markdown(content);
-    } else if ((typeof content == 'object') && content.constructor == Array) {
-      content.forEach((item, i) => {
-        el += markdown(item);
-      });
-    }
+    el += markdown(content)
   }
-  el += '</div></footer>';
-  return el;
+  el += '</div></footer>'
+  return el
 }
 %>
 <%- layoutDiv() %>

package/layout/_partial/main/navbar/author_banner.ejs

@@ -0,0 +1,31 @@
+<%
+function layoutDiv() {
+  const author = page.author
+  var el = ``
+  el += `<div class="tag-plugin banner author">`
+  if (author.banner) {
+    el += `<img class="bg" src="${author.banner}">`
+  }
+  el += `
+  <div class="content">
+    <div class="top">
+      <button class="back cap" onclick="window.history.back()">
+        <svg aria-hidden="true" viewBox="0 0 16 16" fill="currentColor">
+          <path fill-rule="evenodd" d="M7.78 12.53a.75.75 0 01-1.06 0L2.47 8.28a.75.75 0 010-1.06l4.25-4.25a.75.75 0 011.06 1.06L4.81 7h7.44a.75.75 0 010 1.5H4.81l2.97 2.97a.75.75 0 010 1.06z"></path>
+        </svg>
+      </button>
+    </div>
+    <div class="bottom">
+      <img class="avatar" src="${author.avatar}">
+      <div class="text-area">
+        <p class="text title">${author.name}</p>
+        <div class="text subtitle">${author.description || ""}</div>
+      </div>
+    </div>
+  </div>
+  `
+  el += `</div>`
+  return el
+}
+%>
+<%- layoutDiv() %>

package/layout/_partial/main/navbar/breadcrumb.ejs

@@ -35,13 +35,29 @@ function layoutDiv() {
         });
     }
     el += '</div>';
-    // 发布日期
+    // 作者
+    var author = null
+    if (theme.authors) {
+      if (page.author?.length > 0 && theme.authors[page.author] != null) {
+        author = theme.authors[page.author]
+      } else {
+        author = theme.default_author
+      }
+    }
     el += '<div id="post-meta">';
+    if (author) {
+      let link = `<a href="${url_for(author.path)}">${author.name}</a>`
+      el += `<span class="author">${__("meta.created_author", link)}</span>`
+    } else {
+      el += `<span class="author">${__("meta.created")}</span>`
+    }
+    // 发布日期
     el += `
-    <span>${__("meta.created")}&nbsp;<time datetime="${date_xml(page.date)}">${date(page.date, config.date_format)}</time></span>
+    <span class="created"><time datetime="${date_xml(page.date)}">${date(page.date, config.date_format)}</time></span>
     `;
+    // 更新日期
     el += `
-    <span>${__("meta.updated")}&nbsp;<time datetime="${date_xml(page.updated)}">${date(page.updated, config.date_format)}</time></span>
+    <span class="updated">${__("symbol.comma") + __("meta.updated")}&nbsp;<time datetime="${date_xml(page.updated)}">${date(page.updated, config.date_format)}</time></span>
     `;
     el += '</div>';
     
@@ -84,7 +100,7 @@ function layoutDiv() {
     el += '</div>';
     el += '</div>';
 
-    let repo = page.repo || proj.repo
+    const repo = page.repo || proj?.repo
     if (repo) {
       el += `
       <div class="right ghrepo stellar-ghinfo-api" api="${theme.api_host.ghapi}/repos/${repo}">

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

@@ -68,8 +68,20 @@ function div_default() {
 
   // meta
   el += '<div class="meta cap">';
-  // time
   el += '<span class="cap" id="post-meta">';
+  // author
+  var author = null
+  if (theme.authors) {
+    if (page.author?.length > 0 && theme.authors[page.author] != null) {
+      author = theme.authors[page.author]
+    } else {
+      author = theme.default_author
+    }
+  }
+  if (author) {
+    el += author.name + '&nbsp;'
+  }
+  // time
   el += __("meta.created") + '&nbsp;' + '<time datetime="' + date_xml(post.date) + '">' + date(post.date, config.date_format) + '</time>';
   el += '</span>';
   // cat

package/layout/_partial/plugins/comments/giscus/script.ejs

@@ -9,7 +9,6 @@
         console.error(error);
       }
       var script = document.createElement('script');
-      script.src = 'https://giscus.app/client.js';
       script.async = true;
       for (let key of Object.keys(el.attributes)) {
         let attr = el.attributes[key];

package/layout/_partial/plugins/parser/head.ejs

@@ -0,0 +1,3 @@
+<% if (page.katex == true) { %>
+  <%- partial('katex/head') %>
+<% } %>

package/layout/_partial/plugins/parser/katex/head.ejs

@@ -0,0 +1,3 @@
+<% if (theme.plugins.katex) { %>
+  <%- theme.plugins.katex.min_css %>
+<% } %>

package/layout/_partial/plugins/parser/katex/script.ejs

@@ -0,0 +1,4 @@
+<% if (theme.plugins.katex) { %>
+  <%- theme.plugins.katex.min_js %>
+  <%- theme.plugins.katex.auto_render_min_js %>
+<% } %>

package/layout/_partial/plugins/parser/mathjax/script.ejs

@@ -0,0 +1,20 @@
+<script type="text/javascript" src="<%- theme.plugins.mathjax.js %>"></script>
+<script type="text/x-mathjax-config">
+MathJax.Hub.Config({
+  tex2jax: {
+    inlineMath: [ ['$','$'], ["\\(","\\)"] ],
+    processEscapes: true
+  }
+});
+MathJax.Hub.Config({
+  tex2jax: {
+    skipTags: ['script', 'noscript', 'style', 'textarea', 'pre', 'code']
+  }
+});
+MathJax.Hub.Queue(function() {
+  var all = MathJax.Hub.getAllJax(), i;
+  for(i=0; i < all.length; i += 1) {
+    all[i].SourceElement().parentNode.className += ' has-jax';
+  }
+});
+</script>

package/layout/_partial/plugins/parser/mermaid/script.ejs

@@ -0,0 +1,29 @@
+<script type="text/javascript" src="<%- theme.plugins.mermaid.js %>"></script>
+<script>
+  var mermaid_config = {
+    startOnLoad: true,
+    theme:
+      "<%- theme.style.darkmode %>" == "auto" &&
+        window.matchMedia("(prefers-color-scheme: dark)").matches
+        ? "dark"
+        : "<%- theme.plugins.mermaid.theme %>",
+    logLevel: 3,
+    themeVariables: {
+      darkMode: true
+    },
+    flowchart: {
+      useMaxWidth: false,
+      htmlLabels: true,
+      curve: "linear"
+    },
+    gantt: {
+      axisFormat: "%Y/%m/%d"
+    },
+    sequence: {
+      actorMargin: 50
+    }
+  }
+  if (window.mermaid) {
+    mermaid.initialize(mermaid_config);
+  }
+</script>

package/layout/_partial/plugins/parser/script.ejs

@@ -0,0 +1,9 @@
+<% if (page.katex == true) { %>
+  <%- partial('katex/script') %>
+<% } %>
+<% if (page.mathjax == true) { %>
+  <%- partial('mathjax/script') %>
+<% } %>
+<% if (page.mermaid == true) { %>
+  <%- partial('mermaid/script') %>
+<% } %>

package/layout/_partial/scripts/index.ejs

@@ -1,3 +1,20 @@
+<%
+
+function custom_inject() {
+  var el = '';
+  for (let item of (config.inject?.script || [])) {
+    el += item;
+  }
+  for (let item of (theme.inject?.script || [])) {
+    el += item;
+  }
+  for (let item of (page.inject?.script || [])) {
+    el += item;
+  }
+  return el;
+}
+
+%>
 <script type="text/javascript">
   const stellar = {
     // 懒加载 css https://github.com/filamentgroup/loadCSS
@@ -157,10 +174,7 @@
 
 <!-- optional -->
 <%- partial('../plugins/comments/script') %>
+<%- partial('../plugins/parser/script') %>
 
 <!-- inject -->
-<% if (config.inject && config.inject.script && config.inject.script.length > 0) { %>
-  <% config.inject.script.forEach(function(js) { %>
-    <%- js %>
-  <% }) %>
-<% } %>
+<%- custom_inject() %>

package/layout/_partial/sidebar/index.ejs

@@ -7,7 +7,7 @@ if (page.layout === 'wiki' && page.wiki) {
 if (page.sidebar == undefined) {
   if (page.layout == 'post' && page.content) {
     page.sidebar = theme.sidebar.widgets.post;
-  } else if (page.layout == 'wiki' && page.content && page.wiki) {
+  } else if (page.layout == 'wiki' && page.wiki) {
     let proj = theme.wiki.tree[page.wiki];
     if (proj?.sidebar) {
       page.sidebar = proj.sidebar;

package/layout/_partial/widgets/markdown.ejs

@@ -1,6 +1,6 @@
 <%
 function layoutDiv() {
-  if (!item.content?.length) return ''
+  if (!item.content?.length && !item.src?.length) return ''
   var el = '';
   el += '<widget class="widget-wrapper markdown">';
   if (item.title?.length > 0) {
@@ -9,7 +9,12 @@ function layoutDiv() {
     el += '</div>';
   }
   el += '<div class="widget-body fs14">';
-  el += markdown(item.content);
+  if (item.content) {
+    el += markdown(item.content);
+  }
+  if (item.src) {
+    el += `<div class="stellar-marked-api md-marked" src="${item.src}"></div>`
+  }
   el += '</div>';
   el += '</widget>';
   return el;

package/layout/_partial/widgets/toc.ejs

@@ -66,7 +66,7 @@ function layoutDiv(fallback) {
 
   var el = '';
   if (type.length > 0) {
-    el += '<widget class="widget-wrapper toc ' + type + '" id="data-toc">';
+    el += `<widget class="widget-wrapper toc ${type}" id="data-toc" collapse="${item.collapse}">`;
     if (page.layout !== 'wiki') {
       // post 布局
       el += layoutTocHeader(page.toc_title);