文章目录

• VuePress2.x
• • 1.1 安装安装VuePress2.x（手动安装）
  • 1.2 VuePress2.x 基本操作
• VuePress2.x主题
• • 2.1 安装VuePress2.x主题（yarn）
  • 2.2 报错解决（没效果，不用看）
  • 2.3 VuePress2.x主题 基本操作

VuePress2.x

1.1 安装安装VuePress2.x（手动安装）

这一章节会帮助你从头搭建一个简单的 VuePress 文档网站。如果你想在一个现有项目中使用 VuePress 管理文档，从步骤 3 开始。

• 步骤1: 创建并进入一个新目录

mkdir vuepress-starter
cd vuepress-starter

• 步骤2: 初始化项目
  YARN
  NPM

git init
yarn init

• 步骤3: 将 VuePress 安装为本地依赖
  YARN
  NPM

yarn add -D vuepress@next

• 步骤4: 在 package.json 中添加一些 scripts

{"scripts": {"docs:dev": "vuepress dev docs","docs:build": "vuepress build docs"}
}

• 步骤5: 将默认的临时目录和缓存目录添加到 .gitignore 文件中

echo 'node_modules' >> .gitignore
echo '.temp' >> .gitignore
echo '.cache' >> .gitignore

• 步骤6: 创建你的第一篇文档

mkdir docs
echo '# Hello VuePress' > docs/README.md

• 步骤7: 在本地启动服务器来开发你的文档网站
  YARN
  NPM

yarn docs:dev

VuePress 会在 http://localhost:8080 启动一个热重载的开发服务器。当你修改你的 Markdown 文件时，浏览器中的内容也会自动更新。

现在，你应该已经有了一个简单可用的 VuePress 文档网站。接下来，了解一下 VuePress 配置 相关的内容。

1.2 VuePress2.x 基本操作

VuePress2.x主题

2.1 安装VuePress2.x主题（yarn）

• 安装yarn

sudo npm install yarn -g

• 安装 Press2.x

yarn global add @vuepress-reco/theme-cli@1.0.7

• 初始化

theme-cli init

2.2 报错解决（没效果，不用看）

• zsh: command not found解决方案，bash 和 zsh 问题：
  • 方案1（无效）：安装umi：yarn global add umi
  • 方案2（无效）：输入以下代码，敲击完毕后输入 1、Y、1

/bin/zsh -c "$(curl -fsSL https://gitee.com/cunkai/HomebrewCN/raw/master/Homebrew.sh)"

2.3 VuePress2.x主题 基本操作

【参考资料】
VuePress官网：vuepress-reco