如何通过vercel白嫖部署vitepress
vercel 简介
Vercel是一个面向前端开发者的云平台,专为静态和动态网站提供快速部署和托管服务。
它具有以下主要特点:
快速部署:支持将前端应用、静态网站和API快速部署到全球CDN网络
自动化流程:与Git集成,实现代码推送后的自动构建和部署
Serverless架构:提供无服务器功能,简化后端开发和扩展
性能优化:全球CDN、图像优化等功能提升网站性能
易用性:直观的界面和简单的命令行工具,降低使用门槛
免费计划:为个人用户提供免费的基础服务,足以满足大多数个人项目需求
Vercel的设计理念是让开发者专注于代码编写,而无需过多关注服务器管理和部署细节,从而提高开发效率和用户体验
VitePress 简介
VitePress是一个基于Vite构建的静态站点生成器,专为创建快速、以内容为中心的网站而设计。
作为VuePress的精神继承者,VitePress提供了以下主要特点:
基于Vue 3和Vite,提供更快的开发体验和更好的性能
更轻量级的页面,通过Vue 3的tree-shaking和Rollup代码拆分优化
简化的配置和更灵活的自定义API
内置Markdown扩展,支持代码高亮、表格等高级功能
面向未来的设计,支持原生ES模块和CSS变量
VitePress适用于构建技术文档、博客、个人作品集等各种类型的网站,同时保持了极快的开发和构建速度。
它通过优化静态内容生成和动态内容水合,在保持交互性的同时实现了卓越的性能。
VitePress 应用场景
VitePress作为一个强大而灵活的静态站点生成器,可以用于创建多种类型的网站和文档:
技术文档:VitePress的默认主题专为技术文档设计,支持代码高亮、表格和其他高级功能,非常适合创建API文档、开发指南等。
博客:通过自定义主题和利用VitePress的数据加载API,可以轻松构建个人或团队博客。
个人作品集:利用VitePress的灵活性,可以创建展示个人项目和技能的作品集网站。
营销网站:VitePress支持完全自定义的主题,可以用于构建吸引人的产品或服务营销网站。
知识库:利用VitePress的Markdown支持和搜索功能,可以创建内部或公共知识库系统。
教程网站:VitePress的Vue增强Markdown功能使其非常适合创建交互式教程和学习资源。
VitePress的高性能、简单配置和现代化开发体验使其成为构建各种静态网站的理想选择,特别适合那些需要快速加载和良好SEO的项目。
部署安装
部署到本地
- 在下面过程中,注意npx vitepress init运行之后,md目录需要放在/docs里.
- 本地运行命令
mkdir xvitepress
cd xvitepress
npm add -D vitepress
npx vitepress init
- 看到结果页面
部署到Vercel
将VitePress项目部署到Vercel非常简单,只需几个步骤即可完成:
在Vercel仪表板中创建新项目并导入您的VitePress Git仓库
Vercel会自动检测VitePress项目并配置正确的设置
确保构建命令设置为npm run docs:build
输出目录为docs/.vitepress/dist
点击部署按钮,Vercel将自动构建和部署您的网站
Vercel为VitePress项目提供了零配置部署,会自动优化设置以提高性能,如为JavaScript和CSS资源添加"immutable" HTTP缓存头。
每次向主分支推送更改时,Vercel都会自动重新部署您的网站,确保内容始终保持最新。
部署时可能会碰到的问题
- 如果你采用
npx vitepress init进行安装,请务必把*.md文件的目录放到docs目录下,否则在部署vercel时,你可能会碰到报错:
Error: Command "vitepress build" exited with 127 Error: Check your logs at https://xxxxxx.vercel.app/_logs or run `vercel logs xxxxx.vercel.app`