hexo-theme-stellar 1.30.4 → 1.32.0

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

@@ -0,0 +1,86 @@
+const https = require('https');
+const path = require('path');
+const fs = require('fs');
+const packageName = 'hexo-theme-stellar';
+const cacheFile = path.join(__dirname, '../../.cache/stellar-version.json');
+
+function getLocalVersion() {
+  try {
+    return require(path.join(__dirname, '../../../package.json')).version;
+  } catch {
+    return '0.0.0';
+  }
+}
+
+function fetchLatestVersion(callback) {
+  const options = {
+    hostname: 'registry.npmjs.org',
+    path: `/${encodeURIComponent(packageName)}`,
+    headers: {
+      'User-Agent': 'Hexo-Theme-Version-Check'
+    }
+  };
+
+  https.get(options, (res) => {
+    let rawData = '';
+    res.on('data', chunk => rawData += chunk);
+    res.on('end', () => {
+      try {
+        const data = JSON.parse(rawData);
+        const latest = data['dist-tags'].latest;
+        callback(null, latest);
+      } catch (err) {
+        callback(err);
+      }
+    });
+  }).on('error', err => callback(err));
+}
+
+function shouldCheck() {
+  if (!fs.existsSync(cacheFile)) return true;
+  try {
+    const cache = JSON.parse(fs.readFileSync(cacheFile, 'utf8'));
+    const time = new Date().toISOString().slice(0, 16); // 精确到分钟，例如 "2025-06-21T15:08"
+    return cache.time !== time;
+  } catch {
+    return true;
+  }
+}
+
+function writeCache(latestVersion) {
+  try {
+    fs.mkdirSync(path.dirname(cacheFile), { recursive: true });
+    fs.writeFileSync(cacheFile, JSON.stringify({
+      time: new Date().toISOString().slice(0, 16),
+      latest: latestVersion
+    }));
+  } catch {
+    // 忽略错误
+  }
+}
+
+module.exports = (ctx, options = { useCache: true }) => {
+  if (process.env.STELLAR_VERSION_CHECKED === '1') return;
+  process.env.STELLAR_VERSION_CHECKED = '1';
+
+  const localVersion = getLocalVersion();
+  if (options.useCache && !shouldCheck()) return;
+
+  fetchLatestVersion((err, latest) => {
+    if (err) return;
+    if (localVersion !== latest) {
+      console.log(``);
+      const line = '------------------------------------------------';
+      ctx.log.warn(`\x1b[33m${line}\x1b[0m`);
+      ctx.log.warn(``);
+      ctx.log.warn(`  本地版本: \x1b[33m${localVersion}\x1b[0m    >>>>    最新版本: \x1b[32m${latest}\x1b[0m`);
+      ctx.log.warn(``);
+      ctx.log.warn(`  请尽快升级:  npm i ${packageName}@latest`);
+      ctx.log.warn(``);
+      ctx.log.warn(`\x1b[33m${line}\x1b[0m`);
+      console.log(``);
+    }
+    if (options.useCache) writeCache(latest);
+  });
+
+};

package/scripts/helpers/json_ld.js

