hexo-theme-nblog 1.0.0

package/.github/workflows/publish.yml

@@ -0,0 +1,25 @@
+name: Publish Package
+
+on:
+  push:
+    tags:
+      - 'v*'
+
+permissions:
+  id-token: write  # Required for OIDC
+  contents: read
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version: '24'
+          registry-url: 'https://registry.npmjs.org'
+      - run: npm ci
+      - run: npm run build --if-present
+      - run: npm test
+      - run: npm publish

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Nitai
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,46 @@
+# NBlog - 轻量化博客主题
+
+参考 Material Design 设计风格，轻量极简
+
+## Getting Started - 快速开始
+
+Check your environment:
+
+- Hexo: 6.0.0 ~ latest
+- hexo-cli: 4.3.0 ~ latest
+- node: 14.17.3 ~ latest LTS
+- npm: 6.14.13 ~ latest
+
+Edit your `_config.yml`:
+
+```yaml
+theme: nblog
+```
+
+Install NBlog in terminal:
+
+```bash
+npm i hexo-theme-nblog
+```
+
+> **不推荐使用其他方式安装主题**，这些方式无法获得版本更新提示，且可能导致配置文件冲突等问题
+
+## Usage
+
+See docs: `https://blog.nitai.cc/posts/blog-docs`
+
+## Preview
+
+[Nitai Blog](https://blog.nitai.cc/)
+
+## Feedback
+
+Issues: `https://github.com/Nitai9h/nBlogHexo/issues/`
+
+Discussions: `https://github.com/Nitai9h/nBlogHexo/discussions/`
+
+## License
+
+MIT License
+
+Copyright (c) 2026 Nitai

package/_config.yml

@@ -0,0 +1,77 @@
+#! 注意! 为了更新 npm package 后你的数据不会丢失
+#! 请将此文件复制到根目录并重命名为 `_config.nblog.yml` 并在此文件的基础上进行站点
+default_license: CC BY-NC-SA 4.0
+
+site_name: My Blog
+author: Your Name
+avatar: /images/avatar.png
+bio: 这里是你的个人简介
+social:
+  - platform: GitHub
+    url: https://github.com/yourusername
+    icon: '<svg width="20" height="20" viewBox="0 0 24 24" fill="currentColor"><path d="M12 0c-6.626 0-12 5.373-12 12 0 5.302 3.438 9.8 8.207 11.387.599.111.793-.261.793-.577v-2.234c-3.338.726-4.033-1.416-4.033-1.416-.546-1.387-1.333-1.756-1.333-1.756-1.089-.745.083-.729.083-.729 1.205.084 1.839 1.237 1.839 1.237 1.07 1.834 2.807 1.304 3.492.997.107-.775.418-1.305.762-1.604-2.665-.305-5.467-1.334-5.467-5.931 0-1.311.469-2.381 1.236-3.221-.124-.303-.535-1.524.117-3.176 0 0 1.008-.322 3.301 1.23.957-.266 1.983-.399 3.003-.404 1.02.005 2.047.138 3.006.404 2.291-1.552 3.297-1.23 3.297-1.23.653 1.653.242 2.874.118 3.176.77.84 1.235 1.911 1.235 3.221 0 4.609-2.807 5.624-5.479 5.921.43.372.823 1.102.823 2.222v3.293c0 .319.192.694.801.576 4.765-1.589 8.199-6.086 8.199-11.386 0-6.627-5.373-12-12-12z"/></svg>'
+  - platform: Email
+    url: mailto:your@email.com
+    icon: '<svg width="20" height="20" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><path d="M4 4h16c1.1 0 2 .9 2 2v12c0 1.1-.9 2-2 2H4c-1.1 0-2-.9-2-2V6c0-1.1.9-2 2-2z"></path><polyline points="22,6 12,13 2,6"></polyline></svg>'
+
+nav_links:
+  - name: 首页
+    path: /
+    icon: '<svg width="18" height="18" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><path d="m3 9 9-7 9 7v11a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2z"></path><polyline points="9 22 9 12 15 12 15 22"></polyline></svg>'
+  - name: 分类
+    path: /categories/
+    icon: '<svg width="18" height="18" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><path d="M22 19a2 2 0 0 1-2 2H4a2 2 0 0 1-2-2V5a2 2 0 0 1 2-2h5l2 3h9a2 2 0 0 1 2 2z"></path></svg>'
+  - name: 标签
+    path: /tags/
+    icon: '<svg width="18" height="18" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><path d="M20.59 13.41l-7.17 7.17a2 2 0 0 1-2.83 0L2 12V2h10l8.59 8.59a2 2 0 0 1 0 2.82z"></path><line x1="7" y1="7" x2="7.01" y2="7"></line></svg>'
+  - name: 归档
+    path: /archives/
+    icon: '<svg width="18" height="18" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><rect x="3" y="4" width="18" height="18" rx="2" ry="2"></rect><line x1="16" y1="2" x2="16" y2="6"></line><line x1="8" y1="2" x2="8" y2="6"></line><line x1="3" y1="10" x2="21" y2="10"></line></svg>'
+  - name: 友链
+    path: /friends/
+    icon: '<svg width="18" height="18" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><path d="M10 13a5 5 0 0 0 7.54.54l3-3a5 5 0 0 0-7.07-7.07l-1.72 1.71"></path><path d="M14 11a5 5 0 0 0-7.54-.54l-3 3a5 5 0 0 0 7.07 7.07l1.71-1.71"></path></svg>'
+
+friend_links:
+  simple:
+    - name: Cloudflare
+      url: https://cloudflare.com
+      avatar: https://www.cloudflare.com/img/logo-cloudflare-dark.svg
+      description: Security, Performance, Reliability
+    - name: Hexo
+      url: https://hexo.io
+      avatar: https://hexo.io/logo.svg
+      description: A fast, simple & powerful blog framework
+#  cover:
+#    - name: Cloudflare Blog
+#      url: https://cloudflare.com
+#      avatar: https://www.cloudflare.com/img/logo-cloudflare-dark.svg
+#      cover: https://images.unsplash.com/photo-1555066931-4365d14bab8c?w=600
+#      author: Cloudflare
+#      description: Security, Performance, Reliability for the modern web
+#    - name: Hexo Blog
+#      url: https://hexo.io
+#      avatar: https://hexo.io/logo.svg
+#      cover: https://images.unsplash.com/photo-1461749280684-dccba630e2f6?w=600
+#      author: Hexo
+#      description: A fast, simple & powerful blog framework powered by Node.js
+
+footer_links:
+  - name: 隐私政策
+    path: /posts/privacy/
+  - name: 版权协议
+    path: /posts/copyright/
+
+posts_per_page: 10
+
+twikoo:
+  enable: false
+  envId: https://xxx
+
+katex:
+  enable: true
+
+pjax:
+  enable: true
+
+canonical:
+  enable: true

package/layout/_partial/footer.ejs

@@ -0,0 +1,49 @@
+<footer class="footer">
+  <div class="footer__container container">
+    <div class="footer__content">
+      <div class="footer__left">
+        <div class="footer__themeInfo">
+          <p>nBlog</p>
+          <span class="footer__version">
+            <%= theme_version() %>
+          </span>
+        </div>
+        <div class="footer__links">
+          <% (theme.footer_links || []).forEach((link, index)=> { %>
+            <a href="<%= url_for(link.path) %>">
+              <%= link.name %>
+            </a>
+            <% if (index < theme.footer_links.length - 1) { %><span class="footer__links-divider">|</span>
+              <% } %>
+                <% }) %>
+        </div>
+      </div>
+      <div class="footer__center">
+        <p class="footer__copyright">
+          Copyright
+          © <%= date(Date.now(), 'YYYY' ) %>
+            <span class="footer__author">
+              <%= theme.author || config.author %>
+            </span>. All rights reserved.
+        </p>
+        <div class="footer__busuanzi">
+          <span id="busuanzi_container_site_pv">本站总访问量 <span id="busuanzi_value_site_pv"></span> 次</span>
+          <span class="footer__busuanzi-divider">|</span>
+          <span id="busuanzi_container_site_uv">访客数 <span id="busuanzi_value_site_uv"></span> 人次</span>
+        </div>
+      </div>
+      <div class="footer__right">
+        <p style="height: 22px;">
+          <a href="<%= url_for('/sitemap.xml') %>" class="footer__sitemap">Sitemap</a>
+          <a href="<%= url_for('/rss.xml') %>" class="footer__rss">RSS 订阅</a>
+        </p>
+        <p class="footer__powered">
+          Powered by
+          <a href="https://hexo.io" target="_blank" rel="noopener">Hexo</a> &
+          <a href="https://github.com/Nitai9h/nBlogHexo" target="_blank" rel="noopener">nBlogHexo</a>
+        </p>
+      </div>
+    </div>
+  </div>
+</footer>
+<script async src="//busuanzi.ibruce.info/busuanzi/2.3/busuanzi.pure.mini.js"></script>

package/layout/_partial/header.ejs

@@ -0,0 +1,49 @@
+<header class="header" id="header">
+  <div class="header__container container">
+    <a href="<%= url_for('/') %>" class="header__logo">
+      <span class="header__logo-icon header__logo-icon--svg">
+        <svg viewBox="0 0 1033 1105" width="26" height="26">
+          <path d="m530.5 55c-3.6 0-7.7 0.6-9.3 1.4-1.5 0.8-3.6 2.4-4.7 3.6-2 2.2-2 3.6-2 76.4 0 57.5 0.2 74.8 1.2 77.3 0.8 1.9 2.7 4 4.6 5 3 1.7 11.4 1.8 144.7 1.4 102.6-0.3 143.1-0.1 147.3 0.8 3.3 0.6 7 2.1 8.7 3.6 2 1.7 3.5 4.4 4.7 8.2 1.5 5.3 1.6 19.4 0.9 174.3-0.5 135.3-0.4 169 0.7 171 0.7 1.4 2.6 3.2 4.2 4 2.6 1.4 13.2 1.7 79.5 2.2 69.5 0.5 76.9 0.4 80.9-1.1 2.4-0.9 5.2-2.8 6.3-4.4 1.7-2.6 1.8-11.7 1.8-259.4 0-243.4-0.1-256.9-1.7-259.2-1-1.4-3.3-3.1-5.1-3.8-2.6-1.1-42.9-1.3-216.7-1.3-146.1 0-236.1 0.1-226.5 0 9.6-0.1-15.9 0-19.5 0zm-487.6 461.9c-2 0.3-4.9 1.7-6.3 3.1-1.5 1.4-3.2 4.3-3.8 6.5-0.7 2.8-1 78.5-0.9 259.5l0.7 255.2c0.1 0.8 0.4 1.8 0.6 2 3.9 3.9 6 4.3 7.8 4.8 1.9 0.6 7.2 1 11.8 1 4.8 0 7.6 0.2 8.2 0.1 3.5-0.1 5.9 0.2 12.9 0.2 7 0 12.2-0.1 10.3 0-0.6 0 63-0.1 187.3-0.3 125-0.2 185.6 0 188.4 0.2 2.2 0.1 4.3 0.1 11.3 0 7 0 9.2-0.1 10.6 0 0.6 0.1 4.1-0.2 10-0.2 5.3 0 11.4-0.5 13.5-1 2.3-0.6 4.8-2.4 6.7-4.8l2.1-3.6c-0.5-144-0.6-145.8-1.6-149.4-0.6-2-3.6-4-5.5-4.8-3.2-1.5-15.3-1.6-140-0.7-75.1 0.6-139.4 0.7-143 0.3-3.6-0.4-8-1.4-9.7-2.3-1.8-1-4.2-2.9-5.4-4.5-1.1-1.5-2.5-4.5-3.2-6.7-0.8-2.7-1.1-16-1.2-41.5 0-20.6 0.1-97.1 0.3-170 0.2-124.8 0.1-132.7-1.5-136-1-1.9-3.2-4.2-4.8-5.1-2.7-1.5-10.6-1.7-77.5-2.2-41-0.3-76.1-0.2-78.1 0.2zm233.5-230.7c-3 0.5-5.8 1.6-7.2 3-1.5 1.6-2.5 4.3-3.2 8.8-0.6 3.8-1 48-1 106.5 0 98.3 0 100.1 2 105 1.3 3.3 3.1 5.7 5.3 7 3.1 1.9 5.1 1.9 115.2 1.7 64.9-0.2 113.6-0.7 115.8-1.3 2-0.5 4.8-1.9 6.1-3.2 1.2-1.2 2.7-3.8 3.2-5.7 0.6-2.1 0.9-46 0.8-107-0.1-56.9-0.5-104.6-0.9-106-0.4-1.4-1.7-3.6-2.9-4.9-1.1-1.3-3.2-2.8-4.6-3.4-1.7-0.8-35.9-1.1-113.1-1.1-60.8-0.1-112.7 0.2-115.5 0.6zm254.1 297.8c-5.3 0.3-9 1.1-10.8 2.2-1.5 1-3.3 2.8-4 4-0.9 1.8-1.3 25.3-1.5 105.8-0.2 56.9 0 106 0.4 109 0.5 4.3 0.8 7.2 3.4 9.9l4 2 231.7 0.4c5.6-3.5 6.8-7.4 7.3-9.3 0.6-2.1 0.9-44.5 0.7-109.5-0.2-99.1-0.3-106.3-1.9-108.8-1-1.5-3.3-3.3-5-4.1-2.8-1.3-19.9-1.5-109.8-1.8-58.6-0.2-110.1-0.1-114.5 0.2z"/>
+        </svg>
+      </span>
+      <span class="header__logo-text"><%= theme.site_name || config.title %></span>
+    </a>
+
+    <nav class="header__nav" id="nav">
+      <% for (var item of theme.nav_links) { %>
+        <a href="<%= url_for(item.path) %>" class="header__nav-item">
+          <span class="header__nav-icon"><%- item.icon %></span>
+          <span class="header__nav-text"><%= item.name %></span>
+        </a>
+      <% } %>
+    </nav>
+
+    <div class="header__actions">
+      <button class="header__search-btn material-button material-button--text" onclick="location.href='<%= url_for('/search/') %>'">
+        <svg width="20" height="20" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2">
+          <circle cx="11" cy="11" r="8"></circle>
+          <path d="m21 21-4.35-4.35"></path>
+        </svg>
+      </button>
+
+      <button class="header__theme-btn material-button material-button--text" id="themeToggle">
+        <svg class="icon-sun" width="20" height="20" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2">
+          <circle cx="12" cy="12" r="5"></circle>
+          <path d="M12 1v2M12 21v2M4.22 4.22l1.42 1.42M18.36 18.36l1.42 1.42M1 12h2M21 12h2M4.22 19.78l1.42-1.42M18.36 5.64l1.42-1.42"></path>
+        </svg>
+        <svg class="icon-moon" width="20" height="20" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2">
+          <path d="M21 12.79A9 9 0 1 1 11.21 3 7 7 0 0 0 21 12.79z"></path>
+        </svg>
+      </button>
+
+      <button class="header__menu-btn material-button material-button--text" id="menuBtn">
+        <svg class="icon-menu" width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2">
+          <path d="M3 12h18M3 6h18M3 18h18"></path>
+        </svg>
+        <svg class="icon-close" width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2">
+          <path d="M18 6L6 18M6 6l12 12"></path>
+        </svg>
+      </button>
+    </div>
+  </div>
+</header>

package/layout/_partial/open-graph.ejs

@@ -0,0 +1,77 @@
+<%
+let ogTitle = '';
+let ogDescription = '';
+let ogImage = '';
+let ogUrl = '';
+let ogType = 'website';
+let ogSiteName = config.title;
+let articlePublishedTime = '';
+let articleModifiedTime = '';
+let articleAuthor = config.author || '';
+let articleSection = '';
+let baseUrl = config.url.replace(/\/$/, '');
+
+if (is_post()) {
+  ogTitle = page.title;
+  ogDescription = page.description || page.excerpt || strip_html(page.content).substring(0, 200).trim() + '...';
+  ogImage = page.cover || theme.avatar;
+  ogUrl = baseUrl + '/' + page.path.replace(/\/$/, '');
+  ogType = 'article';
+  articlePublishedTime = date(page.date, 'YYYY-MM-DDTHH:mm:ssZ');
+  articleModifiedTime = page.updated ? date(page.updated, 'YYYY-MM-DDTHH:mm:ssZ') : articlePublishedTime;
+  if (page.categories && page.categories.length > 0) {
+    articleSection = page.categories.toArray()[0].name;
+  }
+} else if (is_category()) {
+  ogTitle = '分类: ' + page.category + ' | ' + config.title;
+  ogDescription = '查看分类 "' + page.category + '" 下的所有文章';
+  ogImage = theme.avatar;
+  ogUrl = baseUrl + '/' + page.path.replace(/\/$/, '');
+} else if (is_tag()) {
+  ogTitle = '标签: ' + page.tag + ' | ' + config.title;
+  ogDescription = '查看标签 "' + page.tag + '" 下的所有文章';
+  ogImage = theme.avatar;
+  ogUrl = baseUrl + '/' + page.path.replace(/\/$/, '');
+} else if (is_archive()) {
+  ogTitle = '归档 | ' + config.title;
+  ogDescription = '浏览所有文章归档';
+  ogImage = theme.avatar;
+  ogUrl = baseUrl + '/' + page.path.replace(/\/$/, '');
+} else {
+  ogTitle = config.title;
+  ogDescription = config.description;
+  ogImage = theme.avatar;
+  ogUrl = baseUrl;
+}
+%>
+
+<meta property="og:site_name" content="<%= ogSiteName %>">
+<meta property="og:title" content="<%= ogTitle %>">
+<meta property="og:description" content="<%= ogDescription %>">
+<meta property="og:url" content="<%= ogUrl %>">
+<meta property="og:image" content="<%= ogImage %>">
+<meta property="og:type" content="<%= ogType %>">
+<meta property="og:locale" content="<%= config.language || 'zh_CN' %>">
+
+<% if (is_post()) { %>
+<meta property="article:published_time" content="<%= articlePublishedTime %>">
+<meta property="article:modified_time" content="<%= articleModifiedTime %>">
+<meta property="article:author" content="<%= articleAuthor %>">
+<% if (articleSection) { %>
+<meta property="article:section" content="<%= articleSection %>">
+<% } %>
+<% if (page.tags && page.tags.length > 0) { %>
+  <% page.tags.toArray().forEach(function(tag) { %>
+<meta property="article:tag" content="<%= tag.name %>">
+  <% }); %>
+<% } %>
+<% } %>
+
+<meta name="twitter:card" content="summary_large_image">
+<meta name="twitter:title" content="<%= ogTitle %>">
+<meta name="twitter:description" content="<%= ogDescription %>">
+<meta name="twitter:image" content="<%= ogImage %>">
+
+<meta name="apple-mobile-web-app-title" content="<%= ogSiteName %>">
+<meta name="application-name" content="<%= ogSiteName %>">
+<meta name="theme-color" content="#4f46e5">

package/layout/_partial/post-license.ejs

@@ -0,0 +1,44 @@
+<% var license=page.license || theme.default_license || 'CC BY-NC-SA 4.0' ; var author=page.author || theme.author ||
+  config.author || '作者' ; var isOriginal=page.original !==false; var sourceUrl=page.source_url || '' ; var
+  licenseInfo={ 'CC BY-NC-SA 4.0' : { name: 'CC BY-NC-SA 4.0' ,
+  url: 'https://creativecommons.org/licenses/by-nc-sa/4.0/deed.zh' , desc: '署名-非商业性使用-相同方式共享 4.0 国际' } }; var
+  currentLicense=licenseInfo[license] || licenseInfo['CC BY-NC-SA 4.0']; %>
+  <div class="post-license animate-fade-in-up animate-delay-2">
+    <div class="post-license__header">
+      <span class="copyright-symbol">©</span>
+      <span>版权声明</span>
+    </div>
+    <div class="post-license__content">
+      <div class="post-license__row">
+        <div class="post-license__item">
+          <span class="post-license__label">本文作者：</span>
+          <span class="post-license__value">
+            <%= author %>
+          </span>
+        </div>
+        <div class="post-license__item">
+          <span class="post-license__label">文章类型：</span>
+          <span class="post-license__value">
+            <%= isOriginal ? '原创' : '转载' %>
+          </span>
+        </div>
+      </div>
+      <% if (!isOriginal && sourceUrl) { %>
+        <div class="post-license__item">
+          <span class="post-license__label">原文链接：</span>
+          <a href="<%= sourceUrl %>" class="post-license__link" target="_blank" rel="noopener">
+            <%= sourceUrl %>
+          </a>
+        </div>
+        <% } %>
+          <div class="post-license__notice">
+            <% if (isOriginal) { %>
+              本文为作者原创文章，遵循 <a href="<%= currentLicense.url %>" target="_blank" rel="noopener">
+                <%= currentLicense.name %>
+              </a> 许可协议，转载请注明出处。
+              <% } else { %>
+                本文仅供学习交流使用，版权归原作者所有，侵权请联系删除
+                <% } %>
+          </div>
+    </div>
+  </div>

package/layout/archive.ejs

@@ -0,0 +1,45 @@
+<div class="archives-page container">
+  <div class="page-header animate-fade-in-up">
+    <h1 class="page-header__title">
+      <svg width="28" height="28" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2">
+        <rect x="3" y="4" width="18" height="18" rx="2" ry="2"></rect>
+        <line x1="16" y1="2" x2="16" y2="6"></line>
+        <line x1="8" y1="2" x2="8" y2="6"></line>
+        <line x1="3" y1="10" x2="21" y2="10"></line>
+      </svg>
+      归档
+    </h1>
+    <p class="page-header__description">共 <%= site.posts.length %> 篇文章</p>
+  </div>
+
+  <div class="archives-list animate-fade-in-up animate-delay-1">
+    <%
+      var years = {};
+      site.posts.sort('-date').forEach(function(post) {
+        var year = date(post.date, 'YYYY');
+        if (!years[year]) years[year] = [];
+        years[year].push(post);
+      });
+    %>
+    <% Object.keys(years).sort().reverse().forEach(function(year) { %>
+      <section class="archive-year">
+        <h2 class="archive-year__title"><%= year %></h2>
+        <div class="archive-year__posts">
+          <% years[year].forEach(function(post) { %>
+            <article class="archive-post">
+              <time class="archive-post__date" datetime="<%= date(post.date, 'YYYY-MM-DD') %>">
+                <%= date(post.date, 'MM-DD') %>
+              </time>
+              <a href="<%= url_for(post.path) %>" class="archive-post__title"><%= post.title %></a>
+              <% if (post.categories && post.categories.length > 0) { %>
+                <a href="<%= url_for(post.categories.toArray()[0].path) %>" class="archive-post__category">
+                  <%= post.categories.toArray()[0].name %>
+                </a>
+              <% } %>
+            </article>
+          <% }); %>
+        </div>
+      </section>
+    <% }); %>
+  </div>
+</div>

package/layout/category.ejs

@@ -0,0 +1,76 @@
+<% if (page.posts && page.posts.length > 0) { %>
+<div class="category-posts-page container">
+  <div class="page-header animate-fade-in-up">
+    <h1 class="page-header__title">
+      <svg width="28" height="28" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2">
+        <path d="M22 19a2 2 0 0 1-2 2H4a2 2 0 0 1-2-2V5a2 2 0 0 1 2-2h5l2 3h9a2 2 0 0 1 2 2z"></path>
+      </svg>
+      分类: <%= page.category %>
+    </h1>
+    <p class="page-header__description">共 <%= page.posts.length %> 篇文章</p>
+    <a href="<%= url_for('/categories/') %>" class="page-header__back">
+      <svg width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2">
+        <polyline points="15 18 9 12 15 6"></polyline>
+      </svg>
+      返回分类列表
+    </a>
+  </div>
+
+  <div class="posts-list animate-fade-in-up animate-delay-1">
+    <% page.posts.each(function(post) { %>
+      <article class="post-card material-card">
+        <a href="<%= url_for(post.path) %>" class="post-card__link">
+          <div class="post-card__cover">
+            <% if (post.cover) { %>
+              <img src="<%= post.cover %>" alt="<%= post.title %>" loading="lazy">
+            <% } else { %>
+              <div class="post-card__cover-placeholder"></div>
+            <% } %>
+            <div class="post-card__overlay"></div>
+            <div class="post-card__info">
+              <div class="post-card__meta">
+                <span class="post-card__date"><%= date(post.date, 'YYYY-MM-DD') %></span>
+                <% if (post.categories && post.categories.length > 0) { %>
+                  <span class="post-card__category"><%= post.categories.toArray()[0].name %></span>
+                <% } %>
+              </div>
+              <h2 class="post-card__title"><%= post.title %></h2>
+            </div>
+          </div>
+        </a>
+      </article>
+    <% }); %>
+  </div>
+</div>
+<% } else { %>
+<div class="categories-page container">
+  <div class="page-header animate-fade-in-up">
+    <h1 class="page-header__title">
+      <svg width="28" height="28" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2">
+        <path d="M22 19a2 2 0 0 1-2 2H4a2 2 0 0 1-2-2V5a2 2 0 0 1 2-2h5l2 3h9a2 2 0 0 1 2 2z"></path>
+      </svg>
+      分类
+    </h1>
+    <p class="page-header__description">共 <%= site.categories.length %> 个分类</p>
+  </div>
+
+  <div class="categories-grid animate-fade-in-up animate-delay-1">
+    <% site.categories.sort('name').forEach(function(category) { %>
+      <a href="<%= url_for(category.path) %>" class="category-card material-card">
+        <div class="category-card__icon">
+          <svg width="32" height="32" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2">
+            <path d="M22 19a2 2 0 0 1-2 2H4a2 2 0 0 1-2-2V5a2 2 0 0 1 2-2h5l2 3h9a2 2 0 0 1 2 2z"></path>
+          </svg>
+        </div>
+        <div class="category-card__content">
+          <h3 class="category-card__name"><%= category.name %></h3>
+          <span class="category-card__count"><%= category.length %> 篇文章</span>
+        </div>
+        <svg class="category-card__arrow" width="20" height="20" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2">
+          <polyline points="9 18 15 12 9 6"></polyline>
+        </svg>
+      </a>
+    <% }); %>
+  </div>
+</div>
+<% } %>

package/layout/friends.ejs

@@ -0,0 +1,57 @@
+<div class="friends-page container">
+  <div class="page-header animate-fade-in-up">
+    <h1 class="page-header__title">
+      <svg width="28" height="28" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2">
+        <path d="M10 13a5 5 0 0 0 7.54.54l3-3a5 5 0 0 0-7.07-7.07l-1.72 1.71"></path>
+        <path d="M14 11a5 5 0 0 0-7.54-.54l-3 3a5 5 0 0 0 7.07 7.07l1.71-1.71"></path>
+      </svg>
+      <%= page.title %>
+    </h1>
+    <% if (page.description) { %>
+      <p class="page-header__description"><%= page.description %></p>
+    <% } %>
+  </div>
+
+  <div class="page-content animate-fade-in-up animate-delay-1">
+    <% if (theme.friend_links && theme.friend_links.simple && theme.friend_links.simple.length > 0) { %>
+      <div class="friends-grid">
+        <% theme.friend_links.simple.forEach(function(friend) { %>
+          <a href="<%= friend.url %>" target="_blank" rel="noopener" class="friend-card material-card">
+            <div class="friend-card__avatar">
+              <img src="<%= friend.avatar %>" alt="<%= friend.name %>" loading="lazy">
+            </div>
+            <div class="friend-card__content">
+              <h3 class="friend-card__name"><%= friend.name %></h3>
+              <p class="friend-card__description"><%= friend.description %></p>
+            </div>
+          </a>
+        <% }); %>
+      </div>
+    <% } %>
+
+    <% if (theme.friend_links && theme.friend_links.cover && theme.friend_links.cover.length > 0) { %>
+      <div class="friends-grid" style="grid-template-columns: repeat(3, 1fr); <% if (theme.friend_links.simple && theme.friend_links.simple.length > 0) { %>margin-top: 24px;<% } %>">
+        <% theme.friend_links.cover.forEach(function(friend) { %>
+          <a href="<%= friend.url %>" target="_blank" rel="noopener" class="friend-card friend-card--cover material-card">
+            <div class="friend-card__cover">
+              <img src="<%= friend.cover %>" alt="<%= friend.name %>" loading="lazy">
+            </div>
+            <div class="friend-card__overlay"></div>
+            <div class="friend-card__content">
+              <div class="friend-card__avatar-wrapper">
+                <div class="friend-card__avatar">
+                  <img src="<%= friend.avatar %>" alt="<%= friend.name %>" loading="lazy">
+                </div>
+                <span class="friend-card__author"><%= friend.author || friend.name %></span>
+              </div>
+              <h3 class="friend-card__name"><%= friend.name %></h3>
+              <p class="friend-card__description"><%= friend.description %></p>
+            </div>
+          </a>
+        <% }); %>
+      </div>
+    <% } %>
+
+    <%- page.content %>
+  </div>
+</div>