hexo-theme-stellar 1.44.0 → 2.0.0-rc.2

package/layout/_partial/main/notebook/notebook_card.ejs

@@ -1,10 +1,17 @@
 <%# 笔记本信息卡片 %>
+<% var listing = render.listing %>
 <article class="md-text">
-  <div class="preview"><img src="<%= notebook.icon || theme.default.project %>" alt="icon"/></div>
+  <div class="preview">
+    <% if (listing.icon) { %>
+      <img src="<%= listing.icon %>" alt="icon"/>
+    <% } else { %>
+      <%- icon('default:documents') %>
+    <% } %>
+  </div>
   <div class="excerpt">
-    <h2 class="post-title"><%= notebook.title || notebook.name %></h2>
-    <% if (notebook.description) { %>
-      <p><%= notebook.description %></p>
+    <h2 class="post-title"><%= listing.headline || listing.name %></h2>
+    <% if (listing.description) { %>
+      <p><%= listing.description %></p>
     <% } %>
   </div>
 </article>

package/layout/_partial/main/pin_slider.ejs

@@ -1,34 +1,31 @@
 <%
-// 置顶内容轮播：所有带 navbar top 的列表页上方共用。
+// 置顶内容轮播：所有带 Listing Nav 的列表页上方共用，关闭导航时仍独立渲染。
 // type: post / wiki / topic
 var pinType = type || 'post'
 var pinItems = []
 
 function pinValue(item) {
-  return item.pin != null ? item.pin : item.sticky
+  if (['post', 'topic'].includes(item?.collection?.profile)) return item.render.listing.priority
+  if (pinType == 'wiki' && item?.id && item?.href) return item.priority
+  return item.listing?.priority
 }
 
-// 只要设置了 pin（含 0、负数）即视为置顶，未设置 / false 不置顶
 function isPinned(item) {
-  var v = pinValue(item)
-  return v !== false && v != null
+  return pinValue(item) > 0
 }
 
-// 排序仅比较数值大小，true 视作 1
 function pinWeight(item) {
-  var v = pinValue(item)
-  if (v === true) {
-    return 1
-  }
-  var n = Number(v)
+  var n = Number(pinValue(item))
   return isNaN(n) ? 0 : n
 }
 
 if (pinType == 'wiki') {
-  var shelf = theme.wiki?.shelf || []
-  for (var wi = 0; wi < shelf.length; wi++) {
-    var wproj = theme.wiki.tree[shelf[wi]]
-    if (wproj != null && isPinned(wproj)) {
+  if (!Array.isArray(wikiItems)) {
+    throw new Error('Stellar v2: Wiki 置顶列表缺少显式 render.listing')
+  }
+  for (var wi = 0; wi < wikiItems.length; wi++) {
+    var wproj = wikiItems[wi]
+    if (wproj.listed && isPinned(wproj)) {
       pinItems.push(wproj)
     }
   }
@@ -36,11 +33,13 @@ if (pinType == 'wiki') {
   var allPosts = site.posts.toArray() || []
   for (var pi = 0; pi < allPosts.length; pi++) {
     var post = allPosts[pi]
-    if (post.indexing === false) {
-      continue
+    var viewModel = post_view_model(post)
+    if (!['post', 'topic'].includes(viewModel?.collection?.profile) || !viewModel.render?.listing) {
+      throw new Error(`Stellar v2: Post ${post?.source || post?.path || '<unknown>'} 缺少置顶列表 ViewModel`)
     }
-    if (isPinned(post)) {
-      pinItems.push(post)
+    if (!viewModel.render.listing.listed) continue
+    if (isPinned(viewModel)) {
+      pinItems.push(viewModel)
     }
   }
 }
@@ -50,20 +49,22 @@ pinItems.sort(function(a, b) {
 })
 
 // 文章幻灯片：固定「标题 + 一行小字」结构。
-// 标题：post.title；小字由 subtitle() helper 统一取值（subtitle > description > excerpt 前 50 字）。
+// 标题：post.title；小字由 caption() helper 统一取值。
 // 样式与 hero 卡片 cover-info 一致；无封面时为纯白卡片（文字按普通文章颜色）。
-function postSlide(post) {
-  var noCover = !(post.cover != null && post.cover.length > 0)
+function postSlide(viewModel) {
+  var post = viewModel.render.listing
+  var cover = post.cover
+  var noCover = !(cover != null && cover.length > 0)
   var headline = post.title
-  var sub = subtitle(post)
+  var sub = post.caption
   var el = ''
-  el += '<a class="pin-slide post-slide' + (noCover ? ' no-cover' : '') + '" href="' + escape_html(pretty_url(post.link || post.path)) + '"'
+  el += '<a class="pin-slide post-slide' + (noCover ? ' no-cover' : '') + '" href="' + escape_html(pretty_url(post.href)) + '"'
   if (!noCover) {
-    el += ' style="--pin-cover-url:url(\'' + escape_html(post.cover.replace(/'/g, '%27')) + '\')"'
+    el += ' style="--pin-cover-url:url(\'' + escape_html(cover.replace(/'/g, '%27')) + '\')"'
   }
   el += '>'
   if (!noCover) {
-    el += '<img class="pin-slide-bg" src="' + escape_html(post.cover) + '" alt=""/>'
+    el += '<img class="pin-slide-bg" src="' + escape_html(cover) + '" alt=""/>'
   }
   // 有封面时文字颜色自适应（大字 contrast、小字 theme）；无封面保持普通文章文字颜色
   el += '<div class="pin-slide-text"' + (noCover ? '' : ' data-text-adaptive="split"') + '>'
@@ -85,13 +86,19 @@ function projectChips(tags) {
 }
 
 function wikiSlide(proj) {
-  var img = proj.cover || proj.icon || theme.default.project
-  var title = proj.title || proj.name || proj.id
+  var img = proj.cover
+  var title = proj.headline || proj.name || proj.id
   var excerpt = proj.description || ''
   var el = ''
-  el += '<a class="pin-slide" href="' + escape_html(pretty_url(proj.homepage?.path || '/')) + '" style="--pin-cover-url:url(\'' + escape_html(img.replace(/'/g, '%27')) + '\')">'
-  el += '<img class="pin-slide-bg" src="' + escape_html(img) + '" alt=""/>'
-  el += '<div class="pin-slide-info" data-text-adaptive="split">'
+  el += '<a class="pin-slide' + (img ? '' : ' no-cover') + '" href="' + escape_html(pretty_url(proj.href || '/')) + '"'
+  if (img) {
+    el += ' style="--pin-cover-url:url(\'' + escape_html(img.replace(/'/g, '%27')) + '\')"'
+  }
+  el += '>'
+  if (img) {
+    el += '<img class="pin-slide-bg" src="' + escape_html(img) + '" alt=""/>'
+  }
+  el += '<div class="pin-slide-info"' + (img ? ' data-text-adaptive="split"' : '') + '>'
   el += '<div class="pin-slide-caps">' + projectChips(proj.tags) + '</div>'
   el += '<div class="pin-slide-title">' + escape_html(title) + '</div>'
   if (excerpt.length > 0) {
@@ -119,7 +126,7 @@ if (pinItems.length > 0) {
   var groupKey = pinType == 'wiki' ? 'wiki' : 'post'
   var sliderInterval = 5000 // 自动轮播间隔固定 5000ms
   var el = ''
-  el += '<div class="pin-slider card-hover card-hover--spotlight card-hover--tilt" id="pin-slider" data-interval="' + sliderInterval + '" data-key="' + pinType + '" data-group="' + groupKey + '">'
+  el += '<div class="' + ui_classes('pin-slider', 'hoverCard') + '" id="pin-slider" data-interval="' + sliderInterval + '" data-key="' + pinType + '" data-group="' + groupKey + '">'
   el += '<div class="pin-slider-track">'
   el += slidesHtml
   el += '</div>'
@@ -132,19 +139,17 @@ if (pinItems.length > 0) {
 %>
 <%- el %>
 <script>
-function initWhenReady() {
-  if (typeof stellar === 'object' && typeof stellar.initPlugin === 'function') {
-    stellar.initPlugin(initPinSlider, 'pin-slider');
-  } else {
-    // pin_slider 内联脚本渲染在 scripts/bootstrap 之前，等待 DOMContentLoaded 后注册
-    document.addEventListener('DOMContentLoaded', function () {
-      if (typeof stellar === 'object' && typeof stellar.initPlugin === 'function') {
-        stellar.initPlugin(initPinSlider, 'pin-slider');
-      }
-    });
+function mountPinSliderWhenReady() {
+  var cleanup = initPinSlider();
+  if (typeof cleanup === 'function') {
+    window.addEventListener('pagehide', cleanup, { once: true });
   }
 }
-initWhenReady();
+if (document.readyState === 'loading') {
+  document.addEventListener('DOMContentLoaded', mountPinSliderWhenReady, { once: true });
+} else {
+  mountPinSliderWhenReady();
+}
 function initPinSlider() {
   var slider = document.getElementById('pin-slider');
   if (!slider) return;

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

@@ -1,8 +1,12 @@
 <%
-var item = post || {};
-var href = pretty_url(item.link || item.path || '/');
-var itemDate = item.date ? date(item.date, 'MM-DD') : '';
-var itemTitle = item.title || (item.date ? date(item.date, config.date_format) : '');
+var postViewModel = typeof post === 'undefined' && typeof viewModel !== 'undefined' ? viewModel : null
+if (postViewModel && (!['post', 'topic'].includes(postViewModel.collection?.profile) || !postViewModel.render?.listing)) {
+  throw new Error('Stellar v2: 归档条目缺少合法 PageViewModel.render.listing')
+}
+var item = postViewModel ? postViewModel.render.listing : (typeof post !== 'undefined' ? post : {})
+var href = pretty_url(postViewModel ? (item.href || '/') : (item.link || item.path || '/'))
+var itemDate = item.date ? date(item.date, 'MM-DD') : ''
+var itemTitle = item.title || (item.date ? date(item.date, config.date_format) : '')
 %>
 <div class="archive-list">
   <a class="post fs14" href="<%- escape_html(href) %>">

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

@@ -4,12 +4,18 @@
 // 专栏列表页与未来首页等场景复用；无 post 时仅渲染 label。
 function layoutDiv() {
   var el = '';
-  var bg = background || theme.default.topic;
+  var bg = background || '';
   // 注意：不能用 `var href` 承接，var 提升会遮蔽 partial 传入的 href 参数
   var link = pretty_url(href || '/');
-  el += '<a class="cover card-hover card-hover--spotlight card-hover--tilt" position="bottom" style="--cover-url:url(\'' + escape_html(bg.replace(/'/g, '%27')) + '\')" href="' + link + '">';
-  el += '<img src="' + escape_html(bg) + '" alt=""/>';
-  el += '<div class="cover-info" position="bottom" data-text-adaptive="split">';
+  el += '<a class="' + ui_classes('cover', 'hoverCard', bg ? '' : 'no-cover') + '" position="bottom"';
+  if (bg) {
+    el += ' style="--cover-url:url(\'' + escape_html(bg.replace(/'/g, '%27')) + '\')"';
+  }
+  el += ' href="' + link + '">';
+  if (bg) {
+    el += '<img src="' + escape_html(bg) + '" alt=""/>';
+  }
+  el += '<div class="cover-info" position="bottom"' + (bg ? ' data-text-adaptive="split"' : '') + '>';
   if (typeof label !== 'undefined' && label) {
     el += '<div class="text topic">' + escape_html(label) + '</div>';
   }

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

@@ -1,103 +1,52 @@
 <%
-var obj = {
-  image: post.cover
-};
-function div_default() {
-  var el = '';
-  el += '<article class="md-text">';
+if (!viewModel || !['post', 'topic'].includes(viewModel.collection?.profile) || !viewModel.render?.listing) {
+  throw new Error('Stellar v2: Post 卡片缺少合法 PageViewModel.render.listing')
+}
+var listing = viewModel.render.listing
 
-  // 封面：仅当显式 cover 为完整 URL 时渲染（Unsplash 自动封面接口已失效，不再生成）
-  if (obj.image && obj.image.includes('/')) {
-    el += '<div class="post-cover">';
-    el += '<img src="' + escape_html(obj.image) + '"/>';
-    el += '</div>';
+function divDefault() {
+  var el = '<article class="md-text">'
+  if (listing.cover && listing.cover.includes('/')) {
+    el += `<div class="post-cover"><img src="${escape_html(listing.cover)}"/></div>`
   }
-
-  // 标题
-  el += '<h2 class="post-title">';
-  el += post.title ? escape_html(post.title) : date(post.date, config.date_format);
-  el += '</h2>';
-
-  // 摘要
-  el += '<div class="excerpt';
-  if (theme.plugins.heti?.enable) {
-    el += ' heti';
+  var title = listing.title || (listing.date ? date(listing.date, config.date_format) : '')
+  el += `<h2 class="post-title">${escape_html(title)}</h2>`
+  el += `<div class="excerpt${viewModel.render.article.heti ? ' heti' : ''}"><p>${escape_html(listing.excerpt)}</p></div>`
+  el += '<div class="meta cap"><span class="cap" id="post-meta">'
+  el += icon('default:calendar')
+  if (listing.date) {
+    el += `<time datetime="${date_xml(listing.date)}">${date(listing.date, config.date_format)}</time>`
   }
-  el += '">';
-  el += '<p>';
-  if (post.excerpt) {
-    el += escape_html(strip_html(post.excerpt));
-  } else if (post.description) {
-    el += escape_html(post.description);
-  } else if (post.content && theme.article.auto_excerpt > 0) {
-    el += escape_html(truncate(strip_html(post.content), {length: theme.article.auto_excerpt}));
+  el += '</span>'
+  if (listing.categories.length > 0) {
+    var categoryStyle = listing.categoryStyle ? ` style="${escape_html(listing.categoryStyle)}"` : ''
+    el += `<span class="cap breadcrumb"${categoryStyle}>${icon('default:category')}<span>${escape_html(listing.categories.join(' / '))}</span></span>`
   }
-  el += '</p>';
-  el += '</div>';
-
-  // meta
-  el += '<div class="meta cap">';
-  el += '<span class="cap" id="post-meta">';
-  el += icon('default:calendar')
-  // time
-  el += `<time datetime="${date_xml(post.date)}">${date(post.date, config.date_format)}</time>`
-  el += '</span>';
-  // cat
-  if (post.categories && post.categories.length > 0) {
-    if (post.layout === 'post' && post.categories && post.categories.length > 0) {
-      var cats = [];
-      if (post.categories) {
-        post.categories.forEach((cat, i) => {
-          cats.push(cat.name);
-        });
-      }
-      if (cats.length > 0) {
-        let str = cats.join(' / ');
-        let lastCat = cats.pop();
-        el += '<span class="cap breadcrumb"' + category_color(lastCat) + '>';
-        el += icon('default:category')
-        el += `<span>${escape_html(str)}</span>`
-        el += '</span>';
-      }
-    }
+  if (listing.tags.length > 0) {
+    el += '<span class="card-tags">'
+    listing.tags.forEach(function(tag) {
+      el += `<span class="cap tag-chip">${icon('default:hashtag')}${escape_html(tag)}</span>`
+    })
+    el += '</span>'
   }
-  // 置顶文章由轮播（默认）或首页列表靠前展示（flat 平铺）承担，卡片内不显示 pin 图标。
-  // 文章标签（最多 5 个，#580）
-  if (theme.article.card_tags && post.tags && post.tags.length > 0) {
-    el += '<span class="card-tags">';
-    post.tags.forEach((tag, i) => {
-      if (i >= 5) {
-        return;
-      }
-      el += `<span class="cap tag-chip">${icon('default:hashtag')}${escape_html(tag.name)}</span>`;
-    });
-    el += '</span>';
+  if (listing.priority > 0) {
+    el += `<span class="pin">${icon('default:pin')}</span>`
   }
-  el += '</div>';
-  el += '</article>';
-  return el;
+  return el + '</div></article>'
 }
-function div_photo() {
-  var el = '';
-  // 小字取值统一由 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) + '"/>';
-  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 divPhoto() {
+  var title = listing.title || (listing.date ? date(listing.date, config.date_format) : '')
+  var el = `<div class="cover" position="bottom" style="--cover-url:url('${escape_html(listing.cover.replace(/'/g, '%27'))}')">`
+  el += `<img src="${escape_html(listing.cover)}"/>`
+  el += '<div class="cover-info" position="bottom" data-text-adaptive="split">'
+  el += `<div class="text headline">${escape_html(title)}</div>`
+  if (listing.caption) el += `<div class="text caption">${escape_html(listing.caption)}</div>`
+  return el + '</div></div>'
 }
+
 function div() {
-  if (theme.article.card_style == 'hero' && obj.image && obj.image.length > 0) {
-    return div_photo();
-  }
-  return div_default();
+  return listing.cardStyle === 'hero' && listing.cover ? divPhoto() : divDefault()
 }
 %>
 <%- div() %>

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

@@ -1,9 +1,11 @@
 <%
 function layoutDiv() {
   var el = '';
-  var bg = topic.cover || topic.icon || theme.default.topic;
-  var label = topic.title || topic.name;
-  var latest = topic.homepage;
+  if (!viewModel?.render?.listing) throw new Error('Stellar v2: Topic 卡片缺少显式 render.listing')
+  var topic = viewModel.render.listing
+  var bg = topic.cover;
+  var label = topic.headline || topic.name;
+  var latest = topic.latest;
   el += '<article class="md-text">';
   // 专栏标题（story 文章 h2 样式，置于卡片外）
   el += '<h2 class="topic-title">' + escape_html(label) + '</h2>';
@@ -18,8 +20,8 @@ function layoutDiv() {
     post: latest
   });
   // 其他文章（排除最新，默认展示 3 条，剩余文章可展开）
-  if (topic.pages && topic.pages.length > 1) {
-    var otherPosts = topic.pages.slice(1);
+  if (topic.items && topic.items.length > 0) {
+    var otherPosts = topic.items;
     var visiblePosts = otherPosts.slice(0, 3);
     var hiddenPosts = otherPosts.slice(3);
     el += '<div class="topic-posts">';

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

@@ -1,10 +1,13 @@
 <%
 function layoutDiv() {
   var el = '';
-  var cover = proj.cover;
-  var projectIcon = proj.icon;
-  var caption = subtitle(proj);
-  var headline = proj.headline || proj.title || proj.name || '';
+  if (!listing || typeof listing !== 'object') {
+    throw new Error('Stellar v2: Wiki 卡片缺少显式 render.listing')
+  }
+  var cover = listing.cover;
+  var projectIcon = listing.icon;
+  var caption = listing.caption;
+  var headline = listing.headline || listing.name;
   el += '<article class="wiki-card-content">';
   el += '<div class="wiki-card-cover' + (cover ? '' : ' no-cover') + '" position="bottom"';
   if (cover) {
@@ -19,22 +22,22 @@ function layoutDiv() {
   }
   el += '>';
   el += '<div class="wiki-card-summary">';
-  if (proj.tags && proj.tags.length > 0) {
+  if (listing.tags && listing.tags.length > 0) {
     el += '<div class="wiki-tags wiki-meta">';
-    for (var i = 0; i < proj.tags.length; i++) {
-      var tag = proj.tags[i];
+    for (var i = 0; i < listing.tags.length; i++) {
+      var tag = listing.tags[i];
       el += '<span>' + escape_html(tag) + '</span>';
     }
     el += '</div>';
   }
   el += '<h2 class="headline">' + escape_html(headline) + '</h2>';
-  if (proj.available || proj.repo) {
+  if (listing.audience || listing.repository) {
     el += '<div class="wiki-meta">';
-    if (proj.available) {
-      el += '<span class="wiki-available">' + icon('default:platforms') + '<span class="label">' + escape_html(__('meta.available')) + '</span><span class="value">' + escape_html(proj.available) + '</span></span>';
+    if (listing.audience) {
+      el += '<span class="wiki-available">' + icon('default:platforms') + '<span class="label">' + escape_html(__('meta.available')) + '</span><span class="value">' + escape_html(listing.audience) + '</span></span>';
     }
-    if (proj.repo) {
-      el += '<span class="wiki-stars data-service ds-ghinfo" data-api="https://' + theme.api_host.ghapi + '/repos/' + escape_html(proj.repo) + '">';
+    if (listing.repository) {
+      el += '<span class="wiki-stars data-service ds-ghinfo" data-api="' + escape_html(listing.repositoryApi) + '">';
       el += icon('default:fire') + '<span type="text" id="stargazers_count"></span>';
       el += '</span>';
     }
@@ -49,7 +52,7 @@ function layoutDiv() {
     el += icon('default:documents');
   }
   el += '</div>';
-  el += '<div class="project-text"><div class="project-name">' + escape_html(proj.name || proj.title || '') + '</div>';
+  el += '<div class="project-text"><div class="project-name">' + escape_html(listing.name || '') + '</div>';
   if (caption.length > 0) {
     el += '<div class="project-subtitle">' + escape_html(caption) + '</div>';
   }

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()'>
+<div class="site-dock" role="group" aria-label="Layout panels">
+  <button type="button" class="<%- ui_classes('site-dock__button site-dock__button--rightbar', 'interactive') %>" aria-label="Open rightbar" aria-controls="rightbar-region" aria-expanded="false" data-shell-action="toggle-rightbar-drawer">
     <%- icon('default:rightbar', '', true) %>
   </button>
-  <button type='button' style='display:none' class='mobile-only leftbar-toggle mobile' onclick='sidebar.leftbar()'>
+  <button type="button" class="<%- ui_classes('site-dock__button site-dock__button--leftbar', 'interactive') %>" aria-label="Open leftbar" aria-controls="leftbar-region" aria-expanded="false" data-shell-action="toggle-leftbar-drawer">
     <%- icon('default:leftbar', '', true) %>
   </button>
 </div>

package/layout/_partial/primitives/item.ejs

@@ -0,0 +1,8 @@
+<%
+var allowedKinds = ['cover', 'brand', 'search', 'navigation', 'widget', 'content', 'footer', 'menu-button', 'scripts']
+if (!allowedKinds.includes(kind)) {
+  throw new Error('Stellar Layout Item: 未知 kind ' + kind)
+}
+var itemBody = typeof body === 'string' ? body : ''
+%>
+<%- itemBody %>

package/layout/_partial/primitives/navigation.ejs

@@ -0,0 +1,17 @@
+<%
+var allowedPlacements = ['main', 'leftbar', 'topbar', 'rightbar']
+if (!allowedPlacements.includes(placement)) {
+  throw new Error('Stellar Layout Navigation: 未知 placement ' + placement)
+}
+var navigationItems = Array.isArray(entries) ? entries : []
+var navigationBody = partial('_partial/components/collection', {options: {
+  layout: 'list',
+  variant: 'nav',
+  items: navigationItems
+}})
+var html = ''
+if ((navigationBody || '').trim().length > 0) {
+  html = `<nav class="menu dis-select${placement === 'main' ? ' mobile-hidden' : ''}">${navigationBody}</nav>`
+}
+%>
+<%- html %>

package/layout/_partial/primitives/region.ejs

@@ -0,0 +1,16 @@
+<%
+var allowedSlots = ['topbar', 'leftbar', 'rightbar']
+if (!allowedSlots.includes(slot)) {
+  throw new Error('Stellar Layout Region: 未知 slot ' + slot)
+}
+var regionBody = typeof body === 'string' ? body : ''
+var html = ''
+if (slot === 'topbar') {
+  html = `<header id="topbar-region" class="site-region site-region--topbar ui-surface" data-region="topbar"><div class="site-region__viewport">${regionBody}</div></header>`
+} else if (slot === 'leftbar') {
+  html = `<aside id="leftbar-region" class="site-region site-region--leftbar" data-region="leftbar" aria-label="Leftbar"><div class="site-region__surface ui-surface"><div class="site-region__decoration" aria-hidden="true"></div><div class="site-region__viewport">${regionBody}</div></div></aside>`
+} else if (slot === 'rightbar') {
+  html = `<aside id="rightbar-region" class="site-region site-region--rightbar" data-region="rightbar" aria-label="Rightbar"><div class="site-region__surface ui-drawer-surface"><div class="site-region__viewport">${regionBody}</div></div></aside>`
+}
+%>
+<%- html %>

package/layout/_partial/primitives/section.ejs

@@ -0,0 +1,8 @@
+<%
+var allowedSlots = ['cover', 'topbar', 'leftbar', 'rightbar', 'navigation', 'content', 'footer', 'scripts']
+if (!allowedSlots.includes(slot)) {
+  throw new Error('Stellar Layout Section: 未知 slot ' + slot)
+}
+var sectionItems = Array.isArray(items) ? items : []
+%>
+<%- sectionItems.join('') %>

package/layout/_partial/primitives/shell.ejs

@@ -0,0 +1,35 @@
+<%
+var shellDocument = documentModel || {}
+var shellPage = pageModel || {}
+var shellRegions = regions || {}
+var language = escape_html(shellDocument.language || 'zh-CN')
+var htmlAttributes = shellDocument.preferredTheme === 'auto' ? '' : ` data-theme="${escape_html(shellDocument.preferredTheme)}"`
+var presentRegions = ['topbar', 'leftbar', 'rightbar'].filter(function(region) {
+  return typeof shellRegions[region] === 'string' && shellRegions[region].trim().length > 0
+})
+var pageAttributes = ` data-page-type="${escape_html(shellPage.pageType || 'content')}"`
+pageAttributes += ` data-page-layout="${escape_html(shellPage.layout || '')}"`
+if (shellPage.articleStyle) pageAttributes += ` data-article-style="${escape_html(shellPage.articleStyle)}"`
+if (shellPage.indent) pageAttributes += ' data-text-indent'
+var html = '<!DOCTYPE html>'
+html += `<html lang="${language}"${htmlAttributes}>`
+html += head
+html += `<body${pageAttributes}>`
+html += bodyBegin || ''
+html += siteBackground || ''
+html += cover || ''
+html += `<div class="site-shell" id="start" data-regions="${presentRegions.join(' ')}">`
+html += shellRegions.topbar || ''
+html += '<div class="site-workspace">'
+html += shellRegions.leftbar || ''
+html += `<main class="site-main" id="main">${main || ''}</main>`
+html += shellRegions.rightbar || ''
+html += '</div>'
+html += '<button type="button" class="site-scrim" data-shell-action="dismiss-drawer" aria-label="Close navigation" tabindex="-1"></button>'
+html += controls || ''
+html += typeof overlays === 'string' ? overlays : ''
+html += '</div>'
+html += `<div class="site-scripts">${scripts || ''}</div>`
+html += '</body></html>'
+%>
+<%- html %>