@@ -0,0 +1,118 @@
+/**
+ * Builds JSON-LD structured data for current page according to its type (page or post).
+ *
+ * @returns {string} - JSON-LD structured data
+ */
+'use strict';
+
+const util = require('hexo-util');
+  
+hexo.extend.helper.register('json_ld', function(args) {
+  const page = this.page;
+  const config = this.config;
+  const structured_data = this.theme.structured_data;
+  const authorEmail = config.email;
+  const authorImage = config.avatar || (authorEmail ? this.gravatar(authorEmail) : null);
+
+  const author = {
+    '@type': 'Person',
+    name: config.author,
+    sameAs: structured_data.sameAs || []
+  };
+  // Google does not accept `Person` as item type for the publisher property
+  const publisher = Object.assign({}, author, {'@type': 'Organization'});
+  let schema = {};
+
+  if (authorImage) {
+    author.image = authorImage;
+    publisher.image = authorImage;
+    publisher.logo = {
+      '@type': 'ImageObject',
+      url: authorImage
+    };
+  }
+
+  if (this.is_post()) {
+    schema = {
+      '@context': 'https://schema.org',
+      '@type': 'BlogPosting',
+      author: author,
+      // articleBody: this.strip_html(page.content),
+      dateCreated: page.date.format(),
+      dateModified: page.updated.format(),
+      datePublished: page.date.format(),
+      description: this.strip_html(page.excerpt),
+      headline: page.title,
+      mainEntityOfPage: {
+        '@type': 'WebPage',
+        '@id': this.url_for(page.permalink)
+      },
+      publisher,
+      url: this.url_for(page.permalink)
+    };
+
+    if (page.tags && page.tags.length > 0) {
+      schema.keywords = page.tags.map((tag) => tag.name).join(', ');
+    }
+
+    let images = [];
+    if (page.photos && page.photos.length > 0) {
+      images = images.concat(page.photos);
+    }
+
+    if (page.cover?.length > 0) {
+      images = images.unshift(page.cover);
+    } else if (page.banner?.length > 0) {
+      images = images.unshift(page.banner);
+    }
+
+    schema.thumbnailUrl = page.cover || page.banner;
+    schema.image = images;
+  
+  } else if (this.is_page() || this.is_home()) {
+    
+    const url = this.is_home() ? config.url : this.url_for(page.permalink);
+    schema = {
+      '@context': 'https://schema.org',
+      '@type': 'Website',
+      '@id': url,
+      author: author,
+      name: page.title || config.title,
+      description: config.description,
+      url: url
+    };
+
+    if (config.keywords && config.keywords.length) {
+      if (Array.isArray(args)) {
+        schema.keywords = config.keywords.join(', ');
+      } else {
+        schema.keywords = config.keywords;
+      }
+    }
+    if (!this.is_home()) {
+
+      if (page.excerpt || page.description) {
+        schema.description = this.strip_html(page.description || page.excerpt);
+      } else {
+        schema.description = util.truncate(this.strip_html(page.content), {length: 200});
+      }
+
+    }
+    
+  } else {
+    
+    // default to WebPage for other layouts
+    schema = {
+      '@context': 'https://schema.org',
+      '@type': 'Website',
+      '@id': config.url,
+      author: author,
+      name: config.title,
+      description: config.description,
+      url: config.url
+    };
+    
+  }
+
+  return `<script type="application/ld+json">${JSON.stringify(schema)}</script>`;
+});

package/scripts/tags/lib/albums.js

