vuepress/docs/zh/guide/deploy.md

部署

下述的指南，将假定你将文档放置在项目的 docs 目录中，并使用默认的构建输出位置。

GitHub Pages

1. 将 .vuepress/config.js 的 base 设置成你仓库的名字，举个例子，如果你的仓库是 https://github.com/foo/bar, 部署的页面将会通过 https://foo.github.io/bar 来访问，此时，你应该将 base 设置为 "/bar/"。

2. 在你的项目中运行:

# 构建静态文件
vuepress build docs

# 切换到你的输出目录
cd docs/.vuepress/dist

git init
git add -A
git commit -m 'deploy'

# push 到你仓库的 gh-pages 分支
# 将 <USERNAME>/<REPO> 替换成你的信息
git push -f git@github.com:<USERNAME>/<REPO>.git master:gh-pages

你可以在你的持续集成的设置中，设置在每次 push 代码时自动运行上述脚本。

Netlify

1. 确保你已经有了构建你的文档的的 npm scripts：

{
  "scripts": {
    "build-docs": "vuepress build docs"
  }
}

2. 在 Netlify 中, 创建一个新的 Github 项目，并做一下设置:

• Build Command: npm run build-docs 或者 yarn build-docs
• Publish directory: docs/.vuepress/dist

3. 点击 deploy 按钮！