介绍
VuePress 由两部分组成:一个以 Vue 驱动的主题系统的简约静态网站生成工具,和一个为编写技术文档而优化的默认主题。它是为了支持 Vue 子项目的文档需求而创建的。
由 VuePress 生成的每个页面,都具有相应的预渲染静态 HTML,它们能提供出色的加载性能,并且对 SEO 友好。然而,页面加载之后,Vue 就会将这些静态内容,接管为完整的单页面应用程序(SPA)。当用户在浏览站点时,可以按需加载其他页面。
部署 以下指南假设你将文档放置在项目的 docs 目录中,并使用默认的编译输出位置。
GitHub 页面
将 .vuepress/config.js 中的 base 设置为你的仓库名称。例如,如果你的仓库是 https://github.com/foo/bar ,则已部署的页面将在 https://foo.github.io/bar 上可用。在这种情况下,你应该将base设置为 “/bar/” 。
在你的项目中,运行:
代码语言:javascript
复制
# 构建 vuepress build docs
导航到构建输出目录
cd docs/.vuepress/dist
git init
git add -A
git commit -m 'deploy'
推到你仓库的的 gh-page 分支
将 / 替换为你的信息
git push -f git@github.com:/.git master:gh-pages
你可以在 CI 设置中运行此脚本以启用每次推送时的自动部署
码云页面-Gitee Pages
config.js的设置和GitHub页面设置的方法是一致的
项目打包完成后将 docs-.vuepress-dist 中的所有文件上传到码云
开启码云的Gitee Pages服务
注:我上线后出现了首页自动跳转404的问题,是因为码云 Gitee Pages 服务的网站地址均为小写,将config.js中的 base 部分全部改成小写就能解决vuepress跳转404的问题