hexo-sitemap-html 1.0.2 → 1.0.3

package/index.js

@@ -3,186 +3,86 @@
 const _ = require('lodash');
 const fs = require('hexo-fs');
 const path = require('path');
+const getTemplate = require('./lib/templates'); // 引用模板
 
-// 默认配置
 const DEFAULT_CONFIG = {
   path: 'sitemap.html',
-  enable: {
-    categories: true,
-    posts: true,
-    pages: true
-  },
+  enable: { categories: true, posts: true, pages: true },
   exclude: [],
-  layout: 'modern', // 默认使用新模板
+  layout: 'minimal', // 默认改用简约风
   nofollow: false
 };
 
-const LAYOUT_STYLES = {
-  simple: `
-    <style>
-      * { margin: 0; padding: 0; box-sizing: border-box; }
-      body { font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, sans-serif; max-width: 900px; margin: 0 auto; padding: 2rem; color: #333; line-height: 1.6; }
-      h1 { text-align: center; margin-bottom: 2rem; color: #2c3e50; }
-      .section { margin-bottom: 3rem; }
-      h2 { border-bottom: 2px solid #eee; padding-bottom: 0.5rem; margin-bottom: 1rem; color: #34495e; }
-      .list { list-style: none; }
-      .list-item { padding: 0.5rem 0; border-bottom: 1px dashed #eee; display: flex; justify-content: space-between; }
-      .list-item a { color: #3498db; text-decoration: none; }
-      .list-item a:hover { color: #2980b9; text-decoration: underline; }
-      .meta { color: #95a5a6; font-size: 0.9em; }
-    </style>
-  `,
-  modern: `
-    <style>
-      :root { --primary: #6366f1; --bg: #f8fafc; --card: #ffffff; --text: #1e293b; --text-light: #64748b; }
-      * { margin: 0; padding: 0; box-sizing: border-box; }
-      body { font-family: "Inter", system-ui, sans-serif; background: var(--bg); color: var(--text); padding: 3rem 1rem; line-height: 1.5; }
-      .container { max-width: 1000px; margin: 0 auto; }
-      header { text-align: center; margin-bottom: 4rem; }
-      h1 { font-size: 2.5rem; font-weight: 800; color: var(--text); margin-bottom: 1rem; }
-      .section { margin-bottom: 4rem; }
-      h2 { font-size: 1.5rem; margin-bottom: 1.5rem; display: flex; align-items: center; gap: 0.5rem; }
-      h2::before { content: ''; display: inline-block; width: 4px; height: 1.5rem; background: var(--primary); border-radius: 4px; }
-      .grid { display: grid; grid-template-columns: repeat(auto-fill, minmax(300px, 1fr)); gap: 1.25rem; }
-      .card { background: var(--card); padding: 1.25rem; border-radius: 12px; box-shadow: 0 1px 3px rgba(0,0,0,0.1); transition: all 0.2s; border: 1px solid #e2e8f0; text-decoration: none; display: block; }
-      .card:hover { transform: translateY(-2px); box-shadow: 0 10px 15px -3px rgba(0,0,0,0.1); border-color: var(--primary); }
-      .card-title { display: block; font-weight: 600; color: var(--text); margin-bottom: 0.5rem; white-space: nowrap; overflow: hidden; text-overflow: ellipsis; }
-      .card-meta { font-size: 0.875rem; color: var(--text-light); }
-      @media (max-width: 640px) { .grid { grid-template-columns: 1fr; } }
-    </style>
-  `
-};
-
-function formatDate(date) {
-  if (!date) return 'No Date';
-  const d = new Date(date);
-  return d.toISOString().split('T')[0];
-}
-
 async function createHtmlSitemap(hexo, force = false) {
-  const config = _.merge({}, DEFAULT_CONFIG, hexo.config.html_sitemap || {});
-  
-  // 校验布局
-  if (!LAYOUT_STYLES[config.layout]) {
-    hexo.log.warn(`[hexo-sitemap-html] Invalid layout: ${config.layout}, fallback to modern`);
-    config.layout = 'modern';
-  }
-
-  const nofollowAttr = config.nofollow ? 'rel="nofollow"' : '';
-  const { categories, posts, pages } = hexo.site;
+  const hexoInstance = hexo || this;
+  if (!hexoInstance) return;
 
-  // 1. 处理数据
-  const postList = config.enable.posts ? posts.sort('date', 'desc').map(p => ({
-    title: p.title || 'Untitled',
-    path: hexo.url_for(p.path),
-    date: formatDate(p.date)
-  })) : [];
+  await hexoInstance.load();
+  const urlFor = hexoInstance.extend.helper.get('url_for').bind(hexoInstance);
+  const config = _.merge({}, DEFAULT_CONFIG, (hexoInstance.config.html_sitemap || {}));
+  
+  // 获取 i18n 和 CSS
+  const lang = hexoInstance.config.language || 'en';
+  const { t, css } = getTemplate(config.layout, lang);
 
-  const categoryList = config.enable.categories ? categories.map(c => ({
-    name: c.name || 'Uncategorized',
-    path: hexo.url_for(c.path),
-    count: c.posts.length
-  })) : [];
+  const locals = hexoInstance.locals.toObject();
+  const nofollow = config.nofollow ? 'rel="nofollow"' : '';
 
-  const pageList = config.enable.pages ? pages.filter(p => {
-    const isExcluded = config.exclude.some(ex => p.title?.includes(ex) || p.path?.includes(ex));
-    return !isExcluded && p.path;
-  }).map(p => ({
-    title: p.title || 'Untitled Page',
-    path: hexo.url_for(p.path),
-    date: formatDate(p.date)
-  })) : [];
+  // 处理数据（逻辑同前，仅抽取数据）
+  const posts = config.enable.posts ? locals.posts.toArray().sort((a,b)=>b.date-a.date) : [];
+  const cats = config.enable.categories ? locals.categories.toArray() : [];
+  const pages = config.enable.pages ? locals.pages.toArray().filter(p => !config.exclude.some(ex => (p.title||'').includes(ex))) : [];
 
-  // 2. 生成 HTML
-  const htmlContent = `
+  const html = `
 <!DOCTYPE html>
-<html lang="${hexo.config.language || 'en'}">
+<html lang="${lang}">
 <head>
   <meta charset="UTF-8">
-  <meta name="viewport" content="width=device-width, initial-scale=1.0">
-  <title>Site Map - ${hexo.config.title}</title>
-  ${LAYOUT_STYLES[config.layout]}
+  <title>${t.title} - ${hexoInstance.config.title}</title>
+  ${css}
 </head>
 <body>
   <div class="container">
-    <header>
-      <h1>Site Map</h1>
-      <p style="color: #64748b;">Total ${postList.length} posts, ${categoryList.length} categories</p>
-    </header>
 
-    ${postList.length ? `
-    <div class="section">
-      <h2>Posts</h2>
-      <div class="grid">
-        ${postList.map(item => `
-          <a href="${item.path}" class="card" ${nofollowAttr}>
-            <span class="card-title">${item.title}</span>
-            <span class="card-meta">Published: ${item.date}</span>
-          </a>
-        `).join('')}
-      </div>
-    </div>` : ''}
+  <nav style="display:flex;">
+  <a  class="${config.layout === 'minimal' ? '' : 'card item-link'}"  href="/">${t.home}</a>
+  <a  class="${config.layout === 'minimal' ? '' : 'card item-link'}"  href="javascript:history.back()">${t.back}</a>
+  </nav>
 
-    ${categoryList.length ? `
-    <div class="section">
-      <h2>Categories</h2>
-      <div class="grid">
-        ${categoryList.map(item => `
-          <a href="${item.path}" class="card" ${nofollowAttr}>
-            <span class="card-title">${item.name}</span>
-            <span class="card-meta">${item.count} articles</span>
-          </a>
-        `).join('')}
-      </div>
-    </div>` : ''}
+    <h1>${t.title}</h1>
 
-    ${pageList.length ? `
-    <div class="section">
-      <h2>Pages</h2>
-      <div class="grid">
-        ${pageList.map(item => `
-          <a href="${item.path}" class="card" ${nofollowAttr}>
-            <span class="card-title">${item.title}</span>
-            <span class="card-meta">Updated: ${item.date}</span>
+    ${posts.length ? `<section class="section"><h2>${t.posts}</h2><div class="${config.layout === 'flat' ? 'grid' : 'list'}">
+      ${posts.map(p => `
+        <div class="item">
+          <a href="${urlFor(p.path)}" class="${config.layout === 'minimal' ? '' : 'card item-link'}" ${nofollow}>
+            <span class="card-title">${p.title || 'Untitled'}</span>
           </a>
-        `).join('')}
-      </div>
-    </div>` : ''}
+          ${config.layout === 'minimal' ? `<div class="dot"></div>` : ''}
+          <span class="meta card-meta">${p.date.format('YYYY-MM-DD')}</span>
+        </div>`).join('')}
+    </div></section>` : ''}
+
+    ${cats.length ? `<section class="section"><h2>${t.categories}</h2><div class="${config.layout === 'flat' ? 'grid' : 'list'}">
+      ${cats.map(c => `
+        <div class="item">
+          <a href="${urlFor(c.path)}" class="${config.layout === 'minimal' ? '' : 'card item-link'}" ${nofollow}>
+            <span class="card-title">${c.name}</span>
+          </a>
+          ${config.layout === 'minimal' ? `<div class="dot"></div>` : ''}
+          <span class="meta card-meta">${c.posts.length} ${t.items}</span>
+        </div>`).join('')}
+    </div></section>` : ''}
   </div>
 </body>
 </html>`;
 
-  const outputPath = path.join(hexo.public_dir, config.path);
-  
-  if (force && await fs.exists(outputPath)) {
-    await fs.unlink(outputPath);
-  }
-
-  await fs.writeFile(outputPath, htmlContent, 'utf8');
-  hexo.log.info(`[hexo-sitemap-html] Generated: ${config.path}`);
-  return outputPath;
+  const dest = path.join(hexoInstance.public_dir, config.path);
+  if (force && await fs.exists(dest)) await fs.unlink(dest);
+  await fs.writeFile(dest, html);
+  hexoInstance.log.info(`[hexo-sitemap-html] Generated: ${config.path} with ${config.layout} style`);
 }
 
-// 插件入口
-module.exports = function(hexo) {
-  hexo.log.info('[hexo-sitemap-html] Plugin loaded successfully');
-  
-  // 生成器：hexo g 时自动运行
-  hexo.extend.generator.register('html-sitemap', function(locals) {
-    return createHtmlSitemap(this);
-  });
-
-  // 独立命令：hexo sitemap-html 运行
-  hexo.extend.command.register('sitemap-html', {
-    desc: '独立生成 HTML 站点地图',
-    options: [
-      { name: 'force', alias: 'f', desc: '强制覆盖已有文件', type: Boolean }
-    ]
-  }, async function(args) {
-    try {
-      await createHtmlSitemap(this, args.f || args.force);
-    } catch (e) {
-      this.log.error(`[hexo-sitemap-html] Failed: ${e.message}`);
-    }
-  });
-};
+  hexo.extend.generator.register('html-sitemap', function() { return createHtmlSitemap(this); });
+  hexo.extend.console.register('sitemap-html', 'Generate HTML sitemap', {
+    options: [{ name: '-f, --force', desc: 'Overwrite' }]
+  }, function(args) { return createHtmlSitemap(this, args.f || args.force); });

package/lib/templates.js

@@ -0,0 +1,58 @@
+'use strict';
+
+const i18n = {
+  'zh-CN': { home:"首页",back:"返回",title: '站点地图', posts: '文章归档', categories: '分类目录', pages: '独立页面', items: '篇内容', updated: '更新于' },
+  'en': {  home:"Home",back:"Back",title: 'Sitemap', posts: 'Posts', categories: 'Categories', pages: 'Pages', items: 'items', updated: 'Updated' }
+};
+
+const styles = {
+  // 风格 1：极致简约 (Minimal) - 衬线体、大留白、呼吸感
+  minimal: `
+    <style>
+      :root { --accent: #111; --text: #1a1a1a; --light: #888; }
+      body { font-family: "Optima", "Georgia", serif; background: #fff; color: var(--text); padding: 80px 10%; line-height: 1.8; }
+      .container { max-width: 800px; margin: 0 auto; }
+      h1 { font-size: 3.5rem; font-weight: 300; margin-bottom: 60px; letter-spacing: -2px; }
+      h2 { font-size: 0.75rem; text-transform: uppercase; letter-spacing: 4px; color: var(--light); margin-top: 60px; border: none; }
+      .list { list-style: none; padding: 0; }
+      .item { display: flex; align-items: baseline; margin-bottom: 12px; }
+      .item a { text-decoration: none; color: var(--text); font-size: 1.15rem; transition: 0.3s; border-bottom: 1px solid transparent; }
+      .item a:hover { border-bottom: 1px solid var(--accent); }
+      .dot { flex: 1; border-bottom: 1px dotted #ececec; margin: 0 15px; }
+      .meta { font-size: 0.85rem; color: var(--light); font-style: italic; font-family: sans-serif; }
+    </style>
+  `,
+  // 风格 2：扁平克制 (Flat) - 非衬线体、灰度层次、现代感
+  flat: `
+    <style>
+      :root { --bg: #f9f9fb; --primary: #000; --text: #111; --border: #eaeaea; }
+      body { font-family: -apple-system, system-ui, sans-serif; background: var(--bg); color: var(--text); padding: 40px; }
+      .container { max-width: 1000px; margin: 0 auto; background: #fff; padding: 50px; border: 1px solid var(--border); border-radius: 4px; }
+      h1 { font-size: 24px; font-weight: 600; margin-bottom: 30px; }
+      h2 { font-size: 14px; font-weight: 600; color: #666; margin: 40px 0 20px; text-transform: uppercase; }
+      .grid { display: grid; grid-template-columns: repeat(auto-fill, minmax(300px, 1fr)); gap: 15px; }
+      .card { display: block; padding: 16px; border: 1px solid var(--border); text-decoration: none; color: inherit; transition: 0.2s; }
+      .card:hover { border-color: var(--primary); background: #fafafa; }
+      .card-title { font-weight: 500; display: block; margin-bottom: 4px; }
+      .card-meta { font-size: 12px; color: #999; }
+    </style>
+  `,
+  // 风格 3：丰富视觉 (Rich) - 渐变、毛玻璃、动态感
+  rich: `
+    <style>
+      body { background: #f0f2f5; font-family: "Segoe UI", system-ui; padding: 60px 20px; }
+      .container { max-width: 900px; margin: 0 auto; }
+      h1 { font-size: 3rem; text-align: center; margin-bottom: 50px; background: linear-gradient(45deg, #007aff, #00c6ff); -webkit-background-clip: text; -webkit-text-fill-color: transparent; }
+      .section { background: rgba(255,255,255,0.7); backdrop-filter: blur(20px); border-radius: 20px; padding: 30px; margin-bottom: 30px; box-shadow: 0 10px 30px rgba(0,0,0,0.05); }
+      h2 { color: #333; margin-bottom: 20px; padding-left: 12px; border-left: 5px solid #007aff; }
+      .item-link { display: flex; justify-content: space-between; padding: 15px; border-radius: 12px; text-decoration: none; color: #444; transition: all 0.3s; margin-bottom: 5px; }
+      .item-link:hover { background: #fff; transform: scale(1.02); box-shadow: 0 5px 15px rgba(0,0,0,0.05); color: #007aff; }
+    </style>
+  `
+};
+
+module.exports = function(layout, lang = 'en') {
+  const t = i18n[lang] || i18n['en'];
+  const css = styles[layout] || styles.flat;
+  return { t, css };
+};

package/package.json

@@ -1,10 +1,14 @@
 {
   "name": "hexo-sitemap-html",
-  "version": "1.0.2",
+  "version": "1.0.3",
   "main": "index.js",
   "scripts": {
     "test": "echo \"Error: no test specified\" && exit 1"
   },
+  "files": [
+    "index.js",
+    "lib/templates.js"
+  ],
   "keywords": [
     "hexo",
     "hexo-plugin",
@@ -17,7 +21,7 @@
   "hexo": {
     "version": ">=3.0.0"
   },
-  "author": "2winter",
+  "author": "2winter <2winter.dev@gmail.com> (https://2winter.com)",
   "license": "MIT",
   "description": "A Hexo plugin to generate customizable HTML format sitemap, support controlling categories/posts/pages generation, excluding specified pages and multiple layout styles.",
   "dependencies": {

package/.gitattributes

@@ -1,2 +0,0 @@
-# Auto detect text files and perform LF normalization
-* text=auto

package/.github/workflows/npm-publish.yml

@@ -1,33 +0,0 @@
-# This workflow will run tests using node and then publish a package to GitHub Packages when a release is created
-# For more information see: https://docs.github.com/en/actions/publishing-packages/publishing-nodejs-packages
-
-name: Node.js Package
-
-on:
-  release:
-    types: [created]
-
-jobs:
-  build:
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v4
-      - uses: actions/setup-node@v4
-        with:
-          node-version: 20
-      - run: npm ci
-      - run: npm test
-
-  publish-npm:
-    needs: build
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v4
-      - uses: actions/setup-node@v4
-        with:
-          node-version: 20
-          registry-url: https://registry.npmjs.org/
-      - run: npm ci
-      - run: npm publish
-        env:
-          NODE_AUTH_TOKEN: ${{secrets.npm_token}}

package/docs/en-US/README.md

@@ -1,133 +0,0 @@
-
-# hexo-sitemap-html
-
-A **modern, responsive, and highly configurable** Hexo plugin to generate elegant HTML sitemaps. Fully compatible with **Node 22+** and **Hexo 6.x**.
-
-> 📌  [中文版本 (Chinese Version)](../zh-CN/README.md)
-
-## ✨ Core Features
-
-* 🚀 **Node 22 Ready**: Uses the modern `module.exports` pattern to ensure perfect compatibility with the latest Node.js environments.
-* 📱 **Responsive Design**: Brand new `modern` layout with a card-grid system that looks great on mobile and desktop.
-* 🔗 **Auto Menu Injection**: Automatically injects a "Sitemap" link into your theme's navigation bar (supports most mainstream themes).
-* 📝 **Flexible Configuration**: Independently enable/disable categories, posts, or pages.
-* 🚫 **Fuzzy Exclusion**: Precisely exclude unwanted pages (e.g., 404, tags) using keywords in titles or paths.
-* 🎨 **Multiple Layouts**: Built-in styles including `Modern`, `Simple`, and `Rich`.
-* 🔧 **Native UTF-8**: Zero garbled characters, perfect for CJK (Chinese, Japanese, Korean) content.
-
-## 📦 Installation
-
-### Method 1: Local Development (Manual)
-
-If you are developing or customizing the plugin:
-
-1. In your Hexo blog root, create the folder: `node_modules/hexo-sitemap-html`.
-2. Place `index.js` and `package.json` inside.
-3. In your **blog root**, run:
-```bash
-npm install ./node_modules/hexo-sitemap-html
-
-```
-
-
-
-### Method 2: Via npm (Standard)
-
-```bash
-npm install hexo-sitemap-html --save
-
-```
-
-## ⚙️ Configuration
-
-Add the following to your Hexo root `_config.yml`:
-
-```yaml
-# hexo-sitemap-html Configuration
-html_sitemap:
-  path: 'sitemap.html'    # Output path
-  layout: 'modern'        # Options: modern, simple, rich
-  inject_menu: true       # Auto-add "Sitemap" to your blog navigation
-  nofollow: true          # Add rel="nofollow" to sitemap links
-  
-  enable:
-    categories: true      # Show categories section
-    posts: true           # Show posts section
-    pages: true           # Show standalone pages section
-
-  exclude:                # Fuzzy match title or path to hide pages
-    - '404'
-    - 'guestbook'
-    - 'About Me'
-
-```
-
-### Configuration Details
-
-| Option | Type | Default | Description |
-| --- | --- | --- | --- |
-| `path` | String | `sitemap.html` | The filename of the generated sitemap. |
-| `layout` | String | `modern` | UI Style: `modern` (Grid), `simple` (List), `rich` (Animated Cards). |
-| `inject_menu` | Boolean | `false` | Dynamically injects the sitemap link into `theme.menu`. |
-| `nofollow` | Boolean | `false` | If true, search engines won't follow the sitemap links. |
-| `exclude` | Array | `[]` | Keywords to filter out specific pages from the sitemap. |
-
-## 🚀 Usage
-
-1. Clean and generate:
-```bash
-hexo clean && hexo generate
-
-```
-
-
-2. Start local server:
-```bash
-hexo server
-
-```
-
-
-3. Visit: `http://localhost:4000/sitemap.html`
-
-## 🎨 Layout Previews
-
-### 1. Modern Layout (New!)
-
-* **Features**: CSS-Grid card system, mobile-friendly, clean typography.
-* **Best for**: Modern tech blogs and large portfolios.
-
-### 2. Simple Layout
-
-* **Features**: Minimalist text list, fast loading, no-distraction design.
-* **Best for**: Personal diaries or minimal sites.
-
-### 3. Rich Layout
-
-* **Features**: Card-based design with hover animations and deeper shadows.
-* **Best for**: Visually-driven blogs.
-
-## ❓ FAQ
-
-### Q1: The Sitemap is not showing in my Menu?
-
-A: `inject_menu` works by modifying `theme.config.menu` in memory. If your theme uses a non-standard menu structure (not `menu` or `navbar`), you may need to add the link manually to your theme's `_config.yml`.
-
-### Q2: Is it compatible with Node 22?
-
-A: Yes! This version uses the Dependency Injection pattern (`module.exports = function(hexo)...`) which is the safest way to handle plugins in Node 22/Hexo 6.
-
-### Q3: How to customize the CSS?
-
-A: You can find the `<style>` tags in `index.js` under the `LAYOUT_STYLES` constant. Feel free to modify the colors or fonts to match your specific theme.
-
-## 🤝 Contributing
-
-1. Fork the repo.
-2. Create your branch (`git checkout -b feature/AmazingFeature`).
-3. Commit (`git commit -m 'Add some feature'`).
-4. Push to the branch and open a Pull Request.
-
-## 📄 License
-
-This project is licensed under the **MIT License**.

package/docs/zh-CN/README.md

@@ -1,128 +0,0 @@
-
-
-# hexo-sitemap-html
-
-一个**现代、响应式、高度可配置**的 Hexo 插件，用于生成美观的 HTML 格式站点地图。完美适配 **Node 22+** 和 **Hexo 6.x**。
-
-> 📌 语言切换：[English Version](../en-US/README.md)
-
-## ✨ 核心特性
-
-* 🚀 **适配 Node 22**：采用现代的 `module.exports` 插件导出模式，解决新版本 Node 环境下的作用域与全局变量注入问题。
-* 📱 **响应式设计**：全新的 `modern` 布局，采用网格系统（Grid），完美适配手机和电脑端浏览。
-* 🔗 **菜单自动注入**：支持将站点地图链接自动插入到主题的导航栏（适配 NexT, Butterfly, Fluid 等主流主题）。
-* 📝 **灵活配置**：独立控制分类、文章、页面模块的开关。
-* 🚫 **模糊排除**：支持通过标题或路径关键词，精准排除不需要展示的页面（如 404 页、标签页）。
-* 🎨 **多布局风格**：内置 3 种布局（Modern 现代 / Simple 简洁 / Rich 丰富）。
-* 🔧 **零乱码**：原生支持 UTF-8，完美适配中日韩等非 ASCII 字符。
-
-## 📦 安装
-
-### 方式 1：本地开发（推荐）
-
-如果您正在开发或自定义插件：
-
-1. 在 Hexo 博客根目录下创建目录：`node_modules/hexo-sitemap-html`。
-2. 将 `index.js` 和 `package.json` 放入该目录。
-3. 在**博客根目录**执行：
-```bash
-npm install ./node_modules/hexo-sitemap-html
-
-```
-
-
-
-### 方式 2：npm 安装（发布后）
-
-```bash
-npm install hexo-sitemap-html --save
-
-```
-
-## ⚙️ 配置
-
-在 Hexo 博客根目录的 `_config.yml` 中添加以下配置：
-
-```yaml
-# hexo-sitemap-html 配置
-html_sitemap:
-  path: 'sitemap.html'    # 输出路径
-  layout: 'modern'        # 布局选择: modern, simple, rich
-  inject_menu: true       # 自动将“站点地图”添加到博客导航栏
-  nofollow: true          # 为地图链接添加 rel="nofollow"，避免分散权重
-  
-  enable:
-    categories: true      # 显示分类
-    posts: true           # 显示文章
-    pages: true           # 显示独立页面
-
-  exclude:                # 排除页面（模糊匹配标题或路径）
-    - '404'
-    - 'guestbook'
-    - '关于我'
-
-```
-
-### 配置项详情
-
-| 配置项 | 类型 | 默认值 | 说明 |
-| --- | --- | --- | --- |
-| `path` | String | `sitemap.html` | 生成的文件名。 |
-| `layout` | String | `modern` | UI 风格：`modern` (响应式网格), `simple` (纯文本列表), `rich` (带动画的卡片)。 |
-| `inject_menu` | Boolean | `false` | 是否自动修改 `theme.menu` 配置，动态注入菜单链接。 |
-| `nofollow` | Boolean | `false` | 开启后，生成的链接会带上 `nofollow` 属性。 |
-| `exclude` | Array | `[]` | 关键词数组，匹配到的页面将不会出现在站点地图中。 |
-
-## 🚀 使用
-
-1. 清除并生成：
-```bash
-hexo clean && hexo generate
-
-```
-
-
-2. 本地预览：
-```bash
-hexo server
-
-```
-
-
-3. 访问：`http://localhost:4000/sitemap.html`
-
-## 🎨 布局风格预览
-
-### 1. modern（现代版 - 推荐）
-
-* **特点**：基于 CSS Grid 的卡片系统，响应式布局，极简线条感。
-* **适用**：现代技术博客、作品集。
-
-### 2. simple（简洁版）
-
-* **特点**：无装饰列表，加载速度最快。
-* **适用**：追求极致简约或极简风主题。
-
-### 3. rich（丰富版）
-
-* **特点**：带悬浮阴影（Hover Shadow）的深色卡片设计。
-* **适用**：视觉表现力强的主题。
-
-## ❓ 常见问题
-
-### Q1: 导航栏没有出现“站点地图”链接？
-
-A: `inject_menu` 功能通过内存修改主题配置实现。如果你的主题导航栏配置非常特殊（非 `menu` 或 `navbar` 字段），可能无法自动注入。建议在主题配置中手动添加一行链接。
-
-### Q2: 兼容 Node 22 吗？
-
-A: 是的。针对 Node 22 严格模式下全局 `hexo` 变量获取不到的问题，本项目采用了 Dependency Injection（依赖注入）模式重新编写了入口逻辑。
-
-### Q3: 这会影响 SEO 吗？
-
-A: 不会。此插件生成的 HTML 地图是给**人**看的（方便读者快速定位内容）。如果你需要给搜索引擎看的地图，请同时安装 `hexo-generator-sitemap` 生成 `sitemap.xml`。
-
-## 📄 许可证
-
-本项目采用 **MIT** 许可证。
-