hexo-theme-stellar 1.22.1 → 1.24.0

package/layout/archive.ejs

@@ -3,41 +3,58 @@ page.robots = 'noindex,follow';
 if (page.menu_id == undefined) {
   page.menu_id = 'post';
 }
+if (page.author) {
+  page.header = 'auto';
+}
+function layoutArchiveList() {
+  var el = ''
+  if (page.author) {
+    page.title = page.author.name
+    el += partial('_partial/main/navbar/author_banner')
+  } else {
+    page.title = __('btn.archives')
+    el += partial('_partial/main/navbar/list_post')
+  }
+  el += `<div class="post-list archives">`
+  var years = []
+  site.posts.sort('date', -1).each(function(post) {
+  	post.year = date(post.date, 'YYYY')
+  	  if (post.year && (years.includes(post.year) == false) && (post.title || post.date)) {
+  		  years.push(post.year)
+    }
+  })
+  for (let year of years) {
+    el += `<article class="${scrollreveal()}" id="archive">`
+  	el += `<div class='archive-header h4'>${year}</div>`
+    site.posts.sort('date', -1).filter(function (post) {
+      post.year = date(post.date, 'YYYY')
+      return post.year == year
+    }).each(function(post) {
+      el += `<div class="archive-list">`
+      el +=`<a class='post fs14' href="${url_for(post.link || post.path)}">`
+      el += `<time>${date(post.date, 'MM-DD')}</time>`
+      el += `<span>`
+      if (post.title) {
+        el += post.title
+      } else if (post.date) {
+        el += date(post.date, config.date_format)
+      }
+      el += `</span>`
+      el += `</a>`
+      el += `</div>`
+    })
+  	el += `</article>`
+  }
+  el += `</div>`
+  return el
+}
+function layoutDiv() {
+  if (page.posts && (is_category() || is_tag())) {
+    return partial('index')
+  } else {
+    return layoutArchiveList()
+  }
+}
 %>
-<% if (page.posts && (is_category() || is_tag())) { %>
-  <%- partial('index') %>
-<% } else { %>
-  <% page.title = __('btn.archives'); %>
-  <%- partial('_partial/main/navbar/list_post') %>
-  <div class='post-list'>
-  	<% var years = []; %>
-  	<% site.posts.sort('date', -1).each(function(post) { %>
-  		<% post.year = date(post.date, 'YYYY'); %>
-  		<% if (post.year && (years.includes(post.year) == false) && (post.title || post.date)) { %>
-  			<% years.push(post.year); %>
-  		<% } %>
-  	<% }); %>
-  	<% years.forEach((year, i) => { %>
-  		<article class='<%- scrollreveal() %>' id='archive'>
-  			<div class='archive-header h4'><%= year %></div>
-  			<% site.posts.sort('date', -1).filter(function (post) { %>
-  				<% post.year = date(post.date, 'YYYY'); %>
-  		    <% return post.year == year; %>
-  		  <% }).each(function(post) { %>
-  				<div class='archive-list'>
-            <a class='post fs14' href="<%= url_for(post.link || post.path) %>">
-    					<time><%= date(post.date, 'MM-DD') %></time>
-    					<span>
-                <% if (post.title) { %>
-      						<%- post.title %>
-      					<% } else if (post.date) { %>
-      						<%= date(post.date, config.date_format) %>
-      					<% } %>
-              </span>
-    				</a>
-          </div>
-  			<% }); %>
-  		</article>
-  	<% }); %>
-  </div>
-<% } %>
+ 
+<%- layoutDiv() %>

package/layout/page.ejs

