惯性聚合 高效追踪和阅读你感兴趣的博客、新闻、科技资讯
阅读原文 在惯性聚合中打开

推荐订阅源

SecWiki News
SecWiki News
罗磊的独立博客
U
Unit 42
I
InfoQ
B
Blog RSS Feed
Google DeepMind News
Google DeepMind News
J
Java Code Geeks
Blog — PlanetScale
Blog — PlanetScale
The GitHub Blog
The GitHub Blog
钛媒体:引领未来商业与生活新知
钛媒体:引领未来商业与生活新知
B
Blog
S
SegmentFault 最新的问题
V
Visual Studio Blog
Engineering at Meta
Engineering at Meta
Microsoft Security Blog
Microsoft Security Blog
月光博客
月光博客
Vercel News
Vercel News
Cyber Security Advisories - MS-ISAC
Cyber Security Advisories - MS-ISAC
A
About on SuperTechFans
博客园 - 三生石上(FineUI控件)
博客园_首页
腾讯CDC
F
Fortinet All Blogs
OSCHINA 社区最新新闻
OSCHINA 社区最新新闻
Hugging Face - Blog
Hugging Face - Blog
MongoDB | Blog
MongoDB | Blog
阮一峰的网络日志
阮一峰的网络日志
D
Docker
N
Netflix TechBlog - Medium
云风的 BLOG
云风的 BLOG
Apple Machine Learning Research
Apple Machine Learning Research
Microsoft Azure Blog
Microsoft Azure Blog
Martin Fowler
Martin Fowler
人人都是产品经理
人人都是产品经理
酷 壳 – CoolShell
酷 壳 – CoolShell
爱范儿
爱范儿
大猫的无限游戏
大猫的无限游戏
V
V2EX
Last Week in AI
Last Week in AI
博客园 - 司徒正美
freeCodeCamp Programming Tutorials: Python, JavaScript, Git & More
IT之家
IT之家
L
LangChain Blog
WordPress大学
WordPress大学
Y
Y Combinator Blog
让小产品的独立变现更简单 - ezindie.com
让小产品的独立变现更简单 - ezindie.com
M
MIT News - Artificial intelligence
The Cloudflare Blog
T
The Blog of Author Tim Ferriss
宝玉的分享
宝玉的分享

Hyde Blog

Hyde Blog Hyde Blog Hyde Blog Hyde Blog Hyde Blog Hyde Blog Hyde Blog Hyde Blog Hyde Blog Hyde Blog Hyde Blog Hyde Blog Hyde Blog Hyde Blog Hyde Blog Hyde Blog Hyde Blog Hyde Blog Hyde Blog Hyde Blog Hyde Blog Hyde Blog Hyde Blog Hyde Blog Hyde Blog Hyde Blog Hyde Blog Hyde Blog Hyde Blog Hyde Blog Hyde Blog Hyde Blog Hyde Blog Hyde Blog Hyde Blog Hyde Blog Hyde Blog Hyde Blog Hyde Blog Hyde Blog Hyde Blog Hyde Blog Hyde Blog Hyde Blog Hyde Blog Hyde Blog Hyde Blog Hyde Blog Hyde Blog Hyde Blog Hyde Blog Hyde Blog Hyde Blog Hyde Blog Hyde Blog Hyde Blog Hyde Blog Hyde Blog Hyde Blog Hyde Blog Hyde Blog Hyde Blog Hyde Blog Hyde Blog Hyde Blog Hyde Blog Hyde Blog Hyde Blog Hyde Blog Hyde Blog Hyde Blog Hyde Blog Hyde Blog Hyde Blog Hyde Blog Hyde Blog Hyde Blog Hyde Blog Hyde Blog Hyde Blog Hyde Blog Hyde Blog Hyde Blog Hyde Blog Hyde Blog Hyde Blog Hyde Blog Hyde Blog Hyde Blog Hyde Blog Hyde Blog 关于我 关于我 Hyde Blog Hyde Blog Hyde Blog Hyde Blog Hyde Blog Hyde Blog Hyde Blog
Hyde Blog
Hyde · 2026-05-06 · via Hyde Blog

快速开始 ​

版本 ​

Teek badge

VitePress 安装 ​

前置准备 ​

VitePress 可以单独使用,也可以安装到现有项目中。在这两种情况下,都可以使用以下方式安装它:

pnpmnpmyarnyarn (pnp)bun

sh

$ pnpm add -D vitepress

sh

$ yarn add -D vitepress

sh

$ yarn add -D vitepress vue

安装向导 ​

VitePress 附带一个命令行设置向导,可以帮助你构建一个基本项目。安装后,通过运行以下命令启动向导:

将需要回答几个简单的问题:

md

┌ Welcome to VitePress!

◇ Where should VitePress initialize the config?
│ ./docs

