安装 VitePress

VitePress 是一个基于 Vue 的静态站点生成器。你可以通过 npm 或 yarn 来安装它。

1. 全局安装 VitePress：

npm install -g vitepress

2. 或者，创建一个新的项目并通过本地方式使用 VitePress：

npm create vitepress@latest my-vitepress-project
cd my-vitepress-project
npm install

创建一个新的 VitePress 项目

如果你选择本地安装，可以按照以下步骤进行：

1. 使用命令行工具初始化新项目：

npm create vitepress@latest my-vitepress-project

2. 进入项目目录并安装依赖：

cd my-vitepress-project
npm install

项目结构

VitePress 项目的典型结构如下：

my-vitepress-project/
├── .gitignore
├── docs/
│   └── index.md
├── .vitepress/
│   ├── config.js
│   └── theme
│       └── layouts.vue
├── package.json

其中，`docs/` 目录用于存放所有的文档文件（例如 Markdown 文件），`.vitepress/` 目录包含 VitePress 的配置和自定义主题。

编写文档

VitePress 使用 Markdown 语法来编写文档。你可以在 `docs/` 目录下创建新的 Markdown 文件（例如 `index.md`）并开始写作。

# 欢迎来到 VitePress 文档

这是一个使用 VitePress 编写的简单文档。

## 介绍
VitePress 是一个基于 Vue 的静态站点生成器。

运行项目

你可以通过以下命令来启动本地服务器并预览文档：

npm run dev

这将在 `http://localhost:4173` 上启动一个开发服务器。

构建项目

当你准备将文档部署到生产环境时，可以使用以下命令来生成静态文件：

npm run build

这将会在 `docs/.vitepress/dist` 目录下生成所有必要的文件。

主题自定义

VitePress 允许你通过修改 `.vitepress/theme/` 目录下的文件来自定义主题。例如，你可以编辑 `layouts.vue` 文件来改变页面的布局。