@@ -9,6 +9,7 @@
 
 module.exports = ctx => function(args) {
   var args = ctx.args.map(args, ['repo', 'api', 'size'], ['group'])
+  const host = ctx.theme.config.api_host.ghraw
   if (args.size == null) {
     args.size = 's'
   }
@@ -16,7 +17,7 @@ module.exports = ctx => function(args) {
   if (args.api) {
     api = args.api
   } else if (args.repo) {
-    api = 'https://api.vlts.cc/output_data/v2/' + args.repo
+    api = `https://${host}/${args.repo}/output/v2/data.json`
   }
   
   var el = ''

package/scripts/tags/lib/friends.js

@@ -9,11 +9,12 @@
 
 module.exports = ctx => function(args) {
   args = ctx.args.map(args, ['repo', 'api', 'posts'], ['group'])
+  const host = ctx.theme.config.api_host.ghraw
   var api
   if (args.api) {
     api = args.api
   } else if (args.repo) {
-    api = 'https://api.vlts.cc/output_data/v2/' + args.repo
+    api = `https://${host}/${args.repo}/output/v2/data.json`
   }
   
   var el = `<div class="tag-plugin ${args.posts ? 'users-posts-wrap' : 'users-wrap'}">`

package/scripts/tags/lib/ghcard.js

@@ -17,6 +17,7 @@ module.exports = ctx => function(args) {
   var params = ['show_owner', 'theme', 'title_color', 'text_color', 'icon_color', 'bg_color', 'hide_border', 'cache_seconds', 'locale']
   args = ctx.args.map(args, params, ['repo'])
   const path = args.repo
+  const host = ctx.theme.config.api_host.ghcard
   var el = ''
   el += '<div class="tag-plugin ghcard">'
   el += '<a class="ghcard" rel="external nofollow noopener noreferrer" href="https://github.com/' + path + '">'
@@ -24,10 +25,10 @@ module.exports = ctx => function(args) {
   if (path.includes('/')) {
     // is repo
     const ps = path.split('/')
-    url += 'https://github-readme-stats.xaoxuu.com/api/pin/?username=' + ps[0] + '&repo=' + ps[1]
+    url = `https://${host}/api/pin/?username=${ps[0]}&repo=${ps[1]}`
   } else {
     // is user
-    url += 'https://github-readme-stats.xaoxuu.com/api/?username=' + path
+    url = `https://${host}/api/?username=${path}`
   }
   url += '&' + ctx.args.joinURLParams(args, params)
   if (!url.includes('&show_owner=')) {

package/scripts/tags/lib/image.js

@@ -2,13 +2,13 @@
  * image.js v1 | https://github.com/xaoxuu/hexo-theme-stellar/
  * 格式与官方标签插件一致使用空格分隔，中括号内的是可选参数（中括号不需要写出来）
  *
- * {% image src [alt] [width:400px] [bg:#eee] [download:true/false/url] [fancybox:true/false/url] %}
+ * {% image src [alt] [width:400px] [bg:#eee] [download:true/false/url] [fancybox:true/false/url] [ratio] %}
  */
 
 'use strict'
 
 module.exports = ctx => function(args) {
-  args = ctx.args.map(args, ['width', 'height', 'bg', 'download', 'padding', 'fancybox'], ['src', 'alt'])
+  args = ctx.args.map(args, ['width', 'height', 'bg', 'download', 'padding', 'fancybox', 'ratio'], ['src', 'alt'])
   var style = ''
   if (args.width) {
     style += 'width:' + args.width + ';'
@@ -39,7 +39,7 @@ module.exports = ctx => function(args) {
 
   function img(src, alt, style) {
     let img = ''
-    img += '<img src="' + src + '"'
+    img += `<img src="${src}" data-src="${src}"`
     let a = '<a data-fancybox'
     if (alt) {
       img += ' alt="' + alt + '"'
@@ -48,9 +48,10 @@ module.exports = ctx => function(args) {
     if (fancybox && !fancyboxHref) {
       img += ` data-fancybox="${fancybox}"`
     }
-    if (style.length > 0) {
+    if (style.length > 0 && !args.ratio) {
       img += ' style="' + style + '"'
     }
+    img += `onerror="this.src=&quot;${ctx.theme.config.default.image_onerror}&quot;"`
     img += '/>'
 
     if (fancyboxHref) {
@@ -65,8 +66,8 @@ module.exports = ctx => function(args) {
   // wrap
   el += '<div class="tag-plugin image">'
   // bg
-  el += '<div class="image-bg"'
-  if (args.bg || args.padding) {
+  el += `<div class="image-bg"`
+  if (args.bg || args.padding || args.ratio || style) {
     el += ' style="'
     if (args.bg && args.bg.length > 0) {
       el += 'background:' + args.bg + ';'
@@ -74,6 +75,15 @@ module.exports = ctx => function(args) {
     if (args.padding) {
       el += 'padding:' + args.padding + ';'
     }
+    if (args.ratio) {
+      el += 'aspect-ratio:' + args.ratio + ';'
+      if (style) {
+        el += style
+      }
+    } else if (style) {
+      // 如果设置了图片宽度，但没有长宽比，那背景区就要铺满宽度
+      el += 'width:100%;'
+    }
     el += '"'
   }
   el += '>'

package/scripts/tags/lib/posters.js

@@ -9,6 +9,7 @@
 
 module.exports = ctx => function(args) {
   var args = ctx.args.map(args, ['repo', 'api', 'size'], ['group'])
+  const host = ctx.theme.config.api_host.ghraw
   if (args.size == null) {
     args.size = 'm'
   }
@@ -16,7 +17,7 @@ module.exports = ctx => function(args) {
   if (args.api) {
     api = args.api
   } else if (args.repo) {
-    api = 'https://api.vlts.cc/output_data/v2/' + args.repo
+    api = `https://${host}/${args.repo}/output/v2/data.json`
   }
   
   var el = ''

package/scripts/tags/lib/sites.js

@@ -9,11 +9,12 @@
 
 module.exports = ctx => function(args) {
   args = ctx.args.map(args, ['repo', 'api'], ['group'])
+  const host = ctx.theme.config.api_host.ghraw
   var api
   if (args.api) {
     api = args.api
   } else if (args.repo) {
-    api = 'https://api.vlts.cc/output_data/v2/' + args.repo
+    api = `https://${host}/${args.repo}/output/v2/data.json`
   }
   
   var el = '<div class="tag-plugin sites-wrap">'

package/scripts/tags/lib/timeline.js

@@ -18,7 +18,7 @@ function layoutNodeTitle(ctx, content) {
   var el = ''
   el += '<div class="header">'
   if (content && content.length > 0) {
-    el += content
+    el += `<span>${content}</span>`
   }
   el += '</div>'
   return el

package/scripts/tags/lib/video.js

@@ -14,7 +14,7 @@ module.exports = ctx => function (args) {
     args.width = '100%'
   }
   if (args.bilibili) {
-    return `<div class="tag-plugin video" style="aspect-ratio:${args.ratio || 16 / 9};max-width:${args.width};">
+    return `<div class="tag-plugin video-player" style="aspect-ratio:${args.ratio || 16 / 9};max-width:${args.width};">
     <iframe src="https://player.bilibili.com/player.html?bvid=${args.bilibili}&autoplay=${args.autoplay || 'false'}" scrolling="no" border="0" frameborder="no" framespacing="0" allowfullscreen="true">
     </iframe>
     </div>
@@ -26,14 +26,14 @@ module.exports = ctx => function (args) {
     } else {
       args.autoplay = '0'
     }
-    return `<div class="tag-plugin video" style="aspect-ratio:${args.ratio || 16 / 9};max-width:${args.width};">
+    return `<div class="tag-plugin video-player" style="aspect-ratio:${args.ratio || 16 / 9};max-width:${args.width};">
     <iframe style="border:none" src="https://www.youtube.com/embed/${args.youtube}?rel=0&disablekb=1&playsinline=1&autoplay=${args.autoplay}" picture-in-picture="true" allowfullscreen="true" >
     </iframe>
     </div>
     `
   }
-  return `<div class="tag-plugin video" style="max-width:${args.width};">
-  <video controls preload>
+  return `<div class="tag-plugin video-player" style="max-width:${args.width};">
+  <video controls preload playsinline webkit-playsinline>
   <source src="${args.src}" type="${args.type || 'video/mp4'}">Your browser does not support the video tag.
   </video>
   </div>

package/source/css/_common/base.styl

@@ -23,7 +23,6 @@ hr
 img
   max-width: 100%
 
-
 li
   font-size: 'calc(%s - 1px)' % var(--fsp)
 
@@ -46,7 +45,7 @@ table:not([class])
     background: var(--block)
   td,th
     padding: 0.5em 1em
-    border: 1px solid var(--block-hover)
+    border: 1px solid var(--block-border)
     line-height: 1.5
   tr
     word-break: keep-all

package/source/css/_common/canonical.styl

@@ -0,0 +1,32 @@
+.canonical-tip
+  position: fixed
+  text-align: center
+  bottom: 4rem
+  left: 50%
+  transform: translateX(-50%)
+  max-width: 90%
+  background-color: var(--block-border)
+  color: var(--text-p1)
+  font-size: 1rem
+  font-family: #fff8e1
+  z-index: 9999999
+  box-shadow: 0 2px 8px rgba(black, .1), 0 4px 16px rgba(black, .1), 0 8px 32px rgba(black, .1)
+  border-radius: 6px
+  .headline
+    font-size: $fsh2
+  a
+    display: block
+    color: inherit
+    padding: 1rem 2rem
+
+.canonical-tip.unofficial
+  background-color: hsl(5, 100%, 60%)
+  color: white
+  animation: breathe 3s ease-in-out infinite
+  @keyframes breathe
+    0%
+      background-color: hsl(5, 100%, 60%)
+    50%
+      background-color: hsl(5, 100%, 30%)
+    100%
+      background-color: hsl(5, 100%, 60%)

package/source/css/_common/device.styl

@@ -10,14 +10,13 @@
 .float-panel
   position: sticky
   grid-column-end: span 3
-  padding: 4px
   --inset: 2rem
   right: 0
   bottom: calc(var(--inset) * 2)
   margin-left: auto
   margin-right: var(--inset)
   float: right
-  z-index: 10
+  z-index: 999999
   display: flex
   justify-content: center
   flex-direction: column
@@ -26,6 +25,9 @@
     margin-right: 3rem
   overflow: hidden
   trans1: all
+  &:before,&:after
+    border-radius: 64px
+
   newblur()
 
 
@@ -34,8 +36,8 @@
   cursor: pointer
   color: var(--text)
   background: none
-  width: 40px
-  height: 40px
+  width: 48px
+  height: 48px
   line-height: 0
   font-size: 28px
   margin: 0

package/source/css/_common/highlight.styl

@@ -36,7 +36,7 @@ p>code:not([class]),li>code:not([class])
       display: block
       border-bottom-left-radius: $border-button
       border-bottom-right-radius: $border-button
-      background: var(--block-hover)
+      background: var(--block-border)
   >table
     overflow: auto
     display: block

package/source/css/_components/layout.styl

@@ -1,7 +1,9 @@
 .l_body
   display: grid
   grid-template-columns: 1fr minmax(200px,var(--width-main)) 1fr
-  grid-gap: var(--gap-margin)
+  grid-gap: calc(var(--gap-margin) * 4)
+  @media screen and (max-width: $device-desktop)
+    grid-gap: calc(var(--gap-margin) * 2)
   margin: auto
   font-size: var(--fsp)
 
@@ -16,11 +18,10 @@
 
 .l_body .l_left
   justify-self: right
-  top: 8px
+  top: calc(var(--gap-margin) * 2)
 .l_body .l_right
   justify-self: left
-  --gap-margin: 0px
-  max-height: calc(100% - 8px * 2)
+  max-height: calc(100% - calc(var(--gap-margin) * 2) * 2)
   .widgets
     height: 100%
     overflow visible
@@ -32,16 +33,16 @@
   .laptop-only
     display: block !important
   .l_body
+    grid-gap: calc(var(--gap-margin) * 1)
     .l_right
-      top: 8px
       position: fixed
       transform: translateX(320px)
       transition: transform .38s ease-out
       margin: 0
       --inset: 8px
       right: var(--inset)
-      top: var(--inset)
-      max-height: 'calc(%s - %s)' % (100vh $rightbar-bottom-margin)
+      top: calc(var(--gap-margin) * 2)
+      max-height: 'calc(%s - %s * 2 - %s)' % (100vh var(--gap-margin) $rightbar-bottom-margin)
       box-shadow: $boxshadow-card-float
       z-index: 10
       background: var(--site-bg)
@@ -70,11 +71,11 @@
       margin: 0
       --inset: 8px
       left: var(--inset)
-      top: var(--inset)
-      max-height: 'calc(%s - %s)' % (100vh $leftbar-bottom-margin)
+      top: calc(var(--gap-margin) * 2)
+      max-height: 'calc(%s - %s * 2 - %s)' % (100vh var(--gap-margin) $leftbar-bottom-margin)
       .leftbar-container
         --inset: 8px
-        height: 'calc(%s - %s)' % (100vh $leftbar-bottom-margin)
+        height: 'calc(%s - %s * 2 - %s)' % (100vh var(--gap-margin) $leftbar-bottom-margin)
       box-shadow: $boxshadow-card-float
       z-index: 10
     .l_main

package/source/css/_components/list.styl

@@ -120,13 +120,16 @@
       right: 0
       height: var(--blur-height)
       backdrop-filter: saturate(var(--blur-sat)) blur(var(--blur-px))
+      -webkit-backdrop-filter: saturate(var(--blur-sat)) blur(var(--blur-px))
       trans1 all
     &[position=top]:before
       top: 0
       mask: linear-gradient(black, rgba(black, 0.75), transparent)
+      -webkit-mask: linear-gradient(black, rgba(black, 0.75), transparent)
     &[position=bottom]:before
       bottom: 0
       mask: linear-gradient(transparent, rgba(black, 0.75), black)
+      -webkit-mask: linear-gradient(transparent, rgba(black, 0.75), black)
     .cover-info
       padding: 1.5rem 1rem
       position: absolute

package/source/css/_components/main.styl

@@ -2,7 +2,7 @@
   position: relative
   padding-bottom: var(--gap-max)
   @media screen and (min-width: $device-mobile-max)
-    padding-top: 8px
+    padding-top: calc(var(--gap-margin) * 2)
   header
     margin: 2rem 1rem 1rem
     .logo-wrap

package/source/css/_components/md.styl

@@ -24,7 +24,7 @@
   ul:not(:last-child),
   ol:not(:last-child)
     padding-bottom: .5rem
-    margin: 0
+    margin: 0 .25rem
   blockquote,ul,ol
     p,ul,ol
       --fsp: $fsp1
@@ -75,9 +75,11 @@
 
 // 图片样式
 .md-text img
-  border-radius: $border-image
   margin: auto
   display: block
+.md-text.content 
+  p>img, .tag-plugin.image .image-bg
+    border-radius: $border-image
 
 // 链接样式
 li:not([class]) a:not([class])

package/source/css/_components/pages/archives.styl

@@ -67,7 +67,7 @@
       opacity: .5
       font-size: $fs-12
     &:hover
-      background: var(--block-hover)
+      background: var(--block-border)
       color: var(--text)
       .badge
         opacity: 1
@@ -99,7 +99,7 @@
         color $color-theme
         opacity: 1
       color: var(--text)
-      background: var(--block-hover)
+      background: var(--block-border)
 
 @media screen and (min-width: $device-mobile)
   .post-list.author #archive

package/source/css/_components/pages/article-story.styl

@@ -1,5 +1,9 @@
 .l_body[type=story] .md-text.content
   --fsp: 'calc(%s + 1px)' % $fs-body
+  --gap-p: 2rem
+  div.tag-plugin,p>img
+    margin-top: 2.4rem
+    margin-bottom: 2.4rem
   // 段落标题
   h1,h2,h3,h4,h5,h6
     color: var(--text)
@@ -116,6 +120,8 @@
       text-indent: 0
       text-align: convert(hexo-config('style.text-align'))
 
+  p>img, .tag-plugin.image .image-bg
+    border-radius: $border-image-l
 
 
 .l_body[type=story] .article.banner .content .bottom.only-title

package/source/css/_components/pages/article-tech.styl

@@ -1,4 +1,4 @@
-.l_body[type='tech'] .md-text
+.l_body[type='tech'] article.content
   h1,h2,h3,h4,h5,h6
     color: var(--text)
     line-height: 1.8

package/source/css/_components/pages/notebook.styl

@@ -24,7 +24,7 @@
         color $color-theme
         opacity: 1
       color: var(--text)
-      background: var(--block-hover)
+      background: var(--block-border)
 
 .post-list .post-card .meta.cap .tag
   &:before