.github/workflows/docs-deploy.yaml

@@ -13,9 +13,6 @@ on:
   workflow_dispatch:
   workflow_call:
 
-permissions:
-  contents: write
-
 jobs:
   deploy-docs:
     runs-on: ubuntu-latest

.github/workflows/example-layout-slots-deploy.yaml

@@ -6,9 +6,6 @@ on:
       - v*
   workflow_dispatch:
 
-permissions:
-  contents: write
-
 jobs:
   deploy-docs:
     runs-on: ubuntu-latest

.github/workflows/lint.yaml

@@ -8,9 +8,6 @@ on:
     branches: [main]
   workflow_call:
 
-permissions:
-  contents: read
-
 jobs:
   lint:
     runs-on: ubuntu-latest

.github/workflows/release.yaml

@@ -5,10 +5,6 @@ on:
     tags:
       - v*
 
-permissions:
-  contents: write
-  id-token: write
-
 jobs:
   lint:
     uses: ./.github/workflows/lint.yaml
@@ -20,6 +16,9 @@ jobs:
     if: github.repository == 'pengzhanbo/vuepress-theme-plume'
     needs: [test, lint]
     runs-on: ubuntu-latest
+    permissions:
+      contents: write
+      id-token: write
     steps:
       - uses: actions/checkout@v6
         with:

.github/workflows/test.yaml

@@ -8,9 +8,6 @@ on:
     branches: [main]
   workflow_call:
 
-permissions:
-  contents: read
-
 jobs:
   unit-test:
     runs-on: ubuntu-latest

.gitignore

@@ -15,6 +15,3 @@ dist/
 
 coverage/
 .idea
-
-.claude/
-!.claude/skills/

CLAUDE.md

