今天日常浏览开源项目,发现了一个很好看的东西

就是这个东西,vitepress,当然,这个是自己部署后的效果,抱着新鲜感和好奇的态度,就开始研究这个,因为小白原因,找个很久才知道这是vitepress(好看)

有可以做文档,有可以做博客,很好的东西,后面找到了一篇比较好的文档https://vitepress.yiov.top/,在帮助下完成了部署美化


这里就写自己部署的过程啦~

部署环境

系统:Windows Server 2022

开发环境:NodeJs v22.12.0https://nodejs.org/zh-cn

编辑器:不建议使用记事本编辑,其他主流编辑器均可

安装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 ,浏览器访问就好

美化参考https://vitepress.yiov.top/style.html

飞萤扑火,向死而生
最后更新于 2024-12-20