@@ -1,6 +1,6 @@
 <%
 function layoutTitle() {
-  const title = page.h1 || page.title;
+  const title = page.h1 != null ? page.h1 : page.title;
   if (title && title.length > 0) {
     return '<h1 class="article-title"><span>' + title + '</span></h1>';
   } else {
@@ -12,9 +12,6 @@ function layoutDiv() {
   if (page.post_list) {
     el += partial('_partial/main/navbar/list_post');
   }
-  if (page.mermaid == true) {
-    el += partial('mermaid');
-  }
   if (page.h1 || page.title || (page.content && page.content.length > 0)) {
     el += partial('_partial/main/navbar/breadcrumb');
   }

package/layout/post.ejs

@@ -6,7 +6,7 @@ if (page.header == undefined) {
   page.header = 'auto';
 }
 function layoutTitle() {
-  const title = page.h1 || page.title;
+  const title = page.h1 != null ? page.h1 : page.title;
   if (title && title.length > 0) {
     return '<h1 class="article-title"><span>' + title + '</span></h1>';
   } else {
@@ -19,12 +19,6 @@ if (theme.plugins.heti && theme.plugins.heti.enable) {
   heti = ' heti';
 }
 %>
-<% if (page.mathjax == true){ %>
-    <%- partial('mathjax') %>
-<% } %>
-<% if (page.mermaid == true){ %>
-  <%- partial('mermaid') %>
-<% } %>
 <%- partial('_partial/main/navbar/breadcrumb') %>
 <article class='md-text content<%- heti %> <%- post.layout %><%- post.indent ? ' indent' : '' %><%- scrollreveal() %>'>
 <%- layoutTitle() %>

package/layout/wiki.ejs

@@ -13,7 +13,7 @@ if (page.title == undefined) {
   }
 }
 function layoutTitle() {
-  const title = page.h1 || page.title;
+  const title = page.h1 != null ? page.h1 : page.title;
   if (title && title.length > 0) {
     return '<h1 class="article-title"><span>' + title + '</span></h1>';
   } else {
@@ -29,9 +29,6 @@ function layoutTitle() {
     page.header = 'auto';
   }
   %>
-  <% if (page.mermaid == true){ %>
-    <%- partial('mermaid') %>
-  <% } %>
   <%- partial('_partial/main/navbar/breadcrumb') %>
   <article class='md-text content <%- page.layout %><%- page.indent ? ' indent' : '' %><%- scrollreveal() %>'>
   <%- layoutTitle() %>

package/package.json

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

package/scripts/events/index.js

@@ -5,6 +5,8 @@
 hexo.on('generateBefore', () => {
   // Merge config.
   require('./lib/config')(hexo);
+  require('./lib/links')(hexo);
+  require('./lib/authors')(hexo);
   require('./lib/doc_tree')(hexo);
   require('./lib/utils')(hexo);
 });

package/scripts/events/lib/authors.js

@@ -0,0 +1,21 @@
+/**
+ * authors.js v2 | https://github.com/xaoxuu/hexo-theme-stellar/
+ */
+
+'use strict';
+
+module.exports = ctx => {
+  var authors = ctx.locals.get('data').authors || {}
+  let basePath = ctx.config.author_dir || 'author'
+  // url
+  for (let key of Object.keys(authors)) {
+    let author = authors[key]
+    author.path = `${basePath}/${key}/index.html`
+  }
+  // default author
+  const keys = Object.keys(authors)
+  if (keys.length > 0) {
+    ctx.theme.config.default_author = authors[keys[0]]
+  }
+  ctx.theme.config.authors = authors
+}

package/scripts/events/lib/doc_tree.js

@@ -59,7 +59,7 @@ module.exports = ctx => {
   const wiki_pages = pages.filter(p => (p.layout === 'wiki')).map(p => new WikiPage(p))
   const wiki_list = Object.keys(wiki.tree)
   // 上架的项目列表
-  wiki.shelf = ctx.locals.get('data').wiki
+  wiki.shelf = ctx.locals.get('data').wiki || []
   
   // 数据整合：项目标签
   var all_tag_name = []
@@ -202,7 +202,6 @@ module.exports = ctx => {
 
   wiki.all_tags = all_tags
   wiki.all_pages = wiki_pages
-  wiki.shelf = ctx.locals.get('data').wiki
   ctx.theme.config.wiki = wiki
 
 }

package/scripts/events/lib/links.js

@@ -0,0 +1,17 @@
+/**
+ * links.js v1 | https://github.com/xaoxuu/hexo-theme-stellar/
+ */
+
+'use strict';
+
+module.exports = ctx => {
+  var allLinks = {}
+  const data = ctx.locals.get('data')
+  for (let key of Object.keys(data)) {
+    if (key.startsWith('links/')) {
+      let newKey = key.replace('links/', '')
+      allLinks[newKey] = data[key]
+    }
+  }
+  ctx.theme.config.links = allLinks
+}

package/scripts/generators/author.js

@@ -0,0 +1,22 @@
+/**
+ * author v1 | https://github.com/xaoxuu/hexo-theme-stellar/
+ */
+
+hexo.extend.generator.register('author', function (locals) {
+  const { authors } = hexo.theme.config
+  var pages = []
+  for (let key of Object.keys(authors)) {
+    const author = authors[key]
+    if (author.hidden) {
+      continue
+    }
+    pages.push({
+      path: author.path,
+      layout: ['archive'],
+      data: {
+        'author': author
+      }
+    })
+  }
+  return pages
+});

package/scripts/tags/index.js

@@ -16,10 +16,13 @@ hexo.extend.tag.register('banner', require('./lib/banner')(hexo), true)
 // data
 hexo.extend.tag.register('users', require('./lib/friends')(hexo))
 hexo.extend.tag.register('friends', require('./lib/friends')(hexo))
+hexo.extend.tag.register('albums', require('./lib/albums')(hexo))
+hexo.extend.tag.register('posters', require('./lib/posters')(hexo))
 hexo.extend.tag.register('sites', require('./lib/sites')(hexo))
 hexo.extend.tag.register('ghcard', require('./lib/ghcard')(hexo))
 hexo.extend.tag.register('toc', require('./lib/toc')(hexo))
 hexo.extend.tag.register('timeline', require('./lib/timeline')(hexo), {ends: true})
+hexo.extend.tag.register('md', require('./lib/md')(hexo))
 
 // express
 hexo.extend.tag.register('checkbox', require('./lib/checkbox')(hexo, 'checkbox'))
@@ -36,4 +39,6 @@ hexo.extend.tag.register('poetry', require('./lib/poetry')(hexo), true)
 hexo.extend.tag.register('quot', require('./lib/quot')(hexo))
 hexo.extend.tag.register('hashtag', require('./lib/hashtag')(hexo))
 hexo.extend.tag.register('okr', require('./lib/okr')(hexo), {ends: true})
+hexo.extend.tag.register('audio', require('./lib/audio')(hexo))
+hexo.extend.tag.register('video', require('./lib/video')(hexo))
 // others

package/scripts/tags/lib/albums.js

@@ -0,0 +1,47 @@
+/**
+ * albums.js v1 | https://github.com/xaoxuu/hexo-theme-stellar/
+ * 格式与官方标签插件一致使用空格分隔，中括号内的是可选参数（中括号不需要写出来）
+ *
+ * {% albums [group] [repo:owner/repo] [api:http] [size:s/m/l/xl/mix] %}
+ */
+
+'use strict'
+
+module.exports = ctx => function(args) {
+  var args = ctx.args.map(args, ['repo', 'api', 'size'], ['group'])
+  if (args.size == null) {
+    args.size = 's'
+  }
+  var api
+  if (args.api) {
+    api = args.api
+  } else if (args.repo) {
+    api = 'https://api.vlts.cc/output_data/v2/' + args.repo
+  }
+  
+  var el = ''
+  el += `<div class="tag-plugin albums-wrap">`
+  if (api) {
+    el += `<div class="stellar-friends-api" api="${api}"><div class="tag-plugin gallery grid-box" layout="grid" ratio="square" ${ctx.args.joinTags(args, ['size']).join(' ')}></div></div>`
+  } else if (args.group) {
+    const links = ctx.theme.config.links || {}
+    el += `<div class="tag-plugin gallery grid-box" layout="grid" ratio="square" ${ctx.args.joinTags(args, ['size']).join(' ')}>`
+    for (let item of (links[args.group] || [])) {
+      if (item?.url) {
+        el += `<div class="grid-cell album-card">`
+        el += `<a class="card-link" target="_blank" rel="external nofollow noopener noreferrer" href="${item.url}">`
+        el += `<img src="${item.icon || item.avatar || ctx.theme.config.default.cover}" onerror="javascript:this.removeAttribute(&quot;data-src&quot;);this.src=&quot;${ctx.theme.config.default.cover}&quot;;"/>`
+        el += `<div class="image-meta">`
+        if (item.title) {
+          el += `<span class="image-caption">${item.title}</span>`
+        }
+        el += `</div>`
+        el += `</a>`
+        el += `</div>`
+      }
+    }
+    el += `</div>`
+  }
+  el += `</div>`
+  return el
+}

package/scripts/tags/lib/audio.js

@@ -0,0 +1,23 @@
+/**
+ * audio.js v1.0 | https://github.com/xaoxuu/hexo-theme-stellar/
+ * 格式与官方标签插件一致使用空格分隔，中括号内的是可选参数（中括号不需要写出来）
+ *
+ * {% audio src %}
+ *
+ */
+
+'use strict';
+
+module.exports = ctx => function(args) {
+  args = ctx.args.map(args, ['type'], ['src'])
+  if (args.type == null) {
+    args.type = 'audio/mp3'
+  }
+  return `
+  <div class="tag-plugin video">
+  <audio controls preload>
+  <source src="${args.src}" type="${args.type}">Your browser does not support the audio tag.
+  </audio>
+  </div>
+  `
+}

package/scripts/tags/lib/copy.js

@@ -12,7 +12,7 @@
 var copy_index = 0
 
 module.exports = ctx => function(args) {
-  args = ctx.args.map(args, ['width', 'git'], ['text'])
+  args = ctx.args.map(args, ['git', 'prefix'], ['text'])
   if (args == undefined || args.text == undefined) {
     return ''
   }
@@ -31,19 +31,17 @@ module.exports = ctx => function(args) {
   }
 
   const copy_id = 'copy_' + ++copy_index
+  const toast = ctx.theme.config.tag_plugins.copy.toast
 
-  var el = ''
-  el += '<div class="tag-plugin copy"'
-  if (args.width) {
-    el += ' width="' + args.width + '"'
+  var el = ``
+  el += `<div class="tag-plugin copy">`
+  if (args.prefix?.length > 0) {
+    el += `<span>${args.prefix}</span>`
   }
-  el += '>'
-  el += '<input class="copy-area" readonly id="' + copy_id + '"'
-  el += ' value="' + text + '">'
-  el += '<button class="copy-btn" onclick="util.copy(&quot;' + copy_id + '&quot;,&quot;Copied!&quot;)">'
-  el += '<svg class="icon copy-btn" viewBox="0 0 16 16" version="1.1" width="16" height="16" aria-hidden="true"><path fill-rule="evenodd" d="M5.75 1a.75.75 0 00-.75.75v3c0 .414.336.75.75.75h4.5a.75.75 0 00.75-.75v-3a.75.75 0 00-.75-.75h-4.5zm.75 3V2.5h3V4h-3zm-2.874-.467a.75.75 0 00-.752-1.298A1.75 1.75 0 002 3.75v9.5c0 .966.784 1.75 1.75 1.75h8.5A1.75 1.75 0 0014 13.25v-9.5a1.75 1.75 0 00-.874-1.515.75.75 0 10-.752 1.298.25.25 0 01.126.217v9.5a.25.25 0 01-.25.25h-8.5a.25.25 0 01-.25-.25v-9.5a.25.25 0 01.126-.217z"></path></svg>'
-  el += '</button>'
-
-  el += '</div>'
+  el += `<input class="copy-area" id="${copy_id}" value="${text}">`
+  el += `<button class="copy-btn" onclick="util.copy(&quot;${copy_id}&quot;,&quot;${toast}&quot;)">`
+  el += `<svg class="icon copy-btn" viewBox="0 0 16 16" version="1.1" width="16" height="16" aria-hidden="true"><path fill-rule="evenodd" d="M5.75 1a.75.75 0 00-.75.75v3c0 .414.336.75.75.75h4.5a.75.75 0 00.75-.75v-3a.75.75 0 00-.75-.75h-4.5zm.75 3V2.5h3V4h-3zm-2.874-.467a.75.75 0 00-.752-1.298A1.75 1.75 0 002 3.75v9.5c0 .966.784 1.75 1.75 1.75h8.5A1.75 1.75 0 0014 13.25v-9.5a1.75 1.75 0 00-.874-1.515.75.75 0 10-.752 1.298.25.25 0 01.126.217v9.5a.25.25 0 01-.25.25h-8.5a.25.25 0 01-.25-.25v-9.5a.25.25 0 01.126-.217z"></path></svg>`
+  el += `</button>`
+  el += `</div>`
   return el
 }

package/scripts/tags/lib/friends.js

@@ -9,10 +9,6 @@
 
 module.exports = ctx => function(args) {
   args = ctx.args.map(args, ['repo', 'api'], ['group'])
-  var links = ctx.locals.get('data').links
-  if (links == undefined) {
-    links = {}
-  }
   var api
   if (args.api) {
     api = args.api
@@ -22,29 +18,22 @@ module.exports = ctx => function(args) {
   
   var el = '<div class="tag-plugin users-wrap">'
   if (api) {
-    el += '<div class="stellar-friends-api"'
-    el += ' api="' + api + '"'
-    el += '>'
-    el += '<div class="group-body"></div>'
-    el += '</div>'
+    el += `<div class="stellar-friends-api" ${ctx.args.joinTags(args, ['size']).join(' ')} api="${api}"><div class="grid-box"></div></div>`
   } else if (args.group) {
-    function cell(item) {
-      if (item.url && item.title) {
-        var cell = '<div class="user-card">'
-        cell += '<a class="card-link" target="_blank" rel="external nofollow noopener noreferrer" href="' + item.url + '">'
-        cell += '<img src="' + (item.avatar || ctx.theme.config.default.avatar) + '" onerror="javascript:this.removeAttribute(&quotdata-src&quot)this.src=&quot' + ctx.theme.config.default.avatar + '&quot"/>'
-        cell += '<div class="name"><span>' + item.title + '</span></div>'
-        cell += '</a></div>'
-        return cell
-      } else {
-        return ''
+    const links = ctx.theme.config.links || {}
+    el += '<div class="grid-box">'
+    for (let item of (links[args.group] || [])) {
+      if (item?.url && item?.title) {
+        el += `<div class="grid-cell user-card">`
+        el += `<a class="card-link" target="_blank" rel="external nofollow noopener noreferrer" href="${item.url}">`
+        el += `<img src="${item.icon || item.avatar || ctx.theme.config.default.avatar}" onerror="javascript:this.removeAttribute(&quot;data-src&quot;);this.src=&quot;${ctx.theme.config.default.avatar}&quot;;"/>`
+        el += `<div class="name">`
+        el += `<span>${item.title}</span>`
+        el += `</div>`
+        el += `</a>`
+        el += `</div>`
       }
     }
-    el += '<div class="group-body">'
-    const items = links[args.group] || []
-    items.forEach((item, i) => {
-      el += cell(item)
-    })
     el += '</div>'
   }
   

package/scripts/tags/lib/gallery.js

@@ -33,9 +33,6 @@ function img(src, alt) {
 
 module.exports = ctx => function(args, content) {
   args = ctx.args.map(args, ['layout', 'size', 'ratio'])
-  if (args.layout == null) {
-    args.layout = ctx.theme.config.tag_plugins.gallery.layout
-  }
   if (args.size == null) {
     args.size = ctx.theme.config.tag_plugins.gallery.size
   }
@@ -43,14 +40,18 @@ module.exports = ctx => function(args, content) {
     args.ratio = ctx.theme.config.tag_plugins.gallery.ratio
   }
   var el = ''
-  el += `<div class="tag-plugin gallery" ${ctx.args.joinTags(args, ['layout', 'size', 'ratio']).join(' ')}>`
+  var layoutType = 'grid'
+  if (args.layout == 'flow') {
+    layoutType = 'flow'
+  }
+  el += `<div class="tag-plugin gallery fancybox ${layoutType}-box" ${ctx.args.joinTags(args, ['size', 'ratio']).join(' ')}>`
   const img_mds = content.split('\n').filter(item => item.trim().length > 0)
   for (let md of img_mds) {
     const matches = md.match(/\!\[(.*?)\]\((.*?)\)/i)
     if (matches?.length > 2) {
       let alt = matches[1]
       let src = matches[2]
-      el += `<div class="cell">${img(src, alt)}</div>`
+      el += `<div class="${layoutType}-cell">${img(src, alt)}</div>`
     }
   }
   el += `</div>`

package/scripts/tags/lib/grid.js

@@ -2,10 +2,10 @@
  * grid.js v1.0 | https://github.com/xaoxuu/hexo-theme-stellar/
  * 格式与官方标签插件一致使用空格分隔，中括号内的是可选参数（中括号不需要写出来）
  *
- * {% grid [style:block/card] %}
- * <!-- cell left -->
+ * {% grid [bg:box/card] [w:240px] [c:2] [gap:16px] [br:12px] %}
+ * <!-- cell -->
  * left body
- * <!-- cell right -->
+ * <!-- cell -->
  * right body
  * {% endgrid %}
  */
@@ -13,37 +13,37 @@
 'use strict'
 
 module.exports = ctx => function(args, content) {
-  args = ctx.args.map(args, ['bg'])
+  args = ctx.args.map(args, ['bg', 'w', 'c', 'gap', 'br'])
+  if (args.w == null && args.c == null) {
+    args.w = '240px'
+  }
   var el = ''
   el += '<div class="tag-plugin grid"'
-  el += ' ' + ctx.args.joinTags(args, ['bg']).join(' ')
+  el += ' ' + ctx.args.joinTags(args, ['bg', 'columns']).join(' ')
+  el += ' style="'
+  if (args.w) {
+    el += `grid-template-columns: repeat(auto-fill, minmax(${args.w}, 1fr));`
+  } else if (args.c) {
+    el += `grid-template-columns: repeat(${args.c}, 1fr);`
+  }
+  if (args.gap) {
+    el += `grid-gap:${args.gap};`
+  }
+  el += '"'
   el += '>'
-  
-  var arr = content.split(/<!--\s*cell (.*?)\s*-->/g).filter(item => item.trim().length > 0)
-  if (arr.length > 0) {
-    var nodes = []
-    arr.forEach((item, i) => {
-      if (i % 2 == 0) {
-        nodes.push({
-          header: item
-        })
-      } else if (nodes.length > 0) {
-        var node = nodes[nodes.length-1]
-        if (node.body == undefined) {
-          node.body = item
-        } else {
-          node.body += '\n' + item
-        }
-      }
-    })
-    nodes.forEach((node, i) => {
-      el += '<div class="cell" index="' + (i) + '">'
-      el += ctx.render.renderSync({text: (node.body || ''), engine: 'markdown'}).split('\n').join('')
-      el += '</div>'
-    })  
+  // 分组
+  var cells = content.split(/<!--\s*cell(.*?)-->/g).filter(item => item.trim().length > 0)
+  for (let cell of cells) {
+    el += `<div class="cell" style="`
+    if (args.br) {
+      el += `border-radius:${args.br};`
+    }
+    el += `">`
+    el += `
+    ${ctx.render.renderSync({text: (cell || ''), engine: 'markdown'}).split('\n').join('')}
+    </div>
+    `
   }
-
   el += '</div>'
-
   return el
 }

package/scripts/tags/lib/md.js

@@ -0,0 +1,20 @@
+/**
+ * md.js v1.0 | https://github.com/volantis-x/hexo-theme-volantis/
+ * contributor: @MHuiG
+ * 
+ * 格式与官方标签插件一致使用空格分隔，中括号内的是可选参数（中括号不需要写出来）
+ *
+ * {% md src %}
+ *
+ */
+'use strict'
+
+var md_index = 0
+
+module.exports = ctx => function(args) {
+  args = ctx.args.map(args, [''], ['src'])
+  const md_id = "md_" + ++md_index
+  return `
+  <div class="stellar-marked-api md-marked" src="${args.src}" id="${md_id}"></div>
+  `
+}

package/scripts/tags/lib/posters.js

@@ -0,0 +1,47 @@
+/**
+ * posters.js v1 | https://github.com/xaoxuu/hexo-theme-stellar/
+ * 格式与官方标签插件一致使用空格分隔，中括号内的是可选参数（中括号不需要写出来）
+ *
+ * {% posters [group] [repo:owner/repo] [api:http] [size:s/m/l/xl/mix] %}
+ */
+
+'use strict'
+
+module.exports = ctx => function(args) {
+  var args = ctx.args.map(args, ['repo', 'api', 'size'], ['group'])
+  if (args.size == null) {
+    args.size = 'm'
+  }
+  var api
+  if (args.api) {
+    api = args.api
+  } else if (args.repo) {
+    api = 'https://api.vlts.cc/output_data/v2/' + args.repo
+  }
+  
+  var el = ''
+  el += `<div class="tag-plugin posters-wrap">`
+  if (api) {
+    el += `<div class="stellar-friends-api" api="${api}"><div class="tag-plugin gallery grid-box" layout="grid" ratio="square" ${ctx.args.joinTags(args, ['size']).join(' ')}></div></div>`
+  } else if (args.group) {
+    const links = ctx.theme.config.links || {}
+    el += `<div class="tag-plugin gallery grid-box" layout="grid" ratio="portrait" ${ctx.args.joinTags(args, ['size']).join(' ')}>`
+    for (let item of (links[args.group] || [])) {
+      if (item?.url) {
+        el += `<div class="grid-cell poster-card">`
+        el += `<a class="card-link" target="_blank" rel="external nofollow noopener noreferrer" href="${item.url}">`
+        el += `<img src="${item.icon || item.avatar || ctx.theme.config.default.cover}" onerror="javascript:this.removeAttribute(&quot;data-src&quot;);this.src=&quot;${ctx.theme.config.default.cover}&quot;;"/>`
+        el += `<div class="image-meta">`
+        if (item.title) {
+          el += `<span class="image-caption">${item.title}</span>`
+        }
+        el += `</div>`
+        el += `</a>`
+        el += `</div>`
+      }
+    }
+    el += `</div>`
+  }
+  el += `</div>`
+  return el
+}