VitePress安装部署

VitePress安装部署

VitePress安装步骤

安装 Node环境

官网下载:https://nodejs.org/zh-cn

傻瓜式安装到完成

npm环境

安装完Node环境之后,可以直接运行下面的命令安装npm

json 复制代码
npm install -g pnpm

关于pnpm源:

有时候需要国内源,不全的时候又要切换到默认源,比较麻烦,以下提供几个源:

设置镜像源,可以使用淘宝源

pnpm config set registry https://registry.npm.taobao.org/

切回官方镜像

npm config set registry https://registry.npmmirror.com/

具体的教程可以参考:https://blog.csdn.net/qq_43684588/article/details/134554654

初始化项目

新建一个空的目录:D:\project2024\VitePress

json 复制代码
$ pnpm init    # 初始化目录

Wrote to D:\project2024\VitePress\package.json

{
  "name": "VitePress",
  "version": "1.0.0",
  "description": "",
  "main": "index.js",
  "scripts": {
    "test": "echo \"Error: no test specified\" && exit 1"
  },
  "keywords": [],
  "author": "",
  "license": "ISC"
}

安装VitePress

js 复制代码
$ pnpm add -D vitepress    # 安装VitePress

Progress: resolved 1, reused 0, downloaded 0, added 0
Progress: resolved 17, reused 0, downloaded 4, added 0
Progress: resolved 58, reused 0, downloaded 14, added 0
Progress: resolved 60, reused 0, downloaded 31, added 0
Progress: resolved 75, reused 0, downloaded 55, added 0
Packages: +85
++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
Progress: resolved 123, reused 0, downloaded 82, added 0
Progress: resolved 123, reused 0, downloaded 84, added 52
Progress: resolved 123, reused 0, downloaded 84, added 68
Progress: resolved 123, reused 0, downloaded 84, added 69
Progress: resolved 123, reused 0, downloaded 85, added 85, done
.../esbuild@0.21.5/node_modules/esbuild postinstall$ node install.js
.../node_modules/vue-demi postinstall$ node -e "try{require('./scripts/postinstall.js')}catch(e){}"
.../node_modules/vue-demi postinstall: Done
.../esbuild@0.21.5/node_modules/esbuild postinstall: Done

devDependencies:
+ vitepress 1.2.3

Done in 13.5s

初始化VitePress

需要注意的是:我习惯用git的命令窗口,上面的步骤都是在git的命令窗口做的,但是到了这一步的时候git命令窗口就会出现问题。所以我切换成了cmd命令窗口

js 复制代码
npx vitepress init   # 初始化VitePress

T  Welcome to VitePress!
|
o  Where should VitePress initialize the config?
|  ./docs
|
o  Site title:
|  My Awesome Project
|
o  Site description:
|  A VitePress Site
|
o  Theme:
|  Default Theme + Customization
|
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.

Tips:
- Since you've chosen to customize the theme, you should also explicitly install vue as a dev dependency.

项目目录结构

在 docs 文件夹中创建 public 文件夹,用于存放项目图片

js 复制代码
.
├── docs
│   ├── .vitepress
│   │   └── config.mts
│   ├── api-examples.md
│   ├── index.md
│   ├── markdown-examples.md
├── package.json
└── pnpm-lock.yaml

运行项目

js 复制代码
pnpm run docs:dev


  vitepress v1.2.3

  ➜  Local:   http://localhost:5173/
  ➜  Network: use --host to expose
  ➜  press h to show help

这样就部署完成了

相关推荐
行者-全栈开发4 天前
【供应链攻击】CVE-2026-45321:TanStack供应链攻击漏洞深度解析与修复指南
arcgis
思特奇时空智能6 天前
大规模点要素地图渲染性能优化实践
vue.js·arcgis·性能优化·node.js·html·gis·webgl
上海懒图科技13 天前
工厂厂区电子地图定位导航:厂区人车精准定位,安全合规双保障
前端·arcgis·vue
非科班Java出身GISer17 天前
ArcGIS JS 基础教程(48):SceneView watch 状态监听
arcgis·arcgis js基础·arcgis js入门·arcgis js监听状态·arcgis js监听事件·arcgis js 监听飞行·arcgis js 监听功能
JudithHuang19 天前
React 嵌套路由与布局
前端·react.js·arcgis·react·react router
Dxy123931021620 天前
JS DES 加密详解
开发语言·javascript·arcgis
非科班Java出身GISer23 天前
ArcGIS JS 基础教程(46):编辑要素属性 FeatureForm
arcgis·arcgis js编辑要素·arcgis js 要素·arcgis js要素属性·arcgis js 编辑属性·arcgis js编辑要素属性
梅如你24 天前
ISPRS | 1990-2020年间中国人工林与天然林的空间分布数据
arcgis·gis·遥感
limit00751 个月前
公开 WMTS / XYZ 瓦片接入 Cesium:6 类常见问题与排查顺序
chrome·低代码·arcgis·web3·旅游
limit00751 个月前
三维模型悬空与切片偏移的排查顺序
低代码·3d·arcgis·web3·安卓·webgl