@@ -1,111 +0,0 @@
-# CLAUDE.md
-
-This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
-
-## Project Overview
-
-vuepress-theme-plume is a VuePress 2 theme monorepo for building blogs, documentation, and knowledge bases.
-It includes a main theme, several plugins, a CLI tool, and example implementations.
-
-## Commands
-
-```bash
-# Install dependencies
-pnpm install
-
-# Build all packages (required after clone, outputs to lib/)
-pnpm build
-
-# Development - runs theme + docs dev servers concurrently
-pnpm dev
-
-# Lint (eslint + stylelint)
-pnpm lint
-pnpm lint:fix  # auto-fix
-
-# Run tests (vitest)
-pnpm test
-
-# Run a single test file
-pnpm test src/path/to/file.spec.ts
-
-# Run tests related to changed files (for pre-commit)
-cross-env TZ=Etc/UTC vitest related --run
-
-# Build docs only
-pnpm docs:build
-
-# Serve docs locally
-pnpm docs:serve
-
-# Release workflow
-pnpm release  # runs lint + build + version bump + changelog + git commit
-```
-
-## Monorepo Structure
-
-```txt
-├── theme/          # Main VuePress theme (vuepress-theme-plume)
-├── plugins/        # VuePress plugins
-│   ├── plugin-search/    # Full-text fuzzy search
-│   ├── plugin-md-power/  # Markdown enhancements
-│   └── plugin-fonts/     # Special character font support
-├── cli/            # CLI tool (create project scaffolding)
-├── docs/           # Documentation site
-└── examples/        # Example implementations
-    ├── pure-blog/
-    └── layout-slots/
-```
-
-## Theme Architecture
-
-The theme is organized into three layers:
-
-- **`src/node/`** - Build-time code (runs during `vuepress build/dev`)
-  - `prepare/` - Content preparation (frontmatter parsing, collection resolution)
-  - `plugins/` - VuePress plugin registration
-  - `config/` - Theme configuration handling
-  - `autoFrontmatter/` - Automatic frontmatter generation
-
-- **`src/client/`** - Client-side code (runs in browser)
-  - `components/` - Vue components
-  - `composables/` - Vue composables (outline, search, etc.)
-  - `styles/` - CSS/SCSS styles
-  - `features/` - Feature-specific components and logic
-
-- **`src/shared/`** - Shared code (used by both node and client)
-  - `frontmatter/` - Frontmatter schemas and utilities
-  - `locale/` - i18n translations
-  - `options.ts` - Theme options types
-  - `features/` - Feature flags and shared feature logic
-
-## Build Output
-
-Each package uses [tsdown](https://tsdown.dev/) to compile TypeScript. Build output goes to `lib/`:
-
-- `lib/node/` - Node-side exports
-- `lib/client/` - Client-side exports
-- `lib/shared/` - Shared exports
-
-The `lib/` directory is gitignored and must be built with `pnpm build`.
-
-## Testing
-
-Tests use Vitest with coverage enabled. Test files are located at `**/__test__/**/*.spec.ts` and are excluded from coverage reports. Run tests with timezone fixed to UTC to ensure consistent results.
-
-## Key Dependencies
-
-- **VuePress**: v2.0.0-rc.28 with @vuepress/bundler-vite
-- **Vue**: ^3.5.30
-- **Shiki**: ^4.x for syntax highlighting
-- **VueUse**: ^14.x for composables
-- **markdown-it**: ^14.x for Markdown processing
-
-## Development Notes
-
-- Node.js 20.19.0+ required
-- pnpm catalogs are used for dependency management (`dev`, `peer`, `prod`, `vuepress`)
-- The theme depends on `vuepress-plugin-md-power` and `@vuepress-plume/plugin-search` as workspace dependencies
-- Some peer dependencies are optional (e.g., artplayer, dashjs, three.js)
-- Plugins (`plugins/*`) do not have dev commands — changes require `pnpm build` to take effect
-- The `lib/` directory is gitignored and must be rebuilt after `pnpm install`

CONTRIBUTING.en-US.md

@@ -19,7 +19,7 @@ In the `plugins` directory:
 
 Development requirements:
 
-- [Node.js](http://nodejs.org/) version 20.19.0+
+- [Node.js](http://nodejs.org/) version 20.6.0+
 - [pnpm](https://pnpm.io/zh/) version 9+
 
 Clone the repository and install dependencies:

CONTRIBUTING.md

@@ -19,7 +19,7 @@
 
 开发要求：
 
-- [Node.js](http://nodejs.org/) version 20.19.0+
+- [Node.js](http://nodejs.org/) version 20.6.0+
 - [pnpm](https://pnpm.io/zh/) version 9+
 
 克隆代码仓库，并安装依赖：

SECURITY.md

@@ -4,8 +4,8 @@
 
 | Version          | Supported          |
 | ---------------- | ------------------ |
-| >= 1.0.0-rc.190  | :white_check_mark: |
-| < 1.0.0-rc.190   | :x:                |
+| >= 1.0.0-rc.170  | :white_check_mark: |
+| < 1.0.0-rc.170   | :x:                |
 
 ## Reporting a Vulnerability
 

cli/package.json

@@ -1,7 +1,7 @@
 {
   "name": "create-vuepress-theme-plume",
   "type": "module",
-  "version": "1.0.0-rc.196",
+  "version": "1.0.0-rc.188",
   "description": "The cli for create vuepress-theme-plume's project",
   "author": "pengzhanbo <q942450674@outlook.com> (https://github.com/pengzhanbo/)",
   "license": "MIT",
@@ -27,7 +27,7 @@
     "templates"
   ],
   "scripts": {
-    "build": "tsdown --config-loader unrun"
+    "build": "tsdown"
   },
   "dependencies": {
     "@clack/prompts": "catalog:prod",
@@ -40,8 +40,8 @@
     "sort-package-json": "catalog:prod"
   },
   "plume-deps": {
-    "vuepress": "2.0.0-rc.28",
-    "vue": "^3.5.32",
+    "vuepress": "2.0.0-rc.26",
+    "vue": "^3.5.26",
     "http-server": "^14.1.1",
     "typescript": "^5.9.3"
   },

cli/src/constants.ts

@@ -1,86 +1,27 @@
 import type { Bundler, Langs, Options } from './types.js'
 
-/**
- * Language options for VuePress configuration
- *
- * 语言选项，用于 VuePress 配置
- */
 export const languageOptions: Options<Langs> = [
   { label: 'English', value: 'en-US' },
   { label: '简体中文', value: 'zh-CN' },
 ]
 
-/**
- * Bundler options for VuePress build tool
- *
- * 构建器选项，用于 VuePress 构建工具
- */
 export const bundlerOptions: Options<Bundler> = [
   { label: 'Vite', value: 'vite' },
   { label: 'Webpack', value: 'webpack' },
 ]
 
-/**
- * Operation mode for VuePress CLI
- *
- * VuePress CLI 操作模式
- * @readonly
- * @enum {number}
- */
 export enum Mode {
-  /**
-   * Initialize existing directory
-   *
-   * 初始化现有目录
-   */
   init,
-  /**
-   * Create new project
-   *
-   * 创建新项目
-   */
   create,
 }
 
-/**
- * Deployment type for VuePress site
- *
- * VuePress 站点部署类型
- * @readonly
- * @enum {string}
- */
 export enum DeployType {
-  /**
-   * GitHub Pages deployment
-   *
-   * GitHub Pages 部署
-   */
   github = 'github',
-  /**
-   * Vercel deployment
-   *
-   * Vercel 部署
-   */
   vercel = 'vercel',
-  /**
-   * Netlify deployment
-   *
-   * Netlify 部署
-   */
   netlify = 'netlify',
-  /**
-   * Custom deployment
-   *
-   * 自定义部署
-   */
   custom = 'custom',
 }
 
-/**
- * Deployment options for hosting platforms
- *
- * 部署选项，用于托管平台
- */
 export const deployOptions: Options<DeployType> = [
   { label: 'Custom', value: DeployType.custom },
   { label: 'GitHub Pages', value: DeployType.github },

cli/src/generate.ts

@@ -8,15 +8,6 @@ import { createPackageJson } from './packageJson.js'
 import { createRender } from './render.js'
 import { getTemplate, readFiles, readJsonFile, writeFiles } from './utils/index.js'
 
-/**
- * Generate VuePress project files
- *
- * 生成 VuePress 项目文件
- *
- * @param mode - Operation mode (init or create) / 操作模式（初始化或创建）
- * @param data - Resolved configuration data / 解析后的配置数据
- * @param cwd - Current working directory / 当前工作目录
- */
 export async function generate(
   mode: Mode,
   data: ResolvedData,
@@ -115,14 +106,6 @@ export async function generate(
   })
 }
 
-/**
- * Create documentation files based on configuration
- *
- * 根据配置创建文档文件
- *
- * @param data - Resolved configuration data / 解析后的配置数据
- * @returns Array of file objects / 文件对象数组
- */
 async function createDocsFiles(data: ResolvedData): Promise<File[]> {
   const fileList: File[] = []
   if (data.multiLanguage) {
@@ -148,15 +131,6 @@ async function createDocsFiles(data: ResolvedData): Promise<File[]> {
   return updateFileListTarget(fileList, data.docsDir)
 }
 
-/**
- * Update file list target path
- *
- * 更新文件列表的目标路径
- *
- * @param fileList - Array of files / 文件数组
- * @param target - Target directory path / 目标目录路径
- * @returns Updated file array / 更新后的文件数组
- */
 function updateFileListTarget(fileList: File[], target: string): File[] {
   return fileList.map(({ filepath, content }) => ({
     filepath: path.join(target, filepath),

cli/src/index.ts

@@ -1,15 +1,3 @@
-/**
- * VuePress Theme Plume CLI Entry Point
- *
- * VuePress Theme Plume CLI 入口文件
- *
- * This module provides command-line interface for creating and initializing
- * VuePress projects with vuepress-theme-plume.
- *
- * 本模块提供用于创建和初始化 VuePress 项目的命令行接口。
- *
- * @module cli
- */
 import cac from 'cac'
 import { version } from '../package.json'
 import { Mode } from './constants.js'

cli/src/locales/en.ts

@@ -1,10 +1,5 @@
 import type { Locale } from '../types.js'
 
-/**
- * English locale configuration for CLI prompts and messages.
- *
- * CLI 提示和消息的英语本地化配置。
- */
 export const en: Locale = {
   'question.root': 'Where would you want to initialize VuePress?',
   'question.site.name': 'Site Name:',

cli/src/locales/index.ts

@@ -2,15 +2,6 @@ import type { Langs, Locale } from '../types.js'
 import { en } from './en.js'
 import { zh } from './zh.js'
 
-/**
- * Locale configurations for different languages.
- *
- * 不同语言的本地化配置。
- *
- * Maps language codes to their respective locale strings.
- *
- * 将语言代码映射到相应的本地化字符串。
- */
 export const locales: Record<Langs, Locale> = {
   'zh-CN': zh,
   'en-US': en,

cli/src/locales/zh.ts

@@ -1,10 +1,5 @@
 import type { Locale } from '../types.js'
 
-/**
- * Chinese (Simplified) locale configuration for CLI prompts and messages.
- *
- * CLI 提示和消息的简体中文本地化配置。
- */
 export const zh: Locale = {
   'question.root': '您想在哪里初始化 VuePress？',
   'question.site.name': '站点名称：',

cli/src/packageJson.ts

@@ -1,41 +1,16 @@
 import type { File, ResolvedData } from './types.js'
-import { attemptAsync, kebabCase } from '@pengzhanbo/utils'
+import { kebabCase } from '@pengzhanbo/utils'
 import spawn from 'nano-spawn'
 import _sortPackageJson from 'sort-package-json'
 import { Mode } from './constants.js'
 import { readJsonFile, resolve } from './utils/index.js'
 
-/**
- * Sort package.json fields in a consistent order.
- *
- * 按一致顺序排序 package.json 字段。
- *
- * @param json - Package.json object to sort / 要排序的 package.json 对象
- * @returns Sorted package.json object / 排序后的 package.json 对象
- */
 function sortPackageJson(json: Record<any, any>) {
   return _sortPackageJson(json, {
     sortOrder: ['name', 'type', 'version', 'private', 'description', 'packageManager', 'author', 'license', 'scripts', 'devDependencies', 'dependencies', 'pnpm'],
   })
 }
 
-/**
- * Create package.json file for VuePress project
- *
- * 为 VuePress 项目创建 package.json 文件
- *
- * @param mode - Operation mode (init or create) / 操作模式（初始化或创建）
- * @param pkg - Existing package.json data / 现有的 package.json 数据
- * @param data - Resolved configuration data / 解析后的配置数据
- * @param data.packageManager - Package manager to use / 要使用的包管理器
- * @param data.siteName - Site name / 站点名称
- * @param data.siteDescription - Site description / 站点描述
- * @param data.docsDir - Documentation directory path / 文档目录路径
- * @param data.bundler - Bundler to use / 要使用的打包器
- * @param data.injectNpmScripts - Whether to inject npm scripts / 是否注入 npm 脚本
- *
- * @returns File object with package.json content / 包含 package.json 内容的文件对象
- */
 export async function createPackageJson(
   mode: Mode,
   pkg: Record<string, any>,
@@ -55,7 +30,7 @@ export async function createPackageJson(
     pkg.description = siteDescription
 
     if (packageManager !== 'npm') {
-      let [, version] = await attemptAsync(getPackageManagerVersion, packageManager)
+      let version = await getPackageManagerVersion(packageManager)
       if (version) {
         if (packageManager === 'yarn' && version.startsWith('1')) {
           version = '4.10.3'
@@ -71,7 +46,7 @@ export async function createPackageJson(
       }
     }
 
-    const [, userInfo] = await attemptAsync(getUserInfo)
+    const userInfo = await getUserInfo()
     if (userInfo) {
       pkg.author = userInfo.username + (userInfo.email ? ` <${userInfo.email}>` : '')
     }
@@ -119,30 +94,24 @@ export async function createPackageJson(
   }
 }
 
-/**
- * Get user information from git global configuration.
- *
- * 从 git 全局配置获取用户信息。
- *
- * @returns User information object with username and email / 包含用户名和邮箱的用户信息对象
- * @throws Error if git command fails / 如果 git 命令失败则抛出错误
- */
 async function getUserInfo() {
-  const { output: username } = await spawn('git', ['config', '--global', 'user.name'])
-  const { output: email } = await spawn('git', ['config', '--global', 'user.email'])
-  return { username, email }
+  try {
+    const { output: username } = await spawn('git', ['config', '--global', 'user.name'])
+    const { output: email } = await spawn('git', ['config', '--global', 'user.email'])
+    console.log('userInfo', username, email)
+    return { username, email }
+  }
+  catch {
+    return null
+  }
 }
 
-/**
- * Get the version of a package manager.
- *
- * 获取包管理器的版本。
- *
- * @param pkg - Package manager name (npm, yarn, pnpm) / 包管理器名称
- * @returns Version string of the package manager / 包管理器的版本字符串
- * @throws Error if package manager command fails / 如果包管理器命令失败则抛出错误
- */
 async function getPackageManagerVersion(pkg: string) {
-  const { output } = await spawn(pkg, ['--version'])
-  return output
+  try {
+    const { output } = await spawn(pkg, ['--version'])
+    return output
+  }
+  catch {
+    return null
+  }
 }

cli/src/prompt.ts

@@ -2,7 +2,7 @@ import type { Bundler, Langs, PromptResult } from './types.js'
 import { createRequire } from 'node:module'
 import process from 'node:process'
 import { cancel, confirm, group, select, text } from '@clack/prompts'
-import osLocale from 'os-locale'
+import { osLocale } from 'os-locale'
 import { bundlerOptions, deployOptions, DeployType, languageOptions, Mode } from './constants.js'
 import { setLang, t } from './translate.js'
 
@@ -10,15 +10,6 @@ const require = createRequire(process.cwd())
 
 const REG_DIR_CHAR = /[<>:"\\|?*[\]]/
 
-/**
- * Prompt user for project configuration
- *
- * 提示用户输入项目配置
- *
- * @param mode - Operation mode (init or create) / 操作模式（初始化或创建）
- * @param root - Optional root directory path / 可选的根目录路径
- * @returns Resolved prompt result / 解析后的提示结果
- */
 export async function prompt(mode: Mode, root?: string): Promise<PromptResult> {
   let hasTs = false
   if (mode === Mode.init) {
@@ -30,7 +21,7 @@ export async function prompt(mode: Mode, root?: string): Promise<PromptResult> {
 
   const result: PromptResult = await group({
     displayLang: async () => {
-      const locale = osLocale()
+      const locale = await osLocale()
 
       if (locale === 'zh-CN' || locale === 'zh-Hans') {
         setLang('zh-CN')

cli/src/render.ts

@@ -2,33 +2,16 @@ import type { ResolvedData } from './types.js'
 import { kebabCase } from '@pengzhanbo/utils'
 import handlebars from 'handlebars'
 
-/**
- * Extended resolved data with additional rendering information
- *
- * 扩展的解析数据，包含额外的渲染信息
- */
 export interface RenderData extends ResolvedData {
-  /** Project name in kebab-case / 项目名称（kebab-case 格式） */
   name: string
-  /** Site name / 网站名称 */
   siteName: string
-  /** Locale configuration array / 语言配置数组 */
   locales: { path: string, lang: string, isEn: boolean, prefix: string }[]
-  /** Whether default language is English / 默认语言是否为英语 */
   isEN: boolean
 }
 
 handlebars.registerHelper('removeLeadingSlash', (path: string) => path.replace(/^\//, ''))
 handlebars.registerHelper('equal', (a: string, b: string) => a === b)
 
-/**
- * Create render function with Handlebars template engine
- *
- * 使用 Handlebars 模板引擎创建渲染函数
- *
- * @param result - Resolved configuration data / 解析后的配置数据
- * @returns Render function that processes Handlebars templates / 处理 Handlebars 模板的渲染函数
- */
 export function createRender(result: ResolvedData) {
   const data: RenderData = {
     ...result,

cli/src/run.ts

@@ -11,14 +11,6 @@ import { prompt } from './prompt.js'
 import { t } from './translate.js'
 import { getPackageManager } from './utils/index.js'
 
-/**
- * Run the CLI workflow for VuePress project initialization or creation
- *
- * 执行 VuePress 项目初始化或创建的 CLI 工作流程
- *
- * @param mode - Operation mode (init or create) / 操作模式（初始化或创建）
- * @param root - Root directory path / 根目录路径
- */
 export async function run(mode: Mode, root?: string): Promise<void> {
   intro(colors.cyan('Welcome to VuePress and vuepress-theme-plume !'))
 
@@ -78,15 +70,6 @@ export async function run(mode: Mode, root?: string): Promise<void> {
   }
 }
 
-/**
- * Resolve prompt result into final configuration data.
- *
- * 将提示结果解析为最终配置数据。
- *
- * @param result - Prompt result from user input / 用户输入的提示结果
- * @param mode - Operation mode (init or create) / 操作模式（初始化或创建）
- * @returns Resolved configuration data / 解析后的配置数据
- */
 function resolveData(result: PromptResult, mode: Mode): ResolvedData {
   return {
     ...result,

cli/src/translate.ts

@@ -6,14 +6,6 @@ interface Translate {
   t: (key: keyof Locale) => string
 }
 
-/**
- * Create a translate instance with specified language
- *
- * 创建指定语言的翻译实例
- *
- * @param lang - Language code / 语言代码
- * @returns Translate interface / 翻译接口
- */
 function createTranslate(lang?: Langs): Translate {
   let current: Langs = lang || 'en-US'
 
@@ -27,21 +19,5 @@ function createTranslate(lang?: Langs): Translate {
 
 const translate = createTranslate()
 
-/**
- * Get translated string by key
- *
- * 根据键获取翻译后的字符串
- *
- * @param key - Locale key / 本地化键名
- * @returns Translated string / 翻译后的字符串
- */
 export const t: Translate['t'] = translate.t
-
-/**
- * Set current language
- *
- * 设置当前语言
- *
- * @param lang - Language code to set / 要设置的语言代码
- */
 export const setLang: Translate['setLang'] = translate.setLang

cli/src/types.ts

@@ -1,276 +1,57 @@
 import type { DeployType } from './constants.js'
 
-/**
- * Supported language codes for VuePress site
- *
- * VuePress 站点支持的语言代码
- */
 export type Langs = 'zh-CN' | 'en-US'
 
-/**
- * Locale configuration for CLI prompts and messages
- *
- * CLI 提示和消息的国际化配置
- */
 export interface Locale {
-  /**
-   * Question: Project root directory name
-   *
-   * 问题：项目根目录名称
-   */
   'question.root': string
-  /**
-   * Question: Site name
-   *
-   * 问题：站点名称
-   */
   'question.site.name': string
-  /**
-   * Question: Site description
-   *
-   * 问题：站点描述
-   */
   'question.site.description': string
-  /**
-   * Question: Enable multi-language support
-   *
-   * 问题：启用多语言支持
-   */
   'question.multiLanguage': string
-  /**
-   * Question: Default language
-   *
-   * 问题：默认语言
-   */
   'question.defaultLanguage': string
-  /**
-   * Question: Build tool bundler
-   *
-   * 问题：构建工具
-   */
   'question.bundler': string
-  /**
-   * Question: Use TypeScript
-   *
-   * 问题：使用 TypeScript
-   */
   'question.useTs': string
-  /**
-   * Question: Inject npm scripts
-   *
-   * 问题：注入 npm 脚本
-   */
   'question.injectNpmScripts': string
-  /**
-   * Question: Initialize git repository
-   *
-   * 问题：初始化 git 仓库
-   */
   'question.git': string
-  /**
-   * Question: Deployment type
-   *
-   * 问题：部署类型
-   */
   'question.deploy': string
-  /**
-   * Question: Install dependencies
-   *
-   * 问题：安装依赖
-   */
   'question.installDeps': string
 
-  /**
-   * Spinner: Start message
-   *
-   * 加载动画：开始消息
-   */
   'spinner.start': string
-  /**
-   * Spinner: Stop message
-   *
-   * 加载动画：停止消息
-   */
   'spinner.stop': string
-  /**
-   * Spinner: Git init message
-   *
-   * 加载动画：Git 初始化消息
-   */
   'spinner.git': string
-  /**
-   * Spinner: Install message
-   *
-   * 加载动画：安装消息
-   */
   'spinner.install': string
-  /**
-   * Spinner: Command hint message
-   *
-   * 加载动画：命令提示消息
-   */
   'spinner.command': string
 
-  /**
-   * Hint: Cancel operation
-   *
-   * 提示：取消操作
-   */
   'hint.cancel': string
-  /**
-   * Hint: Root directory
-   *
-   * 提示：根目录
-   */
   'hint.root': string
-  /**
-   * Hint: Illegal root directory name
-   *
-   * 提示：非法的根目录名称
-   */
   'hint.root.illegal': string
 }
 
-/**
- * Package manager types
- *
- * 包管理器类型
- */
 export type PackageManager = 'npm' | 'yarn' | 'pnpm'
-
-/**
- * Build tool bundler types
- *
- * 构建工具类型
- */
 export type Bundler = 'vite' | 'webpack'
 
-/**
- * Generic options type for CLI prompts
- *
- * CLI 提示的通用选项类型
- *
- * @template Value - The value type for options
- * @template Label - The label type for options
- */
 export type Options<Value = string, Label = string> = { label: Label, value: Value }[]
 
-/**
- * File structure for generated project
- *
- * 生成项目的文件结构
- */
 export interface File {
-  /**
-   * File path relative to project root
-   *
-   * 相对于项目根目录的文件路径
-   */
   filepath: string
-  /**
-   * File content
-   *
-   * 文件内容
-   */
   content: string
 }
 
-/**
- * Result from CLI prompts
- *
- * CLI 提示结果
- */
 export interface PromptResult {
-  /**
-   * CLI display language
-   *
-   * CLI 显示语言
-   */
-  displayLang: string
-  /**
-   * Project root directory name
-   *
-   * 项目根目录名称
-   */
+  displayLang: string // cli display language
   root: string
-  /**
-   * Site name
-   *
-   * 站点名称
-   */
   siteName: string
-  /**
-   * Site description
-   *
-   * 站点描述
-   */
   siteDescription: string
-  /**
-   * Build tool bundler
-   *
-   * 构建工具
-   */
   bundler: Bundler
-  /**
-   * Enable multi-language support
-   *
-   * 启用多语言支持
-   */
   multiLanguage: boolean
-  /**
-   * Default language
-   *
-   * 默认语言
-   */
   defaultLanguage: Langs
-  /**
-   * Use TypeScript
-   *
-   * 使用 TypeScript
-   */
   useTs: boolean
-  /**
-   * Inject npm scripts
-   *
-   * 注入 npm 脚本
-   */
   injectNpmScripts: boolean
-  /**
-   * Deployment type
-   *
-   * 部署类型
-   */
   deploy: DeployType
-  /**
-   * Initialize git repository
-   *
-   * 初始化 git 仓库
-   */
   git: boolean
-  /**
-   * Install dependencies
-   *
-   * 安装依赖
-   */
   install: boolean
 }
 
-/**
- * Resolved data after processing prompts
- *
- * 处理提示后的解析数据
- */
 export interface ResolvedData extends PromptResult {
-  /**
-   * Selected package manager
-   *
-   * 选择的包管理器
-   */
   packageManager: PackageManager
-  /**
-   * Documentation directory name
-   *
-   * 文档目录名称
-   */
   docsDir: string
 }

cli/src/utils/fs.ts

@@ -2,14 +2,6 @@ import type { File } from '../types.js'
 import fs from 'node:fs/promises'
 import path from 'node:path'
 
-/**
- * Read all files from a directory recursively
- *
- * 递归读取目录下的所有文件
- *
- * @param root - Root directory path to read from / 要读取的根目录路径
- * @returns Array of file objects / 文件对象数组
- */
 export async function readFiles(root: string): Promise<File[]> {
   const filepaths = await fs.readdir(root, { recursive: true })
   const files: File[] = []
@@ -26,15 +18,6 @@ export async function readFiles(root: string): Promise<File[]> {
   return files
 }
 
-/**
- * Write files to target directory
- *
- * 将文件写入目标目录
- *
- * @param files - Array of file objects to write / 要写入的文件对象数组
- * @param target - Target directory path / 目标目录路径
- * @param rewrite - Optional function to rewrite file paths / 可选的文件路径重写函数
- */
 export async function writeFiles(
   files: File[],
   target: string,
@@ -49,14 +32,6 @@ export async function writeFiles(
   }
 }
 
-/**
- * Read and parse JSON file
- *
- * 读取并解析 JSON 文件
- *
- * @param filepath - Path to JSON file / JSON 文件路径
- * @returns Parsed JSON object or null if parsing fails / 解析后的 JSON 对象，解析失败返回 null
- */
 export async function readJsonFile<T extends Record<string, any> = Record<string, any>>(filepath: string): Promise<T | null> {
   try {
     const content = await fs.readFile(filepath, 'utf-8')

cli/src/utils/getPackageManager.ts

@@ -1,19 +1,6 @@
 import type { PackageManager } from '../types.js'
 import process from 'node:process'
 
-/**
- * Detect the current package manager from environment variables.
- *
- * 从环境变量检测当前使用的包管理器。
- *
- * @returns The detected package manager name / 检测到的包管理器名称
- * @example
- * // When using pnpm
- * const pm = getPackageManager() // returns 'pnpm'
- *
- * // When using npm
- * const pm = getPackageManager() // returns 'npm'
- */
 export function getPackageManager(): PackageManager {
   const name = process.env?.npm_config_user_agent || 'npm'
   return name.split('/')[0] as PackageManager

cli/src/utils/index.ts

@@ -3,24 +3,8 @@ import { fileURLToPath } from 'node:url'
 
 export const __dirname: string = path.dirname(fileURLToPath(import.meta.url))
 
-/**
- * Resolve path relative to the project root
- *
- * 相对于项目根目录解析路径
- *
- * @param args - Path segments to resolve / 要解析的路径段
- * @returns Resolved absolute path / 解析后的绝对路径
- */
 export const resolve = (...args: string[]): string => path.resolve(__dirname, '../', ...args)
 
-/**
- * Get template directory path
- *
- * 获取模板目录路径
- *
- * @param dir - Subdirectory name within templates / templates 中的子目录名称
- * @returns Resolved template directory path / 解析后的模板目录路径
- */
 export const getTemplate = (dir: string): string => resolve('templates', dir)
 
 export * from './fs.js'

cli/templates/docs/en/blog/preview/markdown.md

@@ -81,7 +81,7 @@ content right
 
 **demo wrapper：**
 
-::: window title="Demo" height="200px"
+::: demo-wrapper title="Demo" no-padding height="200px"
 <style scoped>
 .open-door {
   display: flex;

cli/templates/docs/zh/blog/preview/markdown.md

@@ -95,9 +95,9 @@ H~2~O
 - vscode - <Icon name="skill-icons:vscode-dark" size="2em" />
 - twitter - <Icon name="skill-icons:twitter" size="2em" />
 
-**示例容器：**
+**demo wrapper：**
 
-::: window title="示例" height="200px"
+::: demo-wrapper title="示例" no-padding height="200px"
 <style scoped>
 .open-door {
   display: flex;

docs/.vuepress/collections/en/theme-guide.ts

@@ -69,7 +69,6 @@ export const themeGuide: ThemeCollectionItem = defineCollection({
             'chat',
             'include',
             'env',
-            'obsidian',
           ],
         },
         {

docs/.vuepress/collections/zh/theme-guide.ts

@@ -69,7 +69,6 @@ export const themeGuide: ThemeCollectionItem = defineCollection({
             'chat',
             'include',
             'env',
-            'obsidian',
           ],
         },
         {

docs/.vuepress/navbar.ts

@@ -94,7 +94,7 @@ export const enNavbar: ThemeNavItem[] = defineNavbarConfig([
   {
     text: `${version}`,
     icon: 'codicon:versions',
-    badge: 'New',
+    badge: '新',
     items: [
       { text: 'Changelog', link: '/en/changelog/' },
       { text: 'Contributing', link: '/en/contributing/' },

docs/.vuepress/theme.ts

@@ -58,7 +58,6 @@ export const theme: Theme = plumeTheme({
     jsfiddle: true,
     demo: true,
     encrypt: true,
-    obsidian: true,
     npmTo: ['pnpm', 'yarn', 'npm'],
     repl: {
       go: true,

docs/README.md

@@ -5,7 +5,7 @@ config:
   -
     type: hero
     full: true
-    effect: hyper-speed
+    effect: lightning
     forceDark: true
     hero:
       name: Theme Plume

docs/blog/1.示例/markdown基础.md

@@ -401,7 +401,7 @@ end tell
 在代码块里面， `&` 、 `<` 和 `>` 会自动转成 HTML 实体，这样的方式让你非常容易使用 Markdown 插入范例用的 HTML 原始码，只需要复制粘贴，再加上缩进就可以了，剩下的 Markdown 都会帮你处理，例如:
 
 ````md
-```html
+```
 <div class="footer">
   &copy; 2004 Foo Corporation
 </div>

docs/blog/1.示例/markdown扩展.md

@@ -239,7 +239,7 @@ Shiki 支持多种编程语言。需要做的就是将有效的语言别名附
 
 **输入：**
 
-````md
+````
 ```js
 export default {
   name: 'MyComponent',
@@ -248,7 +248,7 @@ export default {
 ```
 ````
 
-````md
+````
 ```html
 <ul>
   <li v-for="todo in todos" :key="todo.id">
@@ -281,7 +281,7 @@ export default {
 
 **输入：**
 
-````md
+````
 ```js{4}
 export default {
   data () {
@@ -313,7 +313,7 @@ export default {
 
 **输入：**
 
-````md
+````
 ```js{1,4,6-8}
 export default { // Highlighted
   data () {
@@ -349,10 +349,10 @@ export default { // Highlighted
 
 **输入：**
 
-````md
+````
 ```js
 export default {
-  data() {
+  data () {
     return {
       msg: 'Highlighted!' // [\!code highlight]
     }
@@ -381,10 +381,10 @@ export default {
 
 **输入：**
 
-````md
+````
 ```js
 export default {
-  data() {
+  data () {
     return {
       msg: 'Focused!' // [\!code focus]
     }
@@ -411,10 +411,10 @@ export default {
 
 **输入：**
 
-````md
+````
 ```js
 export default {
-  data() {
+  data () {
     return {
       remove: 'Removed', // [\!code --]
       add: 'Added' // [\!code ++]
@@ -443,10 +443,10 @@ export default {
 
 **输入：**
 
-````md
+````
 ```js
 export default {
-  data() {
+  data () {
     return {
       error: 'Error', // [\!code error]
       warning: 'Warning' // [\!code warning]
@@ -473,7 +473,7 @@ export default {
 
 **输入：**
 
-````md
+````
 ```ts
 export function foo() { // [\!code word:Hello]
   const msg = 'Hello World'
@@ -495,7 +495,7 @@ export function foo() { // [!code word:Hello]
 
 **输入：**
 
-````md
+````
 ```ts
 // [\!code word:options:2]
 const options = { foo: 'bar' }
@@ -613,7 +613,7 @@ export default config
 
 **输入：**
 
-````md
+````
 When $a \ne 0$, there are two solutions to $(ax^2 + bx + c = 0)$ and they are
 $$ x = {-b \pm \sqrt{b^2-4ac} \over 2a} $$
 
@@ -711,7 +711,7 @@ vuepress-theme-plume 是一个 ==简洁美观== 的 主题
 这将为图片添加 一个 名为 `full-width` 的 class 属性，以及一个 `width` 属性，值为 `100%`。
 
 ```md
-![alt text](/plume.png){.full-width width="100%"}
+![](/plume.png){.full-width width="100%"}
 ```
 
 同时也支持其他属性:

docs/blog/2.preview/主题效果预览.md

@@ -102,9 +102,9 @@ H~2~O
 - vscode - <Icon name="skill-icons:vscode-dark" size="2em" />
 - twitter - <Icon name="skill-icons:twitter" size="2em" />
 
-**示例容器：**
+**demo wrapper：**
 
-::: window title="示例" height="200px"
+::: demo-wrapper title="示例" no-padding height="200px"
 <style scoped>
 .open-door {
   display: flex;

docs/blog/4.教程/frontmatter.md

@@ -266,7 +266,7 @@ books:
     - 1984:
         author: *gOrwell
     - animal-farm:
-        author:*gOrwell
+        author: *gOrwell
 ---
 ```
 

docs/config/intro.md

@@ -82,7 +82,7 @@ export default defineUserConfig({
 
 主题提供了 `plume.config.ts` 配置文件，==对该文件的修改支持热更新，无需重启服务=={.tip} ::twemoji:confetti-ball::。
 
-您可以在其中配置支持热更新的字段，如 `navbar`、`profile` 等。
+你可以在其中配置支持热更新的字段，如 `navbar`、`profile` 等。
 
 ::: tip
 这些字段仍可在 VuePress 配置文件的 `theme` 中配置，但主题配置文件的设置最终会合并到主配置中。

docs/config/locales.md

@@ -6,7 +6,7 @@ permalink: /config/locales/
 
 这些选项用于配置与语言相关的文本。
 
-如果您的站点是以非内置语言支持以外的其他语言提供服务的，您应该为每个语言设置这些选项来提供翻译。
+如果你的站点是以非内置语言支持以外的其他语言提供服务的，你应该为每个语言设置这些选项来提供翻译。
 
 ## 内置语言支持
 

docs/config/markdown.md

@@ -149,7 +149,7 @@ export default defineUserConfig({
 - **默认值**: `{ provider: 'iconify' }`
 - **详情**: 图标配置
 
-  [查看 **icon** 使用说明](../guide/features/icon.md){.read-more}
+  [查看 **icon** 使用说明](../../theme/guide/features/icon.md){.read-more}
 
 ### plot
 

docs/config/navbar.md

@@ -11,7 +11,7 @@ permalink: /config/navigation/
 
 主题默认会自动生成最简单的导航栏配置，仅包括 **首页** 和 **文章列表页** 。
 
-您也可以自己配置导航栏，覆盖默认的导航栏配置。
+你也可以自己配置导航栏，覆盖默认的的导航栏配置。
 
 默认配置如下：
 

docs/config/plugins/search.md

@@ -82,7 +82,6 @@ interface SearchBoxLocale {
 ### 启用
 
 ```ts title=".vuepress/config.ts" twoslash
-// @errors: 2353
 import { defineUserConfig } from 'vuepress'
 import { plumeTheme } from 'vuepress-theme-plume'
 

docs/config/plugins/watermark.md

@@ -13,7 +13,6 @@ permalink: /config/watermark/
 ## 使用
 
 ```ts title=".vuepress/config.ts" twoslash
-// @errors: 7006
 import { defineUserConfig } from 'vuepress'
 import { plumeTheme } from 'vuepress-theme-plume'
 

docs/config/theme.md

@@ -14,7 +14,8 @@ permalink: /config/theme/
 ::: warning 该字段不支持在 [主题配置文件 `plume.config.js`](./intro.md#主题配置文件) 中进行配置。
 :::
 
-无以上声明的字段，您可以在 `.vuepress/config.ts` 或者 `.vuepress/plume.config.ts` 的任意一个文件中进行配置，一般情况下建议在 `.vuepress/plume.config.ts` 中进行配置。
+无以上声明的字段，你可以在 `.vuepress/config.ts` 或者 `.vuepress/plume.config.ts` 的任意一个文件中
+进行配置，一般情况下建议在 `.vuepress/plume.config.ts` 中进行配置。
 
 ::: warning 已经在一个配置文件中进行配置的字段，尽量不要在另一个配置文件中重复配置
 :::
@@ -440,9 +441,9 @@ export default defineUserConfig({
 
   :::
 
-  [您可以在这里查看 **simple-icons** 所有可用图标](https://icon-sets.iconify.design/simple-icons/){.readmore}
+  [你可以在这里查看 **simple-icons** 所有可用图标](https://icon-sets.iconify.design/simple-icons/){.readmore}
 
-如果 **Iconify** 无法满足您的需求，可以传入 `{ svg: string, name?: string }` 格式使用自定义图标，传入 SVG 源码字符串，可选 `name` 字段用于配置 [`navbarSocialInclude`](#navbarsocialinclude)
+  如果 **Iconify** 无法满足你的需求，可以传入 `{ svg: string, name?: string }`的格式，使用自定义图标，传入 svg 源码字符串，可选 `name` 字段，用于配置 [`navbarSocialInclude`](#navbarsocialinclude)
 
 示例：
 

docs/demos.md

@@ -28,9 +28,9 @@ docs:
   -
     name: 哦麦 MC
     desc: 我的世界教学文档。
-    logo: https://s.xc.life/img/img/minecraft-154749_1280.png
+    logo: https://static.ohmymc.com/img/minecraft-154749_1280.png?max_width=1920&max_height=1920
     url: https://ohmymc.com/
-    preview: https://s.xc.life/img/img/20241228225159139.png
+    preview: https://static.ohmymc.com/img/20241228225159139.png?max_width=1920&max_height=1920
   -
     name: NcatBotDocs
     desc: NcatBot，一个 QQ 机器人框架项目的使用文档。
@@ -93,12 +93,6 @@ docs:
     logo: https://official.skycraft.cn/i/3.jpg
     url: https://docs.skycraft.cn/
     preview: https://bbsimage.skycraft.cn/docs-preview.jpg
-  -
-    name: mcenahle Docs
-    desc: mcenahle 的文档网站。
-    logo: https://d.mcenahle.cn/images/logo.png
-    url: https://d.mcenahle.cn/
-    preview: https://mcenahle.cn/resources/docs-site-preview.jpg
 
 blog:
   -
@@ -224,9 +218,9 @@ blog:
     name: 𝙁𝙡𝙖𝙨𝙝
     desc: 路漫漫其修远兮，吾将上下而求索
     logo: https://haipeng-lin.cn/images/avatar.jpg
-    url: https://blog.haipeng-lin.cn
+    url: https://haipeng-lin.cn
     repo: https://gitee.com/linhaipengg
-    preview: https://img.haipeng-lin.cn/index.webp
+    preview: https://img.haipeng-lin.cn/1768622018580.png
   -
     name: PinkDopeyBug
     desc: 山难现浮槎，心易陷镜花。
@@ -275,13 +269,6 @@ blog:
     logo: https://raw.githubusercontent.com/Konata9/pic-base/main/pics/20260126223726455.png
     url: https://konata9.cc/
     preview: https://raw.githubusercontent.com/Konata9/pic-base/main/pics/20260125225910673.webp
-  -
-    name: Esyka
-    desc: Esyka's Blog
-    logo: https://www.esyka.top/images/logo.png
-    url: https://www.esyka.top/
-    repo: https://github.com/esyka114514
-    preview: https://www.esyka.top/images/preview.png
 ---
 
 :::important

docs/en/README.md

@@ -1,11 +1,10 @@
 ---
 pageLayout: home
-title: Vuepress Theme Plume
 config:
   -
     type: hero
     full: true
-    effect: hyper-speed
+    effect: lightning
     forceDark: true
     hero:
       name: Theme Plume
@@ -38,7 +37,7 @@ config:
       -
         title: Multi-language
         icon: twemoji:balance-scale
-        details: Built-in support for 7 languages including Chinese and English, and you can customize and add more language support
+        details: Built-in support for Chinese/English, and you can customize and add more language support
       -
         title: Dual Color Theme
         icon: twemoji:cityscape
@@ -58,7 +57,7 @@ config:
       -
         title: Markdown Enhancement
         icon: twemoji:writing-hand-light-skin-tone
-        details: Based on regular markdown syntax, adds dozens of enhanced syntaxes such as custom containers, file trees, code groups, etc.
+        details: Supports Markdown syntax, code block grouping, hint containers, task lists, mathematical formulas, code demonstrations, etc.
   -
     type: image-text
     title: Features
@@ -70,7 +69,7 @@ config:
         description: Add tags, categories, word count, reading time, writing date, and other information to articles.
       -
         title: Comments
-        description: "Supports 4 comment systems: Giscus, Waline, Twikoo, Artalk<br>You can freely choose the comment system that suits your needs."
+        description: Supports 4 comment systems： Giscus, Waline, Twikoo, Artalk<br>You can freely choose the comment system that suits your needs.
       -
         title: Search
         description: Supports local search based on minisearch, and also supports Algolia search.
@@ -82,7 +81,7 @@ config:
         description: Code copying, CodePen demonstration, JSFiddle demonstration, CodeSandbox demonstration, code groups, line highlighting, line focusing, line warnings, difference comparison, code block folding, etc.
       -
         title: Resource Embedding
-        description: "Charts: chart.js/ECharts/Mermaid/flowchart<br>Videos: Bilibili/Youtube/ArtPlayer<br>PDF, 200K+ Iconify icons"
+        description: Charts：chart.js/ECharts/Mermaid/flowchart<br>Videos：Bilibili/Youtube/ArtPlayer<br>PDF, 200K+ Iconify icons
   -
     type: text-image
     title: Blog
@@ -117,48 +116,64 @@ config:
 <div style="max-width: 960px;margin:0 auto;" class="home-custom-content">
 
 ::: center
+![GitHub Repo stars](https://img.shields.io/github/stars/pengzhanbo/vuepress-theme-plume)
+![npm version](https://img.shields.io/npm/v/vuepress-theme-plume?color=32A9C3&labelColor=1B3C4A&label=npm)
+![npm downloads](https://img.shields.io/npm/dm/vuepress-theme-plume?color=32A9C3&labelColor=1B3C4A&label=downloads)
+![npm downloads](https://img.shields.io/npm/dt/vuepress-theme-plume?color=32A9C3&labelColor=1B3C4A&label=downloads)
+![github license](https://img.shields.io/github/license/pengzhanbo/vuepress-theme-plume?color=32A9C3&labelColor=1B3C4A)
 
-![GitHub Repo stars](https://img.shields.io/github/stars/pengzhanbo/vuepress-theme-plume){.no-view}
-![npm version](https://img.shields.io/npm/v/vuepress-theme-plume?color=32A9C3&labelColor=1B3C4A&label=npm){.no-view}
-![npm downloads](https://img.shields.io/npm/dm/vuepress-theme-plume?color=32A9C3&labelColor=1B3C4A&label=downloads){.no-view}
-![npm downloads](https://img.shields.io/npm/dt/vuepress-theme-plume?color=32A9C3&labelColor=1B3C4A&label=downloads){.no-view}
-![github license](https://img.shields.io/github/license/pengzhanbo/vuepress-theme-plume?color=32A9C3&labelColor=1B3C4A){.no-view}
-
-![peer dependency](https://img.shields.io/npm/dependency-version/vuepress-theme-plume/peer/vuepress?color=32A9C3&labelColor=1B3C4A){.no-view}
-![codecov](https://codecov.io/gh/pengzhanbo/vuepress-theme-plume/graph/badge.svg?token=W6KYBX7WO5){.no-view}
-
+![peer dependency](https://img.shields.io/npm/dependency-version/vuepress-theme-plume/peer/vuepress?color=32A9C3&labelColor=1B3C4A)
+![codecov](https://codecov.io/gh/pengzhanbo/vuepress-theme-plume/graph/badge.svg?token=W6KYBX7WO5)
 :::
 
-### Usage
+### Installation
 
-Use the following command to quickly create a new ==VuePress== project using this theme.
-
-:::npm-to
+:::code-tabs
+@tab pnpm
 
 ```sh
-npm create vuepress-theme-plume@latest
+pnpm add vuepress@next vuepress-theme-plume vue
+```
+
+@tab npm
+
+```sh
+npm install vuepress@next vuepress-theme-plume
+```
+
+@tab yarn
+
+```sh
+yarn add vuepress@next vuepress-theme-plume
 ```
 
 :::
 
-### Start the project
+### Configuration
 
-::: npm-to
+::: code-tabs
+@tab .vuepress/config.ts
 
-```sh
-npm run docs:dev
+```ts :no-line-numbers
+import { defineUserConfig } from 'vuepress'
+import { plumeTheme } from 'vuepress-theme-plume'
+
+export default defineUserConfig({
+  // vuepress config...
+  theme: plumeTheme({
+    // theme config...
+  })
+})
 ```
 
 :::
 
-### Changelog
+### Update Log
 
-[Changelog](./changelog)
+[Changelog](../changelog)
 
 ### Contributors
 
-Thanks to all contributors!
-
 <Contributors :contributors="data" />
 
 </div>

docs/en/blog/4.Tutorials/frontmatter.md

@@ -269,7 +269,7 @@ books:
     - 1984:
         author: *gOrwell
     - animal-farm:
-        author:*gOrwell
+        author: *gOrwell
 ---
 ```
 

docs/en/config/collections.md

@@ -124,8 +124,8 @@ export default defineUserConfig({
       '/': {
         // Chinese collection configuration // [!code focus:4]
         collections: [
-          { type: 'post', dir: 'blog', title: 'Blog' },
-          { type: 'doc', dir: 'typescript', title: 'TypeScript Notes', sidebar: 'auto' }
+          { type: 'post', dir: 'blog', title: '博客' },
+          { type: 'doc', dir: 'typescript', title: 'TypeScript笔记', sidebar: 'auto' }
         ],
       },
       '/en/': {
@@ -150,8 +150,8 @@ export default defineThemeConfig({
     '/': {
       // Chinese collection configuration // [!code focus:4]
       collections: [
-        { type: 'post', dir: 'blog', title: 'Blog' },
-        { type: 'doc', dir: 'typescript', title: 'TypeScript Notes', sidebar: 'auto' }
+        { type: 'post', dir: 'blog', title: '博客' },
+        { type: 'doc', dir: 'typescript', title: 'TypeScript笔记', sidebar: 'auto' }
       ],
     },
     '/en/': {

docs/en/config/markdown.md

@@ -159,7 +159,7 @@ The `include` configuration is implemented by the
 - **Default:** `{ provider: 'iconify' }`
 - **Details:** Icon configuration.
 
-  [View **icon** usage instructions](../guide/features/icon.md){.read-more}
+  [View **icon** usage instructions](../../theme/guide/features/icon.md){.read-more}
 
 ### plot
 

docs/en/config/plugins/search.md

@@ -82,7 +82,6 @@ Refer to [Algolia DocSearch Reference](/guide/features/content-search/#algolia-d
 ### Enable
 
 ```ts title=".vuepress/config.ts" twoslash
-// @errors: 2353
 import { defineUserConfig } from 'vuepress'
 import { plumeTheme } from 'vuepress-theme-plume'
 

docs/en/config/plugins/watermark.md

@@ -13,7 +13,6 @@ Related plugin: [@vuepress/plugin-watermark](https://ecosystem.vuejs.press/zh/pl
 ## Usage
 
 ```ts title=".vuepress/config.ts" twoslash
-// @errors: 7006
 import { defineUserConfig } from 'vuepress'
 import { plumeTheme } from 'vuepress-theme-plume'
 

docs/en/demos.md

@@ -1,294 +0,0 @@
----
-title: Demos
-createTime: 2025/10/08 19:22:07
-permalink: /en/demos/
-readingTime: false
-prev: false
-next: false
-article: false
-externalLinkIcon: false
-contributors: false
-changelog: false
-search: false
-docs:
-  -
-    name: VuePress Plume
-    desc: A simple, feature-rich VuePress documentation & blog theme.
-    logo: /plume.png
-    url: https://theme-plume.vuejs.press
-    repo: https://github.com/pengzhanbo/vuepress-theme-plume
-    preview: /images/demos/plume.jpg
-  -
-    name: city walk
-    desc: An open data platform dedicated to gathering outdoor activity locations and cultural venues from over 350 cities across the country.
-    logo: https://pub-187e90a3327b41ccb8869558b6b8bbc0.r2.dev/city-shenzhen/2024/12/0a08e9417033ccaf116fb71cfc7bcdb9.png
-    url: https://shenzhen.citywalk.group/
-    repo: https://github.com/sunshang-hl/CityWalk
-    preview: https://pub-187e90a3327b41ccb8869558b6b8bbc0.r2.dev/city-shenzhen/2024/12/ed251c4438f722dffd6cb95db86c0d56.jpg
-  -
-    name: Oh My MC
-    desc: Minecraft tutorial documentation.
-    logo: https://static.ohmymc.com/img/minecraft-154749_1280.png?max_width=1920&max_height=1920
-    url: https://ohmymc.com/
-    preview: https://static.ohmymc.com/img/20241228225159139.png?max_width=1920&max_height=1920
-  -
-    name: NcatBotDocs
-    desc: Documentation for NcatBot, a QQ bot framework project.
-    logo: https://docs.ncatbot.xyz/images/logo.png
-    url: https://docs.ncatbot.xyz
-    repo: https://github.com/Isaaczhr/NcatBotDocs
-    preview: https://docs.ncatbot.xyz/images/preview.jpg
-  -
-    name: PGuide Docs
-    desc: A localized university guide related to self-study in computer science, campus life, and open public services.
-    logo: https://docs.pguide.studio/logo.svg
-    url: https://docs.pguide.studio
-    repo: https://github.com/PGuideDev/PGuide-Docs
-    preview: https://cos-global.pguide.cloud/pguide-docs/src/pguide-doc.png
-  -
-    name: Documentation Center | Shougan Interactive
-    desc: Shougan Interactive is a professional platform for live questions, voting, and large-screen interactions, providing one-stop interactive solutions for lecturers, hosts, and conference organizers
-    logo: https://docs.shougan.net/images/logo.png
-    url: https://docs.shougan.net
-    repo: https://github.com/SuJingnan/vuepress-theme-plume
-    preview: https://docs.shougan.net/images/docs-proview.png
-  -
-    name: Search-Rec-Ads Cosmos Explorer
-    desc: Explore the fascinating universe of search, recommendation, and advertising algorithms
-    logo: https://raw.githubusercontent.com/1985312383/search-rec-ads-cosmos-explorer/refs/heads/main/docs/.vuepress/public/img/favicon.png
-    url: https://1985312383.github.io/search-rec-ads-cosmos-explorer/
-    repo: https://github.com/1985312383/search-rec-ads-cosmos-explorer
-    preview: https://raw.githubusercontent.com/1985312383/search-rec-ads-cosmos-explorer/refs/heads/main/docs/.vuepress/public/img/preview.jpg
-  -
-    name: MaaAssistantArknights Documentation Site
-    desc: Arknights assistant, automatic farming, smart base shifts, one-click daily tasks
-    logo: https://cdn.jsdelivr.net/gh/MaaAssistantArknights/design@main/logo/maa-logo_128x128.jpg
-    url: https://docs.maa.plus
-    repo: https://github.com/MaaAssistantArknights/MaaAssistantArknights/tree/dev/docs
-    preview: https://docs.maa.plus/images/preview.jpg
-  -
-    name: Python Beginner Docs
-    desc: Beginner-friendly Python 3 documentation
-    logo: https://python.yxzl.dev/python-logo-only.svg
-    url: https://python.yxzl.dev/
-    repo: https://github.com/yxzlwz/python-doc-web
-    preview: https://python.yxzl.dev/screenshot.png
-  -
-    name: TinyPiXOS
-    desc: A domestically developed, lightweight, and highly customizable embedded mobile device desktop OS!
-    logo: https://file.tinypixos.com/tinypixos/tplogo.svg
-    url: https://www.tinypixos.com/
-    repo: https://github.com/TinyPiXOS/TinyPiXOS
-    preview: https://file.tinypixos.com/tinypixos/plume_theme_case.jpg
-  -
-    name: HEUOpenResource
-    desc: Harbin Engineering University Resource Sharing Program
-    logo: https://cdn.jsdelivr.net/gh/HEUOpenResource/HEUOpenResource.github.io@main/docs/.vuepress/public/avatar.jpg
-    url: https://heu.us.kg/
-    repo: https://github.com/HEUOpenResource/HEUOpenResource.github.io
-    preview: https://cdn.jsdelivr.net/gh/HEUOpenResource/HEUOpenResource.github.io@main/docs/.vuepress/public/intro.png
-  -
-    name: SKYCRAFT Server Docs
-    desc: Documentation for Minecraft server SKYCRAFT.
-    logo: https://official.skycraft.cn/i/3.jpg
-    url: https://docs.skycraft.cn/
-    preview: https://bbsimage.skycraft.cn/docs-preview.jpg
-
-blog:
-  -
-    name: Peng Zhanbo
-    desc: Even if slow, keep going; even if you fall behind, even if you fail, you must be able to reach your goal.
-    logo: https://pengzhanbo.cn/images/blogger-fav.png
-    url: https://pengzhanbo.cn/
-    repo: https://github.com/pengzhanbo/pengzhanbo.cn
-    preview: /images/demos/pengzhanbo.webp
-  -
-    name: Er Mao Zi
-    desc: An honest Er Mao Zi, never talks nonsense
-    logo: https://www.ermao.net/images/logo.svg
-    url: https://www.ermao.net/
-    repo: https://github.com/ermaozi
-    preview: /images/demos/ermao.net.png
-  -
-    name: Keep It Simple
-    desc: Entities should not be multiplied beyond necessity
-    logo: https://www.dingyuqi.com/icon/icon.ico
-    url: https://dingyuqi.com
-    repo: https://github.com/dingyuqi
-    preview: https://www.dingyuqi.com/back-ground/site-home-page.png
-  -
-    name: Tu Yongtao
-    desc: The farther you go in your mind, the more stable you walk in reality!
-    logo: http://tuyongtao.top/fettjob/imgs/head.jpg
-    url: http://tuyongtao.top/fettjob/
-    repo: https://github.com/tuyongtao-T
-    preview: /images/demos/tuyongtao.top.jpeg
-  -
-    name: Hoey
-    desc: Teacher, I really want to improve.
-    logo: https://zhenghaoyang.cn/avatar.jpg
-    url: https://zhenghaoyang.cn/
-    repo: https://github.com/zhenghaoyang24
-    preview: https://zhenghaoyang.cn/siteshot.png
-  -
-    name: IXYZ
-    desc: Hi, there
-    logo: https://ixyz.org/favicon.ico
-    url: https://ixyz.org
-    repo: https://github.com/ixyzorg
-    preview: /images/demos/ixyz.org.jpg
-  -
-    name: AJohn
-    desc: Never, ever, ever give up
-    logo: https://cdn.jsdelivr.net/gh/zzyAJohn/Image/blog-favicon.png
-    url: https://ajohn.top/
-    repo: https://github.com/zzyAJohn
-    preview: https://cdn.jsdelivr.net/gh/zzyAJohn/Image/blog-preview.png
-  -
-    name: Jiawei Wang
-    desc: PLUS & WAVE!
-    logo: https://plus-wave.github.io/icon/wave+.png
-    url: https://plus-wave.github.io
-    repo: https://github.com/PLUS-WAVE
-    preview: https://raw.githubusercontent.com/PLUS-WAVE/blog-image/master/img/blog/2024-11-24/plus-wave.github.io.jpg
-  -
-    name: Xiao Mu Mu Ya
-    desc: Life is like chess, once you make a move, you can't take it back; the way of life lies in being calm
-    logo: https://blog.mu00.cn/logo.png
-    url: https://blog.mu00.cn/
-    repo: https://github.com/sunnyboy-mu/sunnyboy-blog
-    preview: /images/demos/sunnyboy_mu.jpg
-  -
-    name: QiHuang02's Notebook
-    desc: Experience is the best teacher.
-    logo: https://qihuang02.cn/favicon.svg
-    url: https://qihuang02.cn/
-    repo: https://github.com/QiHuang02/qihuang02.github.io
-    preview: https://image.qihuang02.cn/file/1736003534894_yulantu.png
-  -
-    name: jiahao
-    desc: Just pursue it, even if it's just a momentary light
-    logo: https://s.jhdev.cn/head.png
-    url: https://jhdev.cn/
-    repo: https://github.com/oh-yey
-    preview: https://s.jhdev.cn/demos/blog-preview.png
-  -
-    name: A Zhe
-    desc: Strengthening yourself is the only way to solve problems
-    logo: https://www.azhe.xin/blogger.png
-    url: https://www.azhe.xin/
-    repo: https://github.com/liuzhemax/blog
-    preview: /images/demos/azhe.jpg
-  -
-    name: jindongjie
-    desc: Keep.It.Simple.Stupid
-    logo: https://ar0m.com/logo/aptrue-sience-logo.png
-    url: https://ar0m.com
-    repo: https://github.com/jindongjie/blog-vuepress-2025
-    preview: /images/demos/jindongjie.jpg
-  -
-    name: Yi Shu Lun
-    desc: A programmer's blog who loves art
-    logo: https://yishulun.com/avatar.png
-    url: https://yishulun.com
-    repo: https://github.com/rixingyike/rixingyike.github.io
-    preview: /images/demos/yishulun.com.jpg
-  -
-    name: Phys Nya
-    desc: Notes and life of a physics student
-    logo: https://physnya.top/images/Physics_nya.jpg
-    url: https://physnya.top
-    repo: https://github.com/physnya/blog
-    preview: https://physnya.top/images/preview.png
-  -
-    name: XINGJI
-    desc: All life so far has been written with failure, but that doesn't stop me from moving forward✨
-    logo: https://i.p-i.vip/47/20240920-66ed7b168c38c.jpg
-    url: https://vue.xingji.fun
-    repo: https://github.com/XingJi-love/XingJi-blog-plume
-    preview: https://i.p-i.vip/47/20250407-67f3f1eca1983.png
-  -
-    name: Paiad
-    desc: Pessimists are always right, optimists always move forward.
-    logo: https://blog.paiad.top/sunflower.png
-    url: https://blog.paiad.top
-    repo: https://github.com/paiad
-    preview: https://blog.paiad.top/paiad-blog.png
-  -
-    name: Flash
-    desc: The road ahead is long; I shall search up and down
-    logo: https://haipeng-lin.cn/images/avatar.jpg
-    url: https://haipeng-lin.cn
-    repo: https://gitee.com/linhaipengg
-    preview: https://img.haipeng-lin.cn/1768622018580.png
-  -
-    name: PinkDopeyBug
-    desc: Mountains are hard to see floating rafts, hearts easily fall into mirror flowers.
-    logo: https://w20241204.dpdns.org/images/avatar.jpg
-    url: https://w20241204.dpdns.org/
-    repo: https://github.com/PinkDopeyBug/blog
-    preview: https://w20241204.dpdns.org/images/demos/preview.png
-  -
-    name: rand777
-    desc: Even wobbly, you can reach your destination.
-    logo: https://blog.rand777.space/avatar.jpg
-    url: https://blog.rand777.space
-    repo: https://github.com/rand777gg/rand777-plume-blog
-    preview: https://blog.rand777.space/siteshot.png
-  -
-    name: Yi Xiang Zhi Lu
-    desc: Yi Xiang Zhi Lu's Blog
-    logo: https://yxzl.dev/head.png
-    url: https://yxzl.dev/
-    repo: https://github.com/yxzlwz/blog
-    preview: https://yxzl.dev/screenshot.png
-  -
-    name: Honahec
-    desc: Honahec's Blog
-    logo: https://image.honahec.cc/avatar-circle.png
-    url: https://blog.honahec.cc/
-    repo: https://github.com/Honahec/blog
-    preview: https://image.honahec.cc/20251018223321710.png
-  -
-    name: Lucas
-    desc: Ad astra abyssosque.
-    logo: https://static.lucas04.top/static/favicon/favicon-64.png
-    url: https://blog.lucas04.top/
-    repo: https://github.com/lucas0-nhr/lucas04-nhr.github.io
-    preview: https://static.lucas04.top/static/blog_preview.png
-  -
-    name: Kairui's Website
-    desc: Mathematics is the art of expressing ideas precisely.
-    logo: https://kairui.ca/uoft.svg
-    url: https://kairui.ca
-    repo: https://github.com/orderization
-    preview: https://kairui.ca/img/homepage_demo.png
-  -
-    name: Konata's Secret Base
-    desc: A private space to record technology and life
-    logo: https://raw.githubusercontent.com/Konata9/pic-base/main/pics/20260126223726455.png
-    url: https://konata9.cc/
-    preview: https://raw.githubusercontent.com/Konata9/pic-base/main/pics/20260125225910673.webp
----
-
-:::important
-You can always add your documentation or blog to this page via ==PR==.
-
-Site preview images should be placed in the `docs/.vuepress/public/images/demos` directory. Using remote links is recommended so you can update them at any time.
-
-Please try to use `.jpg` format for images, and use [tinypng](https://tinypng.com/) for compression if the file size is large.
-:::
-
-[Go to **Github Pull Request** to submit your site](https://github.com/pengzhanbo/vuepress-theme-plume/edit/main/docs/en/demos.md){.read-more}
-
-## Documentation
-
-<Demos :list="$frontmatter.docs" />
-
-## Blog
-
-<Demos :list="$frontmatter.blog" />
-
-<script setup>
-import Demos from '~/components/Demos.vue'
-</script>

docs/en/friends.md

@@ -77,12 +77,12 @@ list:
     name: pengzhanbo
     link: https://github.com/pengzhanbo
     avatar: https://github.com/pengzhanbo.png
-    desc: Even if slow, persist without stop; even if falling behind, even if failing, one must be able to reach the goal they are heading towards.
+    desc: 即使慢，驰而不息，纵会落后，纵会失败，但必须能够到达他所向的目标。
   -
     name: pengzhanbo
     link: https://github.com/pengzhanbo
     avatar: https://github.com/pengzhanbo.png
-    desc: Even if slow, persist without stop; even if falling behind, even if failing, one must be able to reach the goal they are heading towards.
+    desc: 即使慢，驰而不息，纵会落后，纵会失败，但必须能够到达他所向的目标。
     socials:
       -
         icon: github
@@ -96,7 +96,7 @@ list:
     avatar: https://github.com/pengzhanbo.png
     location: GuangZhou
     organization: PengZhanBo
-    desc: Even if slow, persist without stop; even if falling behind, even if failing, one must be able to reach the goal they are heading towards.
+    desc: 即使慢，驰而不息，纵会落后，纵会失败，但必须能够到达他所向的目标。
     socials:
       -
         icon: github
@@ -110,17 +110,17 @@ list:
     avatar: https://github.com/pengzhanbo.png
     location: GuangZhou
     organization: PengZhanBo
-    desc: Even if slow, persist without stop; even if falling behind, even if failing, one must be able to reach the goal they are heading towards.
+    desc: 即使慢，驰而不息，纵会落后，纵会失败，但必须能够到达他所向的目标。
 groups:
   -
-    title: Group 1
-    desc: Custom colors
+    title: 分组 1
+    desc: 自定义颜色
     list:
       -
         name: pengzhanbo
         link: https://github.com/pengzhanbo
         avatar: https://github.com/pengzhanbo.png
-        desc: Even if slow, persist without stop; even if falling behind, even if failing, one must be able to reach the goal they are heading towards.
+        desc: 即使慢，驰而不息，纵会落后，纵会失败，但必须能够到达他所向的目标。
         backgroundColor: rgb(255,153,0)
         color: rgb(255,255,153)
         nameColor: rgb(255,255,170)
@@ -135,7 +135,7 @@ groups:
         name: pengzhanbo
         link: https://github.com/pengzhanbo
         avatar: https://github.com/pengzhanbo.png
-        desc: Even if slow, persist without stop; even if falling behind, even if failing, one must be able to reach the goal they are heading towards.
+        desc: 即使慢，驰而不息，纵会落后，纵会失败，但必须能够到达他所向的目标。
         backgroundColor: rgb(255,102,102)
         color: rgb(255,204,204)
         nameColor: rgb(255,238,238)
@@ -143,22 +143,22 @@ groups:
         name: pengzhanbo
         link: https://github.com/pengzhanbo
         avatar: https://github.com/pengzhanbo.png
-        desc: Even if slow, persist without stop; even if falling behind, even if failing, one must be able to reach the goal they are heading towards.
+        desc: 即使慢，驰而不息，纵会落后，纵会失败，但必须能够到达他所向的目标。
         backgroundColor: rgb(0,153,204)
         color: rgb(153,238,255)
         nameColor: rgb(153,255,255)
   -
-    title: Group 2
-    desc: Description for Group 2
+    title: 分组 2
+    desc: 这里是分组 2 的描述文字
     list:
       -
         name: pengzhanbo
         link: https://github.com/pengzhanbo
         avatar: https://github.com/pengzhanbo.png
-        desc: Even if slow, persist without stop; even if falling behind, even if failing, one must be able to reach the goal they are heading towards.
+        desc: 即使慢，驰而不息，纵会落后，纵会失败，但必须能够到达他所向的目标。
       -
         name: pengzhanbo
         link: https://github.com/pengzhanbo
         avatar: https://github.com/pengzhanbo.png
-        desc: Even if slow, persist without stop; even if falling behind, even if failing, one must be able to reach the goal they are heading towards.
+        desc: 即使慢，驰而不息，纵会落后，纵会失败，但必须能够到达他所向的目标。
 ---

docs/en/guide/chart/echarts.md

@@ -86,7 +86,7 @@ Refer to the [ECharts documentation](https://echarts.apache.org/handbook/zh/get-
 ## Advanced
 
 You can import and use `defineEchartsConfig` in the
-[client configuration file](https://vuejs.press/guide/configuration.html#client-config-file) to customize ECharts:
+[client configuration file](https://vuejs.press/zh/guide/configuration.html##使用脚本) to customize ECharts:
 
 ```ts
 import { defineEchartsConfig } from '@vuepress/plugin-markdown-chart/client'

docs/en/guide/chart/flowchart.md

@@ -346,6 +346,6 @@ Symbols that should probably not be used in text: `=>`, `->`, `:>`, `|`, `@>`, a
 
 To emphasize a specific path in the flowchart, you can additionally define it as follows:
 
-```md
+```
 st@>op1({"stroke":"Red"})@>cond({"stroke":"Red","stroke-width":6,"arrow-end":"classic-wide-long"})@>c2({"stroke":"Red"})@>op2({"stroke":"Red"})@>e({"stroke":"Red"})
 ```

docs/en/guide/chart/plantuml.md

@@ -260,7 +260,7 @@ object NewYork
 
 map CapitalCity {
  UK *-> London
- USA*--> Washington
+ USA *--> Washington
  Germany *---> Berlin
 }
 
@@ -427,9 +427,9 @@ rectangle "Investigate" as I <<$bProcess>><<behavior>> #Business
 rectangle "Pay" as P <<$bProcess>><<behavior>> #Business
 
 HC *-down- CI
-HC*-down- NAS
+HC *-down- NAS
 HC *-down- V
-HC*-down- I
+HC *-down- I
 HC *-down- P
 
 CI -right->> NAS
@@ -574,16 +574,16 @@ caption figure 1
 title My super title
 
 * <&flag>Debian
-**<&globe>Ubuntu
-***Linux Mint
+** <&globe>Ubuntu
+*** Linux Mint
 *** Kubuntu
-***Lubuntu
+*** Lubuntu
 *** KDE Neon
 ** <&graph>LMDE
-**<&pulse>SolydXK
+** <&pulse>SolydXK
 ** <&people>SteamOS
 ** <&star>Raspbian with a very long name
-***<s>Raspmbc</s> => OSMC
+*** <s>Raspmbc</s> => OSMC
 *** <s>Raspyfi</s> => Volumio
 
 header
@@ -630,9 +630,9 @@ endlegend
 
 ```md
 @startjson
-# highlight "lastName"
-# highlight "address" / "city"
-# highlight "phoneNumbers" / "0" / "number"
+#highlight "lastName"
+#highlight "address" / "city"
+#highlight "phoneNumbers" / "0" / "number"
 {
   "firstName": "John",
   "lastName": "Smith",

docs/en/guide/code/features.md

@@ -49,7 +49,7 @@ for example `:line-numbers=2` indicates that line numbers in the code block star
 
 **Input:**
 
-````md
+````
 ```ts:line-numbers
 // Line numbers enabled
 const line2 = 'This is line 2'
@@ -95,7 +95,7 @@ Add `{xxxx}` immediately after `[lang]` to enable line highlighting, where `xxx`
 
 **Input:**
 
-````md
+````
 ```js{4}
 export default {
   data () {
@@ -127,7 +127,7 @@ In addition to single lines, you can specify multiple single lines, line ranges,
 
 **Input:**
 
-````md
+````
 ```js{1,4,6-8}
 export default { // Highlighted
   data () {
@@ -163,10 +163,10 @@ You can also use the `// [!code highlight]` comment to enable line highlighting.
 
 **Input:**
 
-````md
+````
 ```js
 export default {
-  data() {
+  data () {
     return {
       msg: 'Highlighted!' // [\!code highlight]
     }
@@ -195,10 +195,10 @@ Additionally, you can use `// [!code focus:<lines>]` to define the number of lin
 
 **Input:**
 
-````md
+````
 ```js
 export default {
-  data() {
+  data () {
     return {
       msg: 'Focused!' // [\!code focus]
     }
@@ -242,10 +242,10 @@ Adding `// [!code --]` or `// [!code ++]` comments to a line will create a diff
 
 **Input:**
 
-````md
+````
 ```js
 export default {
-  data() {
+  data () {
     return {
       error: 'Removed', // [\!code --]
       warning: 'Added' // [\!code ++]
@@ -289,10 +289,10 @@ Adding `// [!code warning]` or `// [!code error]` comments to a line will apply
 
 **Input:**
 
-````md
+````
 ```js
 export default {
-  data() {
+  data () {
     return {
       error: 'Error', // [\!code error]
       warning: 'Warning' // [\!code warning]
@@ -334,7 +334,7 @@ mkdir hello && cd hello  # [!code warning]
 
 **Input:**
 
-````md
+````
 ```ts
 export function foo() { // [\!code word:Hello]
   const msg = 'Hello World'
@@ -357,7 +357,7 @@ will highlight only the first two occurrences of `options`.
 
 **Input:**
 
-````md
+````
 ```ts
 // [\!code word:options:2]
 const options = { foo: 'bar' }

docs/en/guide/components/card-masonry.md

@@ -61,7 +61,7 @@ In Markdown, the `::: card-masonry` container can be used instead of `<CardMason
 ``` md
 ::: card-masonry cols="3" gap="16" <!-- [!code hl]-->
 
-![alt text](/images/1.png)
+![](/images/1.png)
 
 <!-- More content -->
 
@@ -79,17 +79,17 @@ Masonry layout is particularly suitable for displaying images. You can directly
 ``` md
 ::: card-masonry
 
-![alt text](image_url)
+![](image_url)
 
-![alt text](image_url)
+![](image_url)
 
-![alt text](image_url)
+![](image_url)
 
-![alt text](image_url)
+![](image_url)
 
-![alt text](image_url)
+![](image_url)
 
-![alt text](image_url)
+![](image_url)
 
 :::
 ```

docs/en/guide/components/image-card.md

@@ -132,4 +132,4 @@ It can also be placed within a `<CardGrid>` component.
   />
 </CardGrid>
 
-[View Photography Works Example](/en/demos/)
+[View Photography Works Example](../../../../../blog/1.示例/照片类作品示例.md)

docs/en/guide/custom/home.md

@@ -129,7 +129,8 @@ config:
 
 **Result:**
 
-::: window
+:::demo-wrapper img no-padding
+
 ![banner](/images/custom-banner.jpg)
 :::
 
@@ -245,7 +246,7 @@ config:
 
 **Result:**
 
-::: window
+:::demo-wrapper img no-padding
 <img src="/images/custom-doc-hero.jpg" alt="Theme Plume" />
 :::
 
@@ -358,7 +359,7 @@ config:
 
 **Result:**
 
-:::window
+:::demo-wrapper img no-padding
 <img src="/images/custom-features.jpg" alt="custom-features" />
 :::
 
@@ -431,11 +432,11 @@ config:
 
 **Result:**
 
-:::window
+:::demo-wrapper img no-padding
 <img src="/images/custom-image-text.jpg" alt="image-text" />
 :::
 
-:::window
+:::demo-wrapper img no-padding
 <img src="/images/custom-text-image.jpg" alt="text-image" />
 :::
 
@@ -504,7 +505,7 @@ config:
 
 **Result:**
 
-:::window
+:::demo-wrapper img no-padding
 <img src="/images/custom-profile.jpg" alt="profile" />
 :::
 
@@ -550,7 +551,7 @@ yarn add vuepress@next vuepress-theme-plume
 
 **Result:**
 
-:::window
+:::demo-wrapper img no-padding
 <img src="/images/custom-content.jpg" alt="content" />
 :::
 

docs/en/guide/features/encryption.md

@@ -64,7 +64,7 @@ export default defineUserConfig({
     encrypt: {
       rules: {
         // Can be the relative path of an MD file to encrypt that file
-        'frontend/basics.md': '123456',
+        '前端/基础.md': '123456',
         // Can be a directory path to encrypt all articles under that directory
         '/notes/vuepress-theme-plume/': '123456',
         // Can be a request path to encrypt all articles under that path
@@ -115,109 +115,6 @@ passwordHint: The password is 123456
 
 Click to visit [Encrypted Article, Password: 123456](/article/enx7c9s/)
 
-## Partial Content Encryption
-
-### Configuration
-
-Partial content encryption is implemented through the `::: encrypt` container. You need to configure the `markdown.encrypt` option:
-
-```ts title=".vuepress/config.ts"
-export default defineUserConfig({
-  theme: plumeTheme({
-    markdown: {
-      encrypt: true, // [!code ++]
-    }
-  })
-})
-```
-
-You can also set a unified default password for the `::: encrypt` container:
-
-```ts title=".vuepress/config.ts"
-export default defineUserConfig({
-  theme: plumeTheme({
-    markdown: {
-      encrypt: {
-        password: 123456, // [!code ++]
-      }
-    }
-  })
-})
-```
-
-### Usage
-
-Use the `::: encrypt` container to wrap the content that needs to be encrypted.
-You can add `password` / `pwd` attribute to the container to set the password for that container.
-If no password is set, the default password will be used.
-
-You can also add a `hint` attribute to set a password hint.
-
-```md /password="123456"/
-::: encrypt password="123456" hint="The password is 6 consecutive digits"
-This is encrypted content
-:::
-```
-
-::: info Only one password is effective; multiple passwords are not supported simultaneously.
-:::
-
-### Example
-
-**Input:**
-
-```md
-::: encrypt password="123456"
-This is encrypted content
-:::
-```
-
-**Output:**
-
-::: encrypt password="123456"
-This is encrypted content
-:::
-
-**Input:**
-
-```md
-::: encrypt password="654321" hint="The password is 6 consecutive digits"
-This is encrypted content 2
-:::
-```
-
-**Output:**
-
-::: encrypt password="654321" hint="The password is 6 consecutive digits"
-This is encrypted content 2
-:::
-
-::: warning Usage Limitations
-**For encrypted content, you can use:**
-
-- All standard markdown syntax
-- Most extended syntax provided by the theme, except:
-  - `@[demo]()` code examples imported from directories
-  - `@[code]()` code snippets imported from directories
-  - `@[code-tree]()` code trees imported from directories
-- Global Vue components provided by the theme
-- User-defined global Vue components
-- Encrypted content cannot contain executable scripts; for special interactions, please implement through components.
-
-**Network Environment Requirements:**
-Partial content encryption is implemented using [Crypto API](https://developer.mozilla.org/en-US/docs/Web/API/Crypto),
-therefore, it will not work properly in **non-HTTPS environments**.
-:::
-
-::: details If you are a technical developer, you may need to know
-
-The original markdown content is first rendered into HTML content, then encrypted; transmitted to the client, then decrypted and rendered.
-The decrypted content is wrapped as a dynamic Vue component, with HTML passed as the template to the dynamic component.
-This involves runtime template compilation. As a result, if partial content encryption is enabled,
-Vue needs to be switched to the `esm-bundler` version to support runtime compilation,
-which has slightly worse performance and larger size compared to the default `runtime-only` version.
-:::
-
 ## Related Configurations
 
 The following configurations can be used in [multilingual settings](../../config/locales.md).

docs/en/guide/features/icon.md

@@ -16,7 +16,7 @@ The theme supports icons from the following sources:
 Icons are used in the same way across the following theme features:
 
 - [Navbar Icons](../../config/navbar.md#configuration)
-- [Sidebar Icons](../../guide/quick-start/sidebar.md#visual-enhancement-features)
+- [Sidebar Icons](../../guide/document.md#sidebar-icons)
 - [File Tree Icons](../../guide/markdown/file-tree.md)
 - [Code Group Title Icons](../code/code-tabs.md#group-title-icons)
 

docs/en/guide/features/image-preview.md

@@ -36,11 +36,11 @@ For more configuration options, please refer to [@vuepress/plugin-photo-swipe](h
 Image preview can be disabled by using the `no-view` or `ignore` class names, or the `no-view` attribute.
 
 ```md
-![alt text](path/to/image){.no-view}
-![alt text](path/to/image){.ignore}
-![alt text](path/to/image){no-view}
+![](path/to/image){.no-view}
+![](path/to/image){.ignore}
+![](path/to/image){no-view}
 
-<img src="path/to/image" class="no-view" alt="alt text">
-<img src="path/to/image" class="ignore" alt="alt text">
-<img src="path/to/image" no-view alt="alt text">
+<img src="path/to/image" class="no-view">
+<img src="path/to/image" class="ignore">
+<img src="path/to/image" no-view>
 ```

docs/en/guide/features/llmstxt.md

@@ -2,7 +2,7 @@
 title: LLMs txt
 icon: ri:ai
 createTime: 2025/12/01 10:46:46
-permalink: /en/guide/features/llmstxt/
+permalink: /en/features/llmstxt/
 ---
 
 ## Overview

docs/en/guide/features/replace-assets.md

@@ -90,7 +90,7 @@ In markdown, use local asset paths directly:
 ```md
 ![foo](/images/foo.jpg)
 
-<img src="/images/foo.jpg" alt="foo">
+<img src="/images/foo.jpg">
 ```
 
 In `javascript`:

docs/en/guide/markdown/card.md

@@ -96,5 +96,5 @@ This is the card content.
 ::::
 
 ::: info
-If you prefer using cards via components, you can check out the [Card Component](../features/component.md#card).
+If you prefer using cards via components, you can check out the [Card Component](/guide/features/component/#card).
 :::

docs/en/guide/markdown/chat.md

@@ -36,7 +36,7 @@ Bad news: I've used you as the example \[doge\]
 
 ## Overview
 
-In Markdown, wrapping specially formatted text content within a `::: chat` container allows you to display ==chat records== within the documentation.
+In Markdown, wrapping specially formatted text content within a `:: chat` container allows you to display ==chat records== within the documentation.
 
 ::: warning This is a feature you likely won't need most of the time.
 Please consider carefully whether you should use it when the need arises.

docs/en/guide/markdown/container.md

@@ -1,5 +1,5 @@
 ---
-title: Tip Containers
+title: container
 icon: mdi:message-text-outline
 createTime: 2025/11/29 14:53:21
 permalink: /en/guide/markdown/container/

docs/en/guide/markdown/demo-wrapper.md

@@ -1,12 +1,9 @@
 ---
 title: Demo Container
 createTime: 2025/10/08 14:47:12
-icon: fxemoji:window
-permalink: /en/guide/markdown/window/
+icon: icon-park-outline:eyes
+permalink: /en/guide/markdown/demo-wrapper/
 outline: 2
-badge:
-  text: Change
-  type: warning
 ---
 
 ## Overview
@@ -17,7 +14,7 @@ separately from other content. The theme supports adding demo containers in Mark
 ## Syntax
 
 ````md
-::: window
+::: demo-wrapper
 Add your demo here
 :::
 ````
@@ -34,20 +31,20 @@ Add your demo here
 Containing only images:
 
 ```md
-::: window
+::: demo-wrapper img no-padding
 ![hero](/images/custom-hero.jpg)
 :::
 ```
 
 **Output:**
-::: window
+::: demo-wrapper img no-padding
 ![hero](/images/custom-hero.jpg)
 :::
 
 Containing markdown syntax:
 
 ```md
-::: window title="Title"
+::: demo-wrapper title="Title"
 ### Level 3 Heading
 
 This is content inside the demo container.
@@ -55,7 +52,7 @@ This is content inside the demo container.
 ```
 
 **Output:**
-::: window title="Title"
+::: demo-wrapper title="Title"
 
 ### Level 3 Heading
 
@@ -65,7 +62,7 @@ This is content inside the demo container.
 Containing HTML/Vue code:
 
 ```md
-::: window
+::: demo-wrapper
 <h1 class="your-demo-title">This is a heading</h1>
 <p class="your-demo-paragraph">This is a paragraph</p>
 
@@ -81,7 +78,7 @@ Containing HTML/Vue code:
 ```
 
 **Output:**
-::: window
+::: demo-wrapper
 
 <h1 class="your-demo-title">This is a heading</h1>
 <p class="your-demo-paragraph">This is a paragraph</p>

docs/en/guide/markdown/emoji.md

@@ -12,9 +12,9 @@ import { people, nature, foods, places, activities, symbols, objects, flags } fr
 
 ## Quick Start
 
-Using emoji in Markdown is very simple, just wrap the emoji code with colons:
+在 Markdown 中使用表情符号非常简单，只需用冒号包裹表情代码即可：
 
-**Input:**
+**Input：**
 
 ```md
 :tada: :100:

docs/en/guide/markdown/extensions.md

@@ -159,13 +159,13 @@ Right-aligned content
 **Input:**
 
 ````md
-The farthest distance in the world Is not the distance between life and death But you don't know I love you when I stand in front of you.[^footnote1].
+The farthest distance in the world Is not the distance between life and death But you don't know I love you when I stand in front of you.[^footnote1]。
 
 [^footnote1]: From India.Rabindranath Tagore **The Farthest Distance in the World**
 ````
 
 **Output:**
 
-The farthest distance in the world Is not the distance between life and death But you don't know I love you when I stand in front of you.[^footnote1].
+The farthest distance in the world Is not the distance between life and death But you don't know I love you when I stand in front of you.[^footnote1]。
 
 [^footnote1]: From India.Rabindranath Tagore **The Farthest Distance in the World**

docs/en/guide/markdown/file-tree.md

@@ -3,9 +3,6 @@ title: File Tree
 createTime: 2025/10/08 14:41:57
 icon: mdi:file-tree
 permalink: /en/guide/markdown/file-tree/
-badge:
-  text: Change
-  type: warning
 ---
 
 ## Overview
@@ -21,7 +18,7 @@ displayed, simply add a slash `/` at the end of the list item.
 The following syntax can be used to customize the appearance of the file tree:
 
 - Emphasize file or directory names by making them bold, e.g., `**README.md**`
-- Add comments to files or directories by appending a comment starting with `#` after the name, for example, `README.md This is a README file`
+- Add comments to files or directories by adding additional text after the name
 - Mark files or directories as **added** or **deleted** by prefixing the name with `++` or `--`
 - Use `...` or `…` as the name to add placeholder files and directories.
 - Add `icon="simple"` or `icon="colored"` after `:::file-tree` to switch to simple icons or colored icons. The default is colored icons.
@@ -37,7 +34,7 @@ The following syntax can be used to customize the appearance of the file tree:
     - ++ config.ts
   - -- page1.md
   - README.md
-- theme  # A **theme** directory
+- theme  A **theme** directory
   - client
     - components
       - **Navbar.vue**
@@ -64,7 +61,7 @@ The following syntax can be used to customize the appearance of the file tree:
     - ++ config.ts
   - -- page1.md
   - README.md
-- theme  # A **theme** directory
+- theme  A **theme** directory
   - client
     - components
       - **Navbar.vue**

docs/en/guide/markdown/github-alerts.md

@@ -1,7 +1,6 @@
 ---
-title: GitHub Alerts
-icon: mdi:alert-outline
-createTime: 2025/11/29 19:59:45
+title: github-alerts
+createTime: 2025/11/29 21:20:21
 permalink: /en/guide/markdown/github-alerts/
 ---
 

docs/en/guide/markdown/icons.md

@@ -2,7 +2,7 @@
 title: Icons
 createTime: 2025/10/08 14:49:39
 icon: grommet-icons:emoji
-permalink: /en/guide/markdown/icons/
+permalink: /en/guide/markdown/icon/
 ---
 
 <script setup>
@@ -391,7 +391,7 @@ Output:
 
 [Add more style support for Fontawesome](https://docs.fontawesome.com/web/style/styling){.read-more}
 
-```md
+```
 ::circle-user 2xl::  <!-- 2xl is shorthand for fa-2xl, icon size is 2em -->
 ::circle-user rotate-90:: <!-- icon rotated 90 degrees -->
 ::circle-user beat:: <!-- icon animation -->

docs/en/guide/markdown/include.md

@@ -144,18 +144,18 @@ Included via `<!-- @include: ./foo.snippet.md#snippet -->`.
 
 Using `<!-- @include: ./foo.snippet.md -->` to include the entire file:
 
-:::: window title="Include by file"
+:::: demo-wrapper title="Include by file"
 <!-- @include: ../../snippet/include-2.snippet.md -->
 ::::
 
 Using `<!-- @include: ./foo.snippet.md{5-7} -->` to include lines 5-7 of the file:
 
-:::: window title="Include by lines"
+:::: demo-wrapper title="Include by lines"
 <!-- @include: ../../snippet/include-2.snippet.md{5-7} -->
 ::::
 
 Using `<!-- @include: ./foo.snippet.md#snippet -->` to include the `snippet` region:
 
-:::: window title="Include by file region"
+:::: demo-wrapper title="Include by file region"
 <!-- @include: ../../snippet/include-2.snippet.md#snippet -->
 ::::

docs/en/guide/markdown/obsidian.md

@@ -1,337 +0,0 @@
----
-title: Obsidian Compatibility
-icon: simple-icons:obsidian
-createTime: 2026/04/17 21:56:55
-permalink: /en/guide/markdown/obsidian/
----
-
-## Overview
-
-The theme provides compatibility support for Obsidian's official Markdown extension syntax through the `vuepress-plugin-md-power` plugin, enabling Obsidian users to write documentation using familiar syntax.
-
-Currently supported Obsidian extension syntax includes:
-
-- [Wiki Links](#wiki-links) - Syntax for inter-page linking
-- [Embeds](#embeds) - Embed content from other files into the current page
-- [Comments](#comments) - Add comments visible only during editing
-
-::: warning No plans to support extension syntax provided by Obsidian's third-party community plugins
-:::
-
-## Wiki Links
-
-Wiki Links are syntax used in Obsidian for linking to other notes. Use double brackets `[[]]` to wrap content to create internal links.
-
-### Syntax
-
-```md
-[[filename]]
-[[filename#heading]]
-[[filename#heading#subheading]]
-[[filename|alias]]
-[[filename#heading|alias]]
-[[https://example.com|External Link]]
-```
-
-### Filename Search Rules
-
-When using Wiki Links, filenames are matched according to the following rules:
-
-**Match Priority:**
-
-1. **Full Path** - Exact match against file paths
-2. **Fuzzy Match** - Match filenames at the end of paths, prioritizing the shortest path
-
-**Path Resolution Rules:**
-
-- **Relative paths** (starting with `.`): Resolved relative to the current file's directory
-- **Absolute paths** (not starting with `.`): Searched throughout the document tree, prioritizing the shortest path
-- **Directory form** (ending with `/`): Matches `README.md` in that directory
-
-**Example:**
-
-Assuming the following document structure:
-
-```txt
-docs/
-├── README.md
-├── guide/
-│   ├── README.md
-│   └── markdown/
-│       └── obsidian.md
-```
-
-In `docs/guide/markdown/obsidian.md`:
-
-| Syntax             | Match Result                                                                              |
-| ------------------ | ----------------------------------------------------------------------------------------- |
-| `[[obsidian]]`     | Matches `docs/guide/markdown/obsidian.md` (matched via filename)                          |
-| `[[./]]`           | Matches `docs/guide/markdown/README.md` (relative path)                                   |
-| `[[../]]`          | Matches `docs/guide/README.md` (parent directory)                                        |
-| `[[guide/]]`      | Matches `docs/guide/README.md` (directory form)                                          |
-
-### Examples
-
-**External Links:**
-
-**Input:**
-
-```md
-[[https://example.com|External Link]]
-```
-
-**Output:**
-
-[[https://example.com|External Link]]
-
-**Internal Anchor Links:**
-
-**Input:**
-
-```md
-[[npm-to]]  <!-- Search by filename -->
-[[guide/markdown/math]]  <!-- Search by file path -->
-[[#Wiki Links]]  <!-- Heading on current page -->
-[[file-tree#Configuration]]  <!-- Search by filename, link to heading -->
-```
-
-**Output:**
-
-[[npm-to]]
-
-[[guide/markdown/math]]
-
-[[#Wiki Links]]
-
-[[file-tree#Configuration]]
-
-[Obsidian Official - **Wiki Links**](https://obsidian.md/en/help/links){.readmore}
-
-## Embeds
-
-The embed syntax allows you to insert other file resources into the current page.
-
-### Syntax
-
-```md
-![[filename]]
-![[filename#heading]]
-![[filename#heading#subheading]]
-```
-
-Filename search rules are the same as [Wiki Links](#filename-search-rules).
-
-::: info Resources starting with `/` or having no path prefix like `./` are loaded from the `public` directory
-:::
-
-### Image Embeds
-
-**Syntax:**
-
-```md
-![[image]]
-![[image|300]]
-![[image|300x200]]
-```
-
-Supported formats: `jpg`, `jpeg`, `png`, `gif`, `avif`, `webp`, `svg`, `bmp`, `ico`, `tiff`, `apng`, `jfif`, `pjpeg`, `pjp`, `xbm`
-
-**Example:**
-
-::: demo markdown title="Basic Image" expanded
-
-```md
-![[images/custom-hero.jpg]]
-```
-
-:::
-
-::: demo markdown title="Set Width" expanded
-
-```md
-![[images/custom-hero.jpg|300]]
-```
-
-:::
-
-::: demo markdown title="Set Width and Height" expanded
-
-```md
-![[images/custom-hero.jpg|300x200]]
-```
-
-:::
-
-### PDF Embeds
-
-> [!NOTE]
-> PDF embeds require the `markdown.pdf` plugin to be enabled for proper functionality.
-
-**Syntax:**
-
-```md
-![[document.pdf]]
-![[document.pdf#page=1]]  <!-- #page=1 means first page -->
-![[document.pdf#page=1#height=300]]  <!-- #page=page number #height=height -->
-```
-
-Supported formats: `pdf`
-
----
-
-### Audio Embeds
-
-**Syntax:**
-
-```md
-![[audio file]]
-```
-
-Supported formats: `mp3`, `flac`, `wav`, `ogg`, `opus`, `webm`, `acc`
-
----
-
-### Video Embeds
-
-> [!NOTE]
-> Video embeds require the `markdown.artPlayer` plugin to be enabled for proper functionality.
-
-**Syntax:**
-
-```md
-![[video file]]
-![[video file#height=400]]  <!-- Set video height -->
-```
-
-Supported formats: `mp4`, `webm`, `mov`, etc.
-
----
-
-### Content Fragment Embeds
-
-Content fragments under a specified heading can be embedded using `#heading`:
-
-**Input:**
-
-```md
-![[my-note]]
-![[my-note#Heading One]]
-![[my-note#Heading One#Subheading]]
-```
-
-[Obsidian Official - **Insert Files**](https://obsidian.md/en/help/embeds){.readmore}
-[Obsidian Official - **File Formats**](https://obsidian.md/en/help/file-formats){.readmore}
-
-## Comments
-
-Content wrapped in `%%` is treated as a comment and will not be rendered on the page.
-
-### Syntax
-
-**Inline Comments:**
-
-```md
-This is an %%inline comment%% example.
-```
-
-**Block Comments:**
-
-```md
-%%
-This is a block comment.
-It can span multiple lines.
-%%
-```
-
-### Examples
-
-**Inline Comments:**
-
-**Input:**
-
-```md
-This is an %%inline comment%% example.
-```
-
-**Output:**
-
-This is an %%inline comment%% example.
-
----
-
-**Block Comments:**
-
-**Input:**
-
-```md
-Content before the comment
-
-%%
-This is a block comment.
-
-It can span multiple lines.
-%%
-
-Content after the comment
-```
-
-**Output:**
-
-Content before the comment
-
-%%
-This is a block comment.
-%%
-
-It can span multiple lines.
-
-[Obsidian Official - **Comments**](https://obsidian.md/en/help/syntax#%E6%B3%A8%E9%87%8B){.readmore}
-
-## Configuration
-
-Obsidian compatibility features are all enabled by default. You can selectively enable or disable them through configuration:
-
-```ts title=".vuepress/config.ts"
-export default defineUserConfig({
-  theme: plumeTheme({
-    plugins: {
-      mdPower: {
-        obsidian: {
-          wikiLink: true,    // Wiki Links
-          embedLink: true,  // Embeds
-          comment: true,    // Comments
-        },
-        pdf: true,          // PDF embed functionality
-        artPlayer: true,    // Video embed functionality
-      }
-    }
-  })
-})
-```
-
-### Configuration Options
-
-:::: field-group
-
-::: field name="wikiLink" type="boolean" default="true" optional
-Enable Wiki Links syntax.
-:::
-
-::: field name="embedLink" type="boolean" default="true" optional
-Enable embed content syntax.
-:::
-
-::: field name="comment" type="boolean" default="true" optional
-Enable comment syntax.
-:::
-
-::::
-
-## Notes
-
-- These plugins provide **compatibility support** and do not fully implement all of Obsidian's functionality
-- Some Obsidian-specific features (such as internal link graph views, bidirectional links, etc.) are outside the scope of this support
-- When embedding content, the embedded page also participates in the theme's build process
-- PDF embeds require the `markdown.pdf` plugin to be enabled simultaneously
-- Video embeds require the `markdown.artPlayer` plugin to be enabled simultaneously
-- Embed resources starting with `/` or using `./` form are loaded from the `public` directory

docs/en/guide/markdown/plot.md

@@ -12,7 +12,7 @@ This could be to pique readers' curiosity or simply to add a bit of reading diff
 
 To satisfy this playful intention, the theme provides a fun little feature called **"plot" text**. It looks like this:
 
-:::window
+:::demo-wrapper
 Did you know that !!Lu Xun!! once said: "!!I never said this!!!" It was an enlightening revelation that deeply
 inspired me, filling me with unparalleled strength! So, !!I turned over in bed!!!
 :::
@@ -84,7 +84,7 @@ You can also control behavior through attribute syntax:
 
 Use the `plot` option in Frontmatter to control the default behavior of this feature on the current page:
 
-```md
+```
 ---
 plot:
   trigger: hover
@@ -102,7 +102,7 @@ Did you know that !!Lu Xun!! once said: "!!I never said this!!!" It was an enlig
 
 **Output**:
 
-:::window
+:::demo-wrapper
 Did you know that !!Lu Xun!! once said: "!!I never said this!!!" It was an enlightening revelation that
 deeply inspired me, filling me with unparalleled strength! So, !!I turned over in bed!!!!
 :::
@@ -118,7 +118,7 @@ Blur effect + click: !!Click to see me!!{.blur .click}
 
 **Output**:
 
-:::window
+:::demo-wrapper
 Mask effect + hover: !!Hover to see me!!{.mask .hover}
 
 Mask effect + click: !!Click to see me!!{.mask .click}

docs/en/guide/markdown/qrcode.md

@@ -1,9 +1,9 @@
 ---
-title: QR Code
+title: qrcode
 icon: uiw:qrcode
-createTime: 2025/12/05 10:37:43
+createTime: 2025/12/05 16:16:06
 permalink: /en/guide/markdown/qrcode/
-badge: New
+badge: 新
 ---
 
 @[qrcode](https://github.com/pengzhanbo/vuepress-theme-plume)

docs/en/guide/markdown/tabs.md

@@ -77,7 +77,7 @@ which represent the bound value of the tab and whether the tab is currently acti
 
 **Input:**
 
-````md
+````
 ::: tabs
 @tab npm
 

docs/en/guide/quick-start/auto-frontmatter.md

@@ -94,7 +94,7 @@ export default defineUserConfig({
       {
         type: 'doc',
         dir: 'guide',
-        title: 'Guide',
+        title: '指南',
         // autoFrontmatter: true, // Theme built-in configuration
         autoFrontmatter: {
           title: true, // Auto-generate title
@@ -117,7 +117,7 @@ export default defineThemeConfig({
     {
       type: 'doc',
       dir: 'guide',
-      title: 'Guide',
+      title: '指南',
       // autoFrontmatter: true, // Theme built-in configuration
       autoFrontmatter: {
         title: true, // Auto-generate title
@@ -297,23 +297,23 @@ Example:
 
 ::: code-tree
 
-```md title="docs/blog/service.md"
+```md title="docs/blog/服务.md"
 ---
-title: Service
-permalink: /blog/service/
+title: 服务
+permalink: /blog/wu-fu/
 ---
 ```
 
-```md title="docs/blog/capital.md"
+```md title="docs/blog/都城.md"
 ---
-title: Capital
-permalink: /blog/capital/
+title: 都城
+permalink: /blog/dou-cheng/
 ---
 ```
 
 :::
 
-You probably noticed that in the example, the permalink for the `capital.md` file is `/blog/capital/`,
+You probably noticed that in the example, the permalink for the `都城.md` file is `/blog/dou-cheng/`,
 which is incorrect. This is because `pinyin-pro`'s default dictionary cannot accurately identify polyphonic
 characters. If you need a more precise conversion result,you can manually install `@pinyin-pro/data`,
 and the theme will automatically load this dictionary to improve accuracy.
@@ -326,9 +326,9 @@ npm i @pinyin-pro/data
 
 :::
 
-```md title="docs/blog/capital.md"
+```md title="docs/blog/都城.md"
 ---
-title: Capital
-permalink: /blog/capital/
+title: 都城
+permalink: /blog/du-cheng/
 ---
 ```

docs/en/guide/quick-start/collection-post.md

@@ -595,7 +595,7 @@ title: Article Title
 cover: /images/cover.jpg
 coverStyle:
   layout: left
-  ratio: 16/9
+  ratio: 16:9
   width: 300
 ---
 ```
@@ -606,7 +606,7 @@ Display effect:
 <VPPostItem
   :post="{ path: '/article/ecxnxxd0/', title: 'Article Title',
   categoryList: [{id:'65f30c',sort:4,name:'Tutorial'}], createTime: '2024/09/18 09:19:36',
-  lang:'en-US', excerpt:'', cover: 'https://api.pengzhanbo.cn/wallpaper/bing', coverStyle: { layout: 'left', ratio: '16/9', width: 300 } }"
+  lang:'en-US', excerpt:'', cover: 'https://api.pengzhanbo.cn/wallpaper/bing', coverStyle: { layout: 'left', ratio: '16:9', width: 300 } }"
   :index="1"
 />
 </div>
@@ -621,7 +621,7 @@ title: Article Title
 cover: /images/cover.jpg
 coverStyle:
   layout: left
-  ratio: 16/9
+  ratio: 16:9
   width: 300
   compact: true
 ---
@@ -634,7 +634,7 @@ Display effect:
   :post="{ path: '/article/ecxnxxd0/', title: 'Article Title',
   categoryList: [{id:'65f30c',sort:4,name:'Tutorial'}], createTime: '2024/09/18 09:19:36',
   lang:'en-US', excerpt:'', cover: 'https://api.pengzhanbo.cn/wallpaper/bing',
-  coverStyle: { layout: 'left', ratio: '16/9', width: 300, compact: true } }"
+  coverStyle: { layout: 'left', ratio: '16:9', width: 300, compact: true } }"
   :index="1"
 />
 </div>
@@ -650,7 +650,7 @@ title: Article Title
 cover: /images/cover.jpg
 coverStyle:
   layout: top
-  ratio: 16/9
+  ratio: 16:9
   width: 300
 ---
 ```
@@ -662,7 +662,7 @@ Display effect:
   :post="{ path: '/article/ecxnxxd0/', title: 'Article Title',
   categoryList: [{id:'65f30c',sort:4,name:'Tutorial'}], createTime: '2024/09/18 09:19:36',
   lang:'en-US', excerpt:'', cover: 'https://api.pengzhanbo.cn/wallpaper/bing',
-  coverStyle: { layout: 'top', ratio: '16/9', width: 300 } }"
+  coverStyle: { layout: 'top', ratio: '16:9', width: 300 } }"
   :index="1"
 />
 </div>
@@ -684,7 +684,7 @@ export default defineUserConfig({
         title: 'Blog',
         postCover: {
           layout: 'left',
-          ratio: '16/9',
+          ratio: '16:9',
           width: 300,
           compact: true
         }
@@ -701,28 +701,12 @@ type PostCoverLayout = 'left' | 'right' | 'odd-left' | 'odd-right' | 'top'
 
 interface PostCoverStyle {
   layout?: PostCoverLayout // Layout position
-  ratio?: number | `${number}/${number}` | `${number}:${number}` // Aspect ratio, default '4/3'
+  ratio?: number | `${number}:${number}` // Aspect ratio, default '4:3'
   width?: number // Width (effective for left/right layouts), default 240
   compact?: boolean // Compact mode, default false
 }
 ```
 
-:::warning Known Issue: Parsing Problem with `ratio` in Markdown Frontmatter
-
-When defining `ratio` in markdown frontmatter, using the `:` separator may cause parsing errors.
-It is recommended to use the `/` separator instead.
-
-If you still prefer to use `:`, you can wrap it with `''`. Example:
-
-```md '16:9'
----
-coverStyle:
-  ratio: '16:9'   # instead of ratio: 16:9
----
-```
-
-:::
-
 Special layout modes:
 
 - `odd-left` - Odd items left, even items right
@@ -735,21 +719,21 @@ Special layout modes:
   :post="{ path: '/article/ecxnxxd0/', title: 'Article Title',
   categoryList: [{id:'65f30c',sort:4,name:'Tutorial'}], createTime: '2024/09/18 09:19:36',
   lang:'en-US', excerpt:'', cover: 'https://api.pengzhanbo.cn/wallpaper/bing',
-  coverStyle: { layout: 'odd-left', ratio: '16/9', width: 300, compact: true } }"
+  coverStyle: { layout: 'odd-left', ratio: '16:9', width: 300, compact: true } }"
   :index="0"
 />
 <VPPostItem
   :post="{ path: '/article/ecxnxxd0/', title: 'Article Title',
   categoryList: [{id:'65f30c',sort:4,name:'Tutorial'}], createTime: '2024/09/18 09:19:36',
   lang:'en-US', excerpt:'', cover: 'https://api.pengzhanbo.cn/wallpaper/bing',
-  coverStyle: { layout: 'odd-left', ratio: '16/9', width: 300,compact: true } }"
+  coverStyle: { layout: 'odd-left', ratio: '16:9', width: 300,compact: true } }"
   :index="1"
 />
 <VPPostItem
   :post="{ path: '/article/ecxnxxd0/', title: 'Article Title',
   categoryList: [{id:'65f30c',sort:4,name:'Tutorial'}], createTime: '2024/09/18 09:19:36',
   lang:'en-US', excerpt:'', cover: 'https://api.pengzhanbo.cn/wallpaper/bing',
-  coverStyle: { layout: 'odd-left', ratio: '16/9', width: 300, compact: true } }"
+  coverStyle: { layout: 'odd-left', ratio: '16:9', width: 300, compact: true } }"
   :index="2"
 />
 </div>
@@ -760,6 +744,8 @@ Automatically switches to `top` layout on narrow-screen devices to ensure displa
 
 ## Article Metadata
 
+## 文章元数据
+
 In the collection, the `meta` option allows you to set the display method of article metadata,
 This setting will directly affect the display of metadata on both the **article list page** and the **article content page**:
 
@@ -777,7 +763,7 @@ export default defineUserConfig({
       {
         type: 'post',
         dir: 'blog',
-        title: 'Blog',
+        title: '博客',
         // [!code hl:11]
         meta: {
           tags: true, // Whether to display labels
@@ -806,7 +792,7 @@ export default defineThemeConfig({
     {
       type: 'post',
       dir: 'blog',
-      title: 'Blog',
+      title: '博客',
       // [!code hl:11]
       meta: {
         tags: true, // Whether to display labels

docs/en/guide/quick-start/collection.md

@@ -28,10 +28,10 @@ A typical VuePress static site has the following file structure:
 :::file-tree
 
 - my-site
-  - docs # Source directory
+  - docs \# Source directory
     - .vuepress/
     - …
-    - README.md # Homepage
+    - README.md \# Homepage
   - package.json
 
 :::

docs/en/guide/quick-start/intro.md

@@ -13,7 +13,7 @@ whether you are creating a **technical blog**, **personal journal**, **product d
 **knowledge base**, or **tutorial series**.
 
 Deep optimizations have been applied to typography and image display,
-with extensive enhancements specifically for Markdown syntax. This allows you to effortlessly
+with extensive enhancements specifically for Markdown syntax.This allows you to effortlessly
 create professional content that is **aesthetically pleasing, highly readable, and expressive**.
 
 ::: details New to VuePress?
@@ -42,7 +42,7 @@ a more beautiful, clean, and user-friendly reading experience.
   ==content encryption==, and ==article watermarking==.
 - **Code Presentation**: Support for code block ==grouping==, ==collapsing==, ==focusing==,
   ==line highlighting==, ==diff comparison==, and embedding ==code demos== from platforms like CodePen, JSFiddle, and CodeSandbox.
-- **Icon System**: Integration with [iconify](https://icon-sets.iconify.design/) providing access to
+- **Icon System**: Integration with [iconify](https://icon-sets.iconify.d/) providing access to
   **200,000+** ==icons==, with optional support for `iconfont` / `fontawesome` icon libraries.
 - **Media Embedding**: Support for ==PDF embedding==, and ==Bilibili/Youtube/Local Video== embedding.
 - **Chart Rendering**: Integration with multiple ==chart engines== including chart.js, Echarts, Mermaid, Flowchart, Markmap, and PlantUML.

docs/en/guide/quick-start/project-structure.md

@@ -13,22 +13,22 @@ For projects created via the [command-line tool](./usage.md#command-line-install
 ::: file-tree
 
 - .git/
-- **docs**              # Documentation source directory
-  - .vuepress/          # VuePress configuration directory
-    - public/           # Static assets
-    - client.ts         # Client configuration (optional)
-    - collections.ts    # Collections configuration (optional)
-    - config.ts         # VuePress main configuration
-    - navbar.ts         # Navbar configuration (optional)
-    - plume.config.ts   # Theme configuration file (optional)
-  - demo                 # `doc` type collection
+- **docs** \# Documentation source directory
+  - .vuepress  \# VuePress configuration directory
+    - public/ \# Static assets
+    - client.ts \# Client configuration (optional)
+    - collections.ts \# Collections configuration (optional)
+    - config.ts \# VuePress main configuration
+    - navbar.ts \# Navbar configuration (optional)
+    - plume.config.ts \# Theme configuration file (optional)
+  - demo \# `doc` type collection
     - foo.md
     - bar.md
-  - blog                 # `post` type collection
-    - preview            # Blog category
-      - markdown.md      # Category article
-    - article.md         # Blog article
-  - README.md            # Site homepage
+  - blog \# `post` type collection
+    - preview \# Blog category
+      - markdown.md \# Category article
+    - article.md \# Blog article
+  - README.md \# Site homepage
   - …
 - package.json
 - pnpm-lock.yaml

docs/en/guide/quick-start/sidebar.md

@@ -33,7 +33,7 @@ A typical project structure might look like:
   - rust           # Rust Programming Notes
     - tuple.md
     - struct.md
-  - README.md      # Site Homepage
+  - README.md        # Site Homepage
 :::
 
 ### Configuration via `sidebar`

docs/en/guide/quick-start/write.md

@@ -35,7 +35,7 @@ Page content starts after the second `---`.
 Frontmatter is a configuration block using
 [YAML](https://dev.to/paulasantamaria/introduction-to-yaml-125f) format, located at the top of a Markdown file and delimited by `---`.
 
-It is recommended to read the [Frontmatter Detailed Guide](../auto-frontmatter.md) for the complete syntax specification.
+It is recommended to read the [Frontmatter Detailed Guide](../../../../4.教程/frontmatter.md) for the complete syntax specification.
 :::
 
 ## Automatic Frontmatter Generation
@@ -139,14 +139,14 @@ The numeric part serves as the **sorting basis**. Directories without numbers ar
 ::: file-tree
 
 - docs
-  - blog  # post type collection
+  - blog \# post type collection
     - 1.Frontend
       - 1.html/
       - 2.css/
       - 3.javascript/
     - 2.Backend/
     - DevOps/
-  - typescript  # doc type collection
+  - typescript \# doc type collection
     - 1.Basics
       - 1.Variables.md
       - 2.Types.md

docs/en/guide/repl/frontend.md

@@ -532,8 +532,7 @@ Using the demo container to wrap demo code in a markdown file allows for quick d
 /* css code */
 ```
 :::
-````
-
+```
 ::::
 
 You can also wrap `::: code-tabs` within `::: demo` for better code block presentation:
@@ -563,8 +562,7 @@ You can also wrap `::: code-tabs` within `::: demo` for better code block presen
 ```
 :::
 ::::
-````
-
+```
 :::::
 
 ---

docs/en/guide/repl/kotlin.md

@@ -5,19 +5,19 @@ createTime: 2024/04/22 09:44:37
 permalink: /en/guide/repl/kotlin/
 ---
 
-## Overview
+## 概述
 
-The theme provides Kotlin code demonstrations, supporting online execution of Kotlin code.
+主题提供了 Kotlin 代码演示，支持 在线运行 Kotlin 代码。
 
 ::: important
-This feature works by submitting code to a server for compilation and execution, and only a single code file can be submitted at a time.
+该功能通过将 代码提交到 服务器 进行 编译并执行，且一次只能提交单个代码文件。
 
-Therefore, please do not use this feature to execute overly complex code, and avoid making execution requests too frequently.
+因此，请不要使用此功能 执行 过于复杂的代码，也不要过于频繁的进行执行请求。
 :::
 
-## Configuration
+## 配置
 
-This feature is disabled by default. You can enable it through configuration.
+该功能默认不启用，你可以通过配置来启用它。
 
 ```ts title=".vuepress/config.ts"
 export default defineUserConfig({
@@ -31,39 +31,39 @@ export default defineUserConfig({
 })
 ```
 
-## Usage
+## 使用
 
-Use the `::: kotlin-repl` container syntax to wrap Kotlin code blocks. The theme will inspect the code block and add an execution button.
+使用 `::: kotlin-repl` 容器语法 将 kotlin 代码块包裹起来。主题会检查代码块并添加执行按钮。
 
-### Read-Only Code Demo
+### 只读代码演示
 
-Kotlin code demos are read-only by default and cannot be edited.
+kotlin 代码演示默认是只读的，不可编辑。
 
 ````md
-::: kotlin-repl title="Custom Title"
+::: kotlin-repl title="自定义标题"
 ```kotlin
 // your kotlin code
 ```
 :::
 ````
 
-### Editable Code Demo
+### 可编辑代码演示
 
-If you need online editing and execution, wrap the code block in the `::: kotlin-repl editable` container syntax.
+如果需要在线编辑并执行，需要将代码块包裹在 `::: kotlin-repl editable` 容器语法中
 
 ````md
-::: kotlin-repl editable title="Custom Title"
+::: kotlin-repl editable title="自定义标题"
 ```kotlin
 // your kotlin code
 ```
 :::
 ````
 
-## Examples
+## 示例
 
-### Print Content
+### 打印内容
 
-**Input:**
+**输入：**
 
 ````md
 ::: kotlin-repl
@@ -78,7 +78,7 @@ fun main(args: Array<String>) {
 :::
 ````
 
-**Output:**
+**输出：**
 
 ::: kotlin-repl
 
@@ -93,7 +93,7 @@ fun main(args: Array<String>) {
 
 :::
 
-### Computation
+### 运算
 
 ::: kotlin-repl
 
@@ -109,9 +109,9 @@ fun main(args: Array<String>) {
 
 :::
 
-### Editable Code Demo
+### 可编辑代码演示
 
-**Input:**
+**输入：**
 
 ````md
 ::: kotlin-repl editable
@@ -126,7 +126,7 @@ fun main(args: Array<String>) {
 :::
 ````
 
-**Output:**
+**输出：**
 
 ::: kotlin-repl editable
 

docs/en/questions.md

@@ -2,7 +2,6 @@
 title: Frequently Asked Questions
 createTime: 2025/10/08 08:47:36
 permalink: /en/faq/
-article: false
 ---
 
 This document primarily covers common issues and solutions you might encounter while using the theme.
@@ -86,104 +85,3 @@ files (like `package-lock.json` or `pnpm-lock.yaml`) might be corrupted.
 
 Please directly delete the dependency lock files (`package-lock.json`, `pnpm-lock.yaml`, etc.)
 and the `node_modules` directory, then reinstall the dependencies.
-
-## How to hide the page footer?
-
-You can hide the footer by adding `footer: false` in the frontmatter of the Markdown file.
-
-```md title="post.md"
----
-footer: false
----
-
-content
-```
-
-[Configuration Documentation: **frontmatter > Footer**](../config/frontmatter/basic.md#footer){.read-more}
-
-Or you can hide the footer for all pages on the main site by adding `footer: false` in the theme configuration file.
-
-```ts title=".vuepress/config.ts"
-export default defineUserConfig({
-  theme: plumeTheme({
-    footer: false, // [!code ++]
-  })
-})
-```
-
-[Configuration Documentation: **Theme Configuration**](../config/theme.md#footer){.read-more}
-
-## Build error: `JavaScript heap out of memory`
-
-When executing `npm run docs:build`, you encounter an error similar to:
-
-```sh
-<--- Last few GCs --->
-
-[69161:0x7fe63aa00000]   137006 ms: xxxxxx
-[69161:0x7fe63aa00000]   139327 ms: xxxxxxxx
-
-<--- JS stacktrace --->
-FATAL ERROR: Reached heap limit Allocation failed - JavaScript heap out of memory
------ Native stack trace -----
-
-1: 0x107ce7c84 xxxxxxxxxxxx
-...
-```
-
-This is due to insufficient Node.js memory.
-
-Modify the Node.js memory limit by adding the following environment variables:
-
-**Method 1: In the current terminal session**:
-
-```sh
-export NODE_OPTIONS="--max_old_space_size=8192"
-npm run docs:build
-```
-
-==Note that this method is only effective for the current terminal session.=={.warning}
-
-**Method 2: In the local environment**:
-
-If you need to keep this environment variable long-term, you can modify the Node.js memory limit in your local environment:
-
-:::: steps
-
-- Install `cross-env` in your project
-
-  ::: npm-to
-
-  ```sh
-  npm install -D cross-env
-  ```
-
-  :::
-
-- Add `scripts` in `package.json`:
-
-  ```json
-  {
-    "scripts": {
-      "docs:build-local": "cross-env NODE_OPTIONS=\"--max_old_space_size=8192\" vuepress build docs --clean-cache --clean-temp"
-    }
-  }
-  ```
-
-::::
-
-When building locally, use `npm run docs:build-local` to build the package.
-
-**Method 3: In GitHub Actions**:
-
-Modify the `.github/workflows/deploy.yml` file and add the following environment variables:
-
-```yaml
-# ...
-- name: Build VuePress site
-  env: # [!code ++:2]
-    NODE_OPTIONS: --max_old_space_size=8192
-  run: npm run docs:build
-
-# ...
-```

docs/guide/chart/chart.md

@@ -51,7 +51,7 @@ export default defineUserConfig({
 :::
 ````
 
-图表配置请查看 [chart.js] 文档。
+图标配置请查看 [chart.js] 文档 。
 
 ## 示例
 

docs/guide/chart/flowchart.md

@@ -342,6 +342,6 @@ e=>end: End:>http://www.yahoo.com
 
 如果要在流程图中强调特定路径，则可以另外定义它，如下所示:
 
-```md
+```
 st@>op1({"stroke":"Red"})@>cond({"stroke":"Red","stroke-width":6,"arrow-end":"classic-wide-long"})@>c2({"stroke":"Red"})@>op2({"stroke":"Red"})@>e({"stroke":"Red"})
 ```

docs/guide/chart/plantuml.md

@@ -260,7 +260,7 @@ object NewYork
 
 map CapitalCity {
  UK *-> London
- USA*--> Washington
+ USA *--> Washington
  Germany *---> Berlin
 }
 
@@ -427,9 +427,9 @@ rectangle "Investigate" as I <<$bProcess>><<behavior>> #Business
 rectangle "Pay" as P <<$bProcess>><<behavior>> #Business
 
 HC *-down- CI
-HC*-down- NAS
+HC *-down- NAS
 HC *-down- V
-HC*-down- I
+HC *-down- I
 HC *-down- P
 
 CI -right->> NAS
@@ -574,16 +574,16 @@ caption figure 1
 title My super title
 
 * <&flag>Debian
-**<&globe>Ubuntu
-***Linux Mint
+** <&globe>Ubuntu
+*** Linux Mint
 *** Kubuntu
-***Lubuntu
+*** Lubuntu
 *** KDE Neon
 ** <&graph>LMDE
-**<&pulse>SolydXK
+** <&pulse>SolydXK
 ** <&people>SteamOS
 ** <&star>Raspbian with a very long name
-***<s>Raspmbc</s> => OSMC
+*** <s>Raspmbc</s> => OSMC
 *** <s>Raspyfi</s> => Volumio
 
 header
@@ -630,9 +630,9 @@ endlegend
 
 ```md
 @startjson
-# highlight "lastName"
-# highlight "address" / "city"
-# highlight "phoneNumbers" / "0" / "number"
+#highlight "lastName"
+#highlight "address" / "city"
+#highlight "phoneNumbers" / "0" / "number"
 {
   "firstName": "John",
   "lastName": "Smith",

docs/guide/code/code-tabs.md

@@ -7,7 +7,7 @@ permalink: /guide/code/group/
 
 ## 概述
 
-代码组（Code Tabs）是主题中用于并排展示多个相关代码片段的强大功能。
+代码组（Code Tabs）是 主题 中用于并排展示多个相关代码片段的强大功能。
 通过标签页形式组织代码，您可以清晰对比不同技术栈、配置方案或语言版本的实现差异。
 
 ## 基础语法

docs/guide/code/features.md

@@ -48,7 +48,7 @@ export default defineUserConfig({
 
 **输入：**
 
-````md
+````
 ```ts:line-numbers
 // 启用行号
 const line2 = 'This is line 2'
@@ -94,7 +94,7 @@ const line4 = 'This is line 4'
 
 **输入：**
 
-````md
+````
 ```js{4}
 export default {
   data () {
@@ -126,7 +126,7 @@ export default {
 
 **输入：**
 
-````md
+````
 ```js{1,4,6-8}
 export default { // Highlighted
   data () {
@@ -162,10 +162,10 @@ export default { // Highlighted
 
 **输入：**
 
-````md
+````
 ```js
 export default {
-  data() {
+  data () {
     return {
       msg: 'Highlighted!' // [\!code highlight]
     }
@@ -194,10 +194,10 @@ export default {
 
 **输入：**
 
-````md
+````
 ```js
 export default {
-  data() {
+  data () {
     return {
       msg: 'Focused!' // [\!code focus]
     }
@@ -241,10 +241,10 @@ pnpm install
 
 **输入：**
 
-````md
+````
 ```js
 export default {
-  data() {
+  data () {
     return {
       error: 'Removed', // [\!code --]
       warning: 'Added' // [\!code ++]
@@ -288,10 +288,10 @@ mkdir hello && cd hello  # [!code ++]
 
 **输入：**
 
-````md
+````
 ```js
 export default {
-  data() {
+  data () {
     return {
       error: 'Error', // [\!code error]
       warning: 'Warning' // [\!code warning]
@@ -333,7 +333,7 @@ mkdir hello && cd hello  # [!code warning]
 
 **输入：**
 
-````md
+````
 ```ts
 export function foo() { // [\!code word:Hello]
   const msg = 'Hello World'
@@ -355,7 +355,7 @@ export function foo() { // [!code word:Hello]
 
 **输入：**
 
-````md
+````
 ```ts
 // [\!code word:options:2]
 const options = { foo: 'bar' }

docs/guide/code/twoslash.md

@@ -641,7 +641,7 @@ str = 'Hello'
 你应该能够在控制台中查看到相关的错误信息，然后在错误信息的 `description` 中找到对应的错误码。
 然后再将错误码添加到 `@errors` 中。
 
-不用担心编译失败会终止进程，主题会在编译失败时显示错误信息，同时在代码块中输出未编译的代码。
+不用担心变异失败会终止进程，主题会在编译失败时显示错误信息，同时在代码块中输出未编译的代码。
 :::
 
 ### `@noErrors`

docs/guide/components/card-masonry.md

@@ -7,7 +7,7 @@ permalink: /guide/components/card-masonry/
 
 ## 概述
 
-瀑布流容器是一个通用的容器组件，你可以把任何内容放到 `<CardMasonry>` 里面，容器会自动计算每一个 **项** 的高度，
+瀑布流容器是一个 通用的容器组件，你可以把任何内容放到 `<CardMasonry>` 里面，容器会自动计算每一个 **项** 的高度，
 然后将它们按照瀑布流的方式进行排列。
 
 ::: details 什么是项 ？
@@ -59,7 +59,7 @@ permalink: /guide/components/card-masonry/
 ``` md
 ::: card-masonry cols="3" gap="16" <!-- [!code hl]-->
 
-![alt text](/images/1.png)
+![](/images/1.png)
 
 <!-- 更多内容 -->
 
@@ -77,19 +77,17 @@ permalink: /guide/components/card-masonry/
 ``` md
 ::: card-masonry
 
-![alt text](/images/1.png)
+![](image_url)
 
-![alt text](/images/2.png)
+![](image_url)
 
-![alt text](image_url)
+![](image_url)
 
-![alt text](image_url)
+![](image_url)
 
-![alt text](image_url)
+![](image_url)
 
-![alt text](image_url)
-
-![alt text](image_url)
+![](image_url)
 
 :::
 ```

docs/guide/components/home-box.md

@@ -7,7 +7,7 @@ permalink: /guide/components/home-box/
 
 ## 首页布局容器
 
-自定义首页时，使用 `<HomeBox>` 提供给区域的包装容器。
+自定义首页时，使用 `<HomeBox>` 提供给 区域 的 包装容器。
 
 ## Props
 

docs/guide/components/image-card.md

@@ -9,7 +9,7 @@ permalink: /guide/components/image-card/
 
 使用 `<ImageCard>` 组件在页面中显示图片卡片。
 
-图片卡片有别于 markdown 的普通插入图片方式，它展示与图片相关的更多信息，包括标题、描述、作者、链接等。
+图片卡片 有别于 markdown 的 普通插入图片方式，它展示与图片相关的更多信息，包括标题、描述、作者、链接等。
 适用于如 摄影作品、设计作品、宣传海报 等场景。
 
 ## Props