错误报告
重现步骤嗨,我在将 Vue Press 文档部署为我的私有 Github 存储库的一部分时遇到了问题。我无法提供演示 URL,因为它可能与 Vue Press 或 Github 链接,也可能不链接。
我使用vue create
命令生成了一个 Vue JS 项目,我在顶部添加了 Vue p11n 模块,因为这是我正在制作的插件。
我已经在该docs/
文件夹下创建了我的 Vue Press 文档,并且在本地一切正常。我没有触及配置文件,因为这里的一切都在工作。
我有几个文件:
- 自述文件.md
- 安装.md
- 需求.md
- 选项.md
这些位于 下docs/
,然后.vuepress
是 docs 目录中的文件夹。
文档网址:https ://stsonline.github.io/vue-les-application/
我的 github 仓库是私有的,而且必须是私有的。
期望什么?Github 页面上的文档应该按照本地副本加载,侧边栏应该可以正常工作,并且导航链接应该可以工作。
实际发生了什么?当我将更改推送到 repo 时,我的 github 页面 url 似乎只加载 README.md 文件,而其他所有内容都不起作用,例如:无法访问这些页面。
我的回购网址示例是:https://stsonline.github.io/vue-les-application/
单击“开始”链接时,它应该链接到安装页面,但侧边栏导航也不会丢失。
但是,在本地运行,一切都很好,包括可爱的绿色主题。
我错过了什么?
我必须保留一个父docs/
文件夹,因为这是用于 Github 页面的文件夹,我不能使用父dist/
目录。话虽如此,Vue Press 似乎是在 docs 目录中构建的。
我的docs/.vuepress/config.js
文件:
module.exports = {
base: '/vue-les-application/',
plugins: [
require('./plugin.js')
],
locales: {
'/': {
lang: 'en-US',
title: 'VueLesApplication',
description: 'VueLesApplication for Vue.js'
}
},
themeConfig: {
repo: '/vue-les-application',
docsDir: 'docs',
locales: {
'/': {
label: 'English',
selectText: 'Languages',
editLinkText: 'Edit this page on GitHub',
nav: [{
text: 'Release Notes',
link: 'https://github.com//vue-les-application/releases'
}],
sidebar: [
'/requirements.md',
'/installation.md',
'/options.md'
]
}
}
}
}
我docs/.vuepress/plugin.j
的文件:
const { version } = require('../../package.json')
module.exports = (/*options, ctx*/) => ({
async enhanceAppFiles () {
const code = `export default ({ Vue }) => {
Vue.mixin({
computed: {
$version () {
return '${version}'
}
}
})
}`
return [{
name: 'vuepress-plugin-vue-cli-plugin-p11n',
content: code
}]
}
})
其他相关信息
[x] 我的 VuePress 版本低于且相同
1.0.0-alpha.47
:- VuePress 版本:1.0.0-alpha.48
- 操作系统:Mac 操作系统
- Node.js 版本:不适用
- 浏览器版本:Chrome 最新版本
- 这是全局安装还是本地安装?不适用
- 您使用哪个包管理器进行安装?新PM
- 禁用所有插件时是否会出现此问题?是的
[ ] 我的 VuePress 版本高于
1.0.0-alpha.47
,以下是npx vuepress info
我的 VuePress 项目中的输出: