1

错误报告

重现步骤

嗨,我在将 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 项目中的输出:

4

1 回答 1

1

这是因为要使 gh-pages 工作,您必须从gh-pages分支或dist/文件夹提供它。由于您正在构建该docs文件夹,因此 GitHub 页面将永远不会提供该文件夹。您唯一的解决方案是确保 VuePress 构建到该dist文件夹​​中。

GitHub 不允许对您可以从中提供页面的文件夹名称进行任何复杂的配置。另一种方法是使用子树,您实际上将子文件夹发布到gh-pages分支:https ://gist.github.com/cobyism/4730490

于 2019-05-21T09:11:55.033 回答