◇ Where should VitePress look for your markdown files?
│ ./docs

◇ Site title:
│ My Awesome Project

◇ Site description:
│ A VitePress Site

◇ Theme:
│ Default Theme

◇ Use TypeScript for config and theme files?
│ Yes

◇ Add VitePress npm scripts to package.json?
│ Yes

◇ Add a prefix for VitePress npm scripts?
│ Yes

◇ Prefix for VitePress npm scripts:
│ docs

└ Done! Now run pnpm run docs:dev and start writing.

在线安装推荐

建议使用如下包管理器安装 vitepress-theme-teek

pnpmyarnnpm

sh

pnpm install vitepress-theme-teek -D

sh

yarn add vitepress-theme-teek -D

sh

npm install vitepress-theme-teek -D

在线与本地区别 ​

如果想要基于 Teek 二次开发,自定义自己的风格,那么请采用本地安装方式。

Teek 不定期提供新特性或者修复 Bug,如果想要及时享用,那么请采用在线安装方式,届时只需要更新版本即可:

pnpmyarnnpm

sh

pnpm install vitepress-theme-teek@latest -D

sh

yarn add vitepress-theme-teek@latest -D

sh

npm install vitepress-theme-teek@latest -D

引入主题 ​

根据 Vitepress 的要求,需要在 .vitepress/theme/index.ts 文件中引入 Teek 主题。如果没有该路径,需要先创建它。

bash

cd docs\.vitepress
mkdir theme

ts

import Teek from "vitepress-theme-teek";
import "vitepress-theme-teek/index.css";

export default {
  extends: Teek,
};

然后在 .vitepress/config.ts 文件中引入 Teek 的配置信息:

ts

// .vitepress/config.mts
import { defineConfig } from "vitepress";
import { defineTeekConfig } from "vitepress-theme-teek/config";

// Teek 主题配置
const teekConfig = defineTeekConfig({});

// VitePress 配置
export default defineConfig({
  extends: teekConfig,
  // ...
});

安装依赖 ​

bash

# 可选
pnpm install @waline/client @giscus/vue artalk -D #安装评论插件
pnpm add -D @mdit-vue/shared #安装 mdit-vue 共享模块,茂茂导航插件需要用
pnpm add -D canvas-confetti  # 安装 canvas 五彩纸屑动画库
pnpm add -D nprogress-v2  # 安装 nprogress-v2 进度条插件
pnpm add -D rollup-plugin-visualizer  # 安装 rollup 可视化插件
pnpm add -D terser  # 安装 terser 代码压缩工具
pnpm add -D vitepress-markdown-timeline  # 安装 vitepress 的 markdown 时间线插件
pnpm add -D vitepress-plugin-group-icons  # 安装 vitepress 的图标分组插件
pnpm add -D @vueuse/core  # 安装 VueUse 工具库
pnpm add -D oh-my-live2d  # 安装 oh-my-live2d 看板娘插件
pnpm add -D parallax-js  # 安装 parallax-js 视差滚动插件
pnpm add -D vite-plugin-imagemin  # 安装 vite 的图片压缩插件
pnpm add -D vue  # 安装 Vue 3 框架
pnpm add -D sass  #安装sass
pnpm add -D echarts # 安装 ECharts 数据可视化库,用于创建交互式图表
pnpm add -D typescript # 安装 TypeScript,用于编写类型安全的代码
pnpm add vitepress-plugin-rss # 安装 VitePress 插件,用于生成 RSS 订阅

#以下依赖已去除,不在使用导航栏音乐图标,已弃
pnpm add -D element-plus  # 安装 ElementPlus 组件库
pnpm add -D @element-plus/icons-vue  # 安装 ElementPlus 的 Vue 图标库
pnpm add -D vitepress-plugin-llms  # 安装 VitePress 插件,用于支持大语言模型相关功能
pnpm add -D vitepress-plugin-nprogress  # 安装 vitepress 的进度条插件

启动运行 ​

该工具还应该将以下 npm 脚本注入到 package.json 中:

package.json

json

{
  ...
  "scripts": {
    "docs:dev": "vitepress dev docs",
    "docs:build": "vitepress build docs",
    "docs:preview": "vitepress preview docs"
  },
  ...
}

docs:dev 脚本将启动具有即时热更新的本地开发服务器。使用以下命令运行它:

除了 npm 脚本,还可以直接调用 VitePress:

pnpmnpmyarnbun

sh

$ pnpm vitepress dev docs

sh

$ npx vitepress dev docs

sh

$ yarn vitepress dev docs

sh

$ bun vitepress dev docs

构建打包 ​

请阅读构建

升级 ​

pnpmnpmyarn

sh

$ pnpm add vitepress-theme-teek@latest -D

sh

$ npm add vitepress-theme-teek@latest -D

sh

$ yarn add vitepress-theme-teek@latest -D