今天日常浏览开源项目,发现了一个很好看的东西
![](https://blog.klicn.com/wp-content/uploads/2024/12/microsoft_edge_screenshot_2024年12月20日-GMT08_00-上午7_22_12.png.jpg)
就是这个东西,vitepress,当然,这个是自己部署后的效果,抱着新鲜感和好奇的态度,就开始研究这个,因为小白原因,找个很久才知道这是vitepress(好看)
有可以做文档,有可以做博客,很好的东西,后面找到了一篇比较好的文档https://vitepress.yiov.top/,在帮助下完成了部署美化
这里就写自己部署的过程啦~
部署环境
系统:Windows Server 2022
开发环境:NodeJs v22.12.0:https://nodejs.org/zh-cn
编辑器:不建议使用记事本编辑,其他主流编辑器均可
![](https://blog.klicn.com/wp-content/uploads/2024/12/1734653708-image-1024x475.png)
安装NodeJS
前往NodeJs:https://nodejs.org/zh-cn,下载安装NodeJS,按照安装流程一路向下安装即可。
安装pnpm
#安装pnpm
npm install -g pnpm
#查看版本号
pnpm -v
开始部署
我们已经完成了开发环境的部署,在D盘下创建一个Dose目录"D:\Does"(例子),打开CMD,cd到到目录
D:
cd D:\Does
如果服务器在国内的话,就切换镜像源(淘宝镜像源)
npm config set registry https://registry.npmmirror.com
使用pnpm安装vitepress
pnpm add -D vitepress
vitepress安装完成后,我们进入vitepress安装向导
pnpm vitepress init
T Welcome to VitePress!
|
o Where should VitePress initialize the config? //这里询问安装目录,如果只部署单个vitepress,默认"./"就好,如果多个的话,建议输入"./项目文件夹名称",当然这里不管怎么样,还是建议"./项目文件夹名称"(个人喜好)
| ./docs
|
o Site title: //这里是项目的描述(自我理解)
| My Awesome Project
|
o Site description: //这里是项目的子描述(自我理解)
| A VitePress Site
|
o Theme: //选择主题,默认就好(我也看不懂,所以默认就好)
| Default Theme
|
o Use TypeScript for config and theme files?
| Yes
|
o Add VitePress npm scripts to package.json?
| Yes
|
— Done! Now run npm run docs:dev and start writing.
现在基础部署已经完成啦,现在启动开发环境
pnpm run docs:dev
启动后会生成一个 5137端口的本地调试地址 localhost:5137 ,浏览器访问就好