UUID5升级方案
UUID5升级方案 问题背景 在项目运行过程中发现 UUID5 存在重复问题，具体表现为： - 发现重复的 UUID5：e 78b 7 和 b 7a 6f - 原因：5位十六进制字符的冲突概率在 400+ 文件的项目中已经不可忽视 - 影响：导致不同页面使用相同的 permalink，造成路由冲突 冲突概率分析 原始方案 - UUID长度：5位十六进制字符 - 可能组合：16^5 =...
建站-文章索引
2025年9月27日
浏览量：--
共找到 102 篇文章
显示 30 / 102 篇文章
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 资源
git误推处理
仅修改 .gitignore 无法删除 Git Hub 上已存在的文件夹，原因如下： - .gitignore 的作用是忽略未被 Git 跟踪的文件/文件夹，阻止它们被添加到版本控制中； - 对于已经提交到 Git Hub 的文件夹（即已被 Git 跟踪），.gitignore 无法使其从远程仓库中删除，只会忽略未来的修改。 正确做法：结合 .gitignore 和 Git 命令 如果需要删除...
pnpm安装
date: 2025-08-22 15:35:55 title: pnpm安装 permalink: /website/198b 3 categories: - my Site create Time: 2025-09-22 T10:00:57.039 Z --- pnpm安装 使用npm安装pnpm `powershell npm install -g pnpm ` 验证...
自定义组件
自定义组件
wordpress(XML)转markdown
wordpress(XML)转markdown 为什么要XML转MD 下载Node.js 能玩这个的，应该都安装过了 从wordpress下载XML 登陆wordpress后台 选 工具 --> 导出 解决：git SSL certificate problem: unable to get local issuer certificate 错误： git SSL certificate...
开发指南
开发指南 开发环境 | 类型 | 名称 | 版本 | | :------------ | :---------------- | :--------------- | | 操作系统 | Windows 11 专业版 | 26100.3476 | | 开发工具 | Microsoft VS Code | 1.96.2 | | 调试工具 | Microsoft Edge |...
frontmatter 配置
frontmatter 配置 frontmatter 支持基于页面的配置。在每个 Markdown 文件中，可以使用 frontmatter 配置来覆盖 主题配置 中的大部分选项。 首页配置 description Teek 提供了 description 选项，用于在首页 Banner 展示一些描述信息，您可以通过 tk.description 或者 tk.banner.description...
私密文章
私密文章 私密文章需要一个登录页进行登录，如果你想先体验登录页的效果，在导航栏 功能页 -> 登录页 点击查看。 您也可以通过 teek-login-page 插槽自定义登录页。 `vue import Teek from "vitepress-theme-teek"; import Your Login Page Component from "./Your Login Page...
功能页配置
功能页配置 私密文章（登录页） 什么是登录页？在导航栏 功能页 -> 登录页 点击查看效果。 您可以通过 teek-login-page 插槽自定义登录页。 使用登录页需要 2 个步骤： - 创建一个登录页，如何创建请看 登录页 - 开启私密文章监听 `ts // .vitepress/config.mts import { define Teek Config } from...
站点统计
站点统计 Teek 集成了三种常见的站点统计工具： - 百度分析 Baidu Analytics - 谷歌分析 Google Analytics - Umami 分析 让你可以轻松地在 Vite Press 网站中集成并管理这些分析工具。无论是谷歌分析的强大功能，还是百度统计对中国市场的适配，或者是 Umami 的隐私友好型方案，都可以通过这个插件快速集成并使用。 百度统计 `ts //...
开发技巧
开发技巧 介绍 Teek 开发路程的一些技巧。 规范 Teek 建议在进行项目开发时，一个文件的代码行数推荐 300 行以下，最好不超过 500 行，禁止超过 1000 行。 如果超过 300+ 行，应该考虑下是否可以拆分为多个文件，这是一个良好的 结构化思维和分治思维。 ::: tip Teek 建议您在开发前先思考有哪些模块，然后分别创建模块文件，而不是先在一个文件写完，再拆分。 :::...
路由钩子
路由钩子 Vite Press 提供的 use Router 有 4 个路由钩子，分别为： - on Before Route Change：路由变化前触发，如果在该钩子函数中返回 false，则不会进行路由跳转 - on Before Page Load：页面加载前执行，在 on Before Route Change 之后触发，如果在该钩子函数中返回 false，则不会进行路由跳转 - on...
贡献指南
感谢您使用 Teek。 以下是关于向 Teek 提交反馈或代码的指南。在向 Teek 提交 Issue 或者 PR 之前，请先花几分钟时间阅读以下内容。 Issue 规范 - 遇到问题时，请先确认这个问题是否已经在 Issue 中有记录或者已被修复 - 提 Issue 时，请用简短的语言描述遇到的问题，并添加出现问题时的环境和复现步骤，必要时需提供可复现问题最小代码仓库 环境包含 - 浏览器...
鸣谢
鸣谢 本文记录 Teek 在成长过程中帮忙测试、开发的小伙伴们，以及 Teek 参考的其他优质 Vite Press、Vue Press 主题，感谢你们让 Teek 更加优秀。 主题 Teek 的灵感主要来自于 vuepress-theme-vdoing，在 Vite Press 没有出来之前，Teek 使用 vuepress-theme-vdoing 搭建的博客站，因此 Teek 含有...
样式增强
样式增强 Teek 提供了一些样式文件来加强 Vite Press 和 Teek 的样式，比如： > Vite Press 文档风格首页添加彩色渐变动画、文章一级标题添加渐变色、Banner 描述添加渐变效果、侧边栏标题组字号加粗等。 > Teek 首页 Banner 描述添加渐变效果、首页 Banner 壁纸添加缩放动画等 这些样式文件并不会直接生效，您需要手动引入这些文件。 Vite...
主题配置
主题配置 在主题开发中，往往需要提供一些配置来丰富主题的功能，最简单的是和 Vite Press 的 theme Config 配置合在一起： `ts {8} // .vitepress/config.mts import { define Config } from "vitepress"; export default define Config({ // ... theme Config:...