使用 VitePress 快速生成静态网站,支持安装依赖、初始化项目、本地预览、构建和部署。
VitePress Static website 生成器.是一项面向实际任务的技能,主要用于Feature Overview QQ快速使用VitePress生成静态网站. 支持安装依赖,初始化项目,本地预览,构建,以及 deplo。它将相关步骤、工具调用和结果整理方式集中到统一流程中,帮助使用者更快完成目标并减少重复操作。
实际使用前应先确认任务范围、数据来源、运行环境、必要权限和关键参数,再依据技能说明逐步执行;若输入条件不完整,应先补齐信息或采用保守配置,避免因错误假设导致结果偏离需求。
执行过程中需要关注工具调用是否成功、接口或依赖是否可用、输出格式是否符合预期,并对异常提示、缺失字段和边界情况进行处理;涉及批量任务时,还应保存进度,避免中断后重复操作。
使用 VitePress 快速生成静态网站。支持依赖安装、项目初始化、本地预览、构建及部署。
当用户需要创建静态网站时,请按以下流程操作:
首先确认用户已安装 Node.js:
node -v npm -v
如未安装,请提示用户先安装 Node.js(推荐 v18+)。
mkdircd npm init -y
npm add -D vitepress
创建基础目录结构:
/ ├── docs/ │ ├── .vitepress/ │ │ └── config.mts │ ├── index.md │ └── guide/ │ └── getting-started.md ├── package.json └── README.md
在 package.json 中添加以下内容:
{
"scripts": {
"docs:dev": "vitepress dev docs",
"docs:build": "vitepress build docs",
"docs:preview": "vitepress preview docs"
}
}
npm run docs:dev
默认访问地址:http://localhost:5173
npm run docs:build
输出目录:docs/.vitepress/dist/
详细配置选项请参阅 references/config-guide.md
关于自定义主题与样式,请参阅 references/theme-customization.md
关于部署至不同平台的说明,请参阅 references/deployment.md
| 命令 | 说明 |
|---|---|
npm run docs:dev |
启动本地开发服务器 |
npm run docs:build |
构建生产版本 |
npm run docs:preview |
预览构建结果 |
docs/.vitepress/dist/ 目录中.mts、.ts、.mjs、.js 格式