UUID5升级方案
UUID5升级方案 问题背景 在项目运行过程中发现 UUID5 存在重复问题，具体表现为： - 发现重复的 UUID5：e 78b 7 和 b 7a 6f - 原因：5位十六进制字符的冲突概率在 400+ 文件的项目中已经不可忽视 - 影响：导致不同页面使用相同的 permalink，造成路由冲突 冲突概率分析 原始方案 - UUID长度：5位十六进制字符 - 可能组合：16^5 =...
建站/本站主题-文章索引
2025年9月27日
浏览量：--
共找到 17 篇文章
显示 17 / 17 篇文章
Twikoo 评论系统数据重置指南
Twikoo 评论系统数据重置指南 本文档提供了如何重置 Twikoo 评论系统数据的简要步骤，适用于阿里云 ECS 环境。 Docker 环境重置 Twikoo Docker 环境重置管理员账户 如果您使用 Docker 部署了 Twikoo，可以通过以下步骤重置管理员账户： `bash 1. 查看当前运行的 Twikoo 容器 docker ps | grep twikoo 2. 进入...
阿里云 ECS 双域名 Nginx + HTTPS 配置备忘
阿里云 ECS 双域名 Nginx + HTTPS 配置备忘 > 适用场景： > - 阿里云 ECS 单实例 > - 已备案双域名（示例 chiplayout.net & chiplayout.top） > - 同一 Web 目录 > - 自动续期 HTTPS 证书 --- 1. 前提检查 | 项目 | 要求 | |---|---| | 安全组 | 入方向 TCP 80 & 443 已放行 |...
ArticleHeader 组件使用说明
Article Header 组件使用说明 概述 Article Header 是一个自动为Markdown文档添加文章头部信息的Vue组件，包含路径导航、发布时间、字数统计、阅读时间等信息。 功能特性 1. 路径导航（面包屑） - 自动根据当前页面路径生成面包屑导航 - 支持多级目录结构 - 自动处理数字前缀（如 "10.版图" → "版图"） - 响应式设计，移动端友好 2. 文章元信息 -...
评论系统 - Twikoo 集成与双域名部署
在主题中集成 Twikoo 评论系统，支持双域名自动选择服务与首页/索引页排除显示
侧边栏与目录
侧边栏与目录 能力 - 多级目录折叠 - 基于文件夹结构的自动化生成 关键点 - 目录标题优先使用 frontmatter title - 链接优先 permalink，回退到路径 相关工具 - scripts/generate-indexes*.js：索引与 md 列表 - .vitepress/utils/sidebar.*：侧边栏数据
功能总览
概览本站 VitePress + Tailwind 主题的核心功能与模块划分
构建与优化
构建与优化 体积告警处理 - build.chunk Size Warning Limit 提升阈值至 1000 - 可按需配置 manual Chunks 切分 性能建议 - 图片与资源按需懒加载 - 组件分包与路由懒加载
样式与 Tailwind
样式与 Tailwind Tailwind 配置 - tailwind.config.js 与 .vitepress/theme/styles/* - 预设、颜色、断点与容器宽度 自定义样式层 - preflight.css 重置 - tailwind.css 引入 utilities - custom.css 自定义组件样式 主题内覆盖策略（与 Vite Press 配合） - 优先使用...
版权声明模块（CopyrightCard）
版权声明模块（Copyright Card） 目标 - 在文档页正文底部（页脚前）插入统一的版权声明卡片，自动展示作者、文章标题、链接与协议信息。 - 支持明暗主题、响应式与页面级开关；索引页默认不显示。 接入位置 - 插槽：doc-footer-before - 接入文件：docs/.vitepress/theme/index.ts `ts //...
组件库
组件库 图标与 UI - all Icon.vue 汇总内置图标 - 按需引入按钮、卡片等组件 代码片段：统一图标组件 `vue import { h, type Functional Component } from 'vue' const Calendar Icon: Functional Component = () => h('svg', { view Box: '0 0 1024...
自动 Frontmatter
自动 Frontmatter 功能说明 自动为所有文档和目录索引页生成/更新 frontmatter，包括 permalink、title、create Time、update Time 等字段，确保文档元信息的完整性和一致性。 实现流程 1. 创建索引页 - 检查每个目录是否存在 index.md - 如果不存在，创建基础的 index.md 文件（不含首页） 2. Frontmatter...
自动索引（Auto Index）
自动索引（Auto Index） 功能说明 自动为每个目录生成 index.md 的文章列表页，显示该目录下的所有文章，支持分页和加载更多功能。 实现流程 1. 创建索引页 - 在每个目录下检查是否存在 index.md - 如果不存在，则创建基础的 index.md 文件（不含首页） 2. Auto Frontmatter 处理 - 为所有 index.md 文件生成/更新...
路径导航（面包屑）
路径导航（面包屑） 功能说明 在文档页顶部展示基于目录结构的面包屑导航，显示真实的目录路径，但链接指向对应的 uuid 5 permalink。 实现方式 1. 路径解析 - 根据当前页面的 route Path 和 relative Path 生成路径段 - 支持多层回退机制： 1. 优先使用 route Path 解析路径段 2. 当 route Path 不足时，从 relative...
部署与运维
部署与运维 构建命令 `bash pnpm docs:build ` 部署 - 静态资源发布至任意静态主机（如 Git Hub Pages、Vercel、Netlify、本地 NAS） - 确保 base 与自定义域名映射正确 运维 - 生成文章索引与校验脚本：scripts/* - 定期检查无效链接与 404 资源
今日任务完成情况
今日任务完成情况 ✅ 已完成任务 - [x] 修复面包屑导航显示问题 - [x] 解决 Windows 换行符导致的 frontmatter 解析失败 - [x] 实现面包屑跳过最后一级（当前页面） - [x] 确保面包屑链接指向正确的 permalink - [x] 修复 UUID5 重复问题，升级到 6 位字符 - [x] 优化索引生成日志输出，减少噪音 - [x]...
开发过程
开发过程 > 本文档记录了开发过程，方便以后查阅 0. 项目原因 其实我不是一个前端，而是一名集成电路工程师，但对写code很感兴趣。 本着欲求之，则学之，即得之，当共之的原则，建立了这个分享平台(当然，那时候没有微信公众号等) 从当初的wordpress到hexo, 从vuepress到vitepress，也不是说哪个好，只是自己喜欢用哪个，就一直用哪个。...