📢 公告
微信公众号二维码

欢迎大家关注我的公众号

Skip to content

使用VitePress搭建个人博客

因为vitepress要求Node.js的版本必须大于等于18,所以我们首先需要查看一下Node.js的版本,确保Node.js的版本大于等于18。

使用如下命令查看Node.js的版本:

bash
$ node --version
v18.9.0

下面,我们开始一步一步地使用vitepress创建个人博客啦。

1、创建博客根目录并进入目录:

bash
$ mkdir 15-vitepress-blog && cd 15-vitepress-blog

笔者汪小成这里的博客根目录设置为15-vitepress-blog

2、初始化项目:

bash
$ yarn init

上面的命令用于初始化一个新的Node.js项目,会在项目的根目录下生成一个package.json文件。

3、安装vitepressvue

bash
$ yarn add -D vitepress vue

4、使用vitepress设置向导快速创建一个基本项目:

bash
$ npx vitepress init

  Welcome to VitePress!

  Where should VitePress initialize the config?
  ./

  Site title:
  汪小成的日志

  Site description:
  A VitePress Site

  Theme:
  Default Theme + Customization

  Use TypeScript for config and theme files?
  No

  Add VitePress npm scripts to package.json?
  Yes

  Done! Now run npm run docs:dev and start writing.

在设置向导中,笔者汪小成做了如下设置:

  • 网站标题:汪小成的日志
  • 网站描述:A VitePress Site
  • 主题:Default Theme + Customization,默认主题+个性定制
  • 是否使用TypeScript:
  • 是否在package.json中添加VitePress npm脚本:

5、预览项目

使用如下命令启动项目:

bash
$ yarn docs:dev

待项目启动成功,在浏览器地址栏输入http://localhost:5173/会看下如下效果。

image-20230907130706054

6、目录结构

项目目录如下所示:

.
├── .vitepress
│         ├── config.mjs        # vitepress配置文件
│         └── theme             # 样式和主题
│             ├── index.js      # 自定义主题入口文件
│             └── style.css     # 自定义样式
├── api-examples.md             # 运行时 API 示例
├── index.md                    # 博客首页
├── markdown-examples.md        # Markdown语法示例
└── package.json

参考资料

最近更新时间: