介绍

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/” 。

在你的项目中,运行:

# 构建
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的问题

Logo

前往低代码交流专区

更多推荐