【问题标题】:Store .vuepress folder in another directory将 .vuepress 文件夹存储在另一个目录中
【发布时间】:2018-12-21 22:17:14
【问题描述】:

有没有办法配置 vuepress 以在默认 /docs 以外的其他位置查找文件夹 .vuepress

【问题讨论】:

  • 2019 年您好——令人讨厌的是,新的 VuePress 文档站点无法导航到该页面,但它们解释了推荐的目录结构 here

标签: vue.js vuepress


【解决方案1】:

更新: VuePress 1.5.0 现在只能从 docs/.vuepress 读取,因此下面的解决方法不再有效。但是,另一种可能(不太优雅)的解决方法是将docs/.vuepress 符号链接到所需位置(在 macOS Catalina 上测试)。

例如,您可以在 macOS 上将其符号链接到 <projectRoot>/.vuepress

mkdir .vuepress docs
cd docs
ln -s ../.vuepress

从 VuePress 0.12.0 开始,没有具体的配置来设置 .vuepress/ 的位置。 VuePress 总是在目标目录(docs/)和直接父目录中寻找.vuepress/。如果没有找到,VuePress 在docs/ 的父目录中创建.vuepress/

如果您的目标是阻止 docs/.vuepress/ 的创建,并且您不介意在 docs/ 的父目录中创建 .vuepress/

  1. docs/的父目录下创建.vuepress/config.js
  2. 编辑该文件以包含以下配置:

    module.exports = {
      dest: 'foo' // desired path to VuePress output
    }
    
  3. docs/的父目录下运行vuepress build

上述配置的结果是创建了一个目录foo/,其中包含 VuePress 静态站点输出:

$ vuepress build

WAIT  Extracting site metadata...
[2:20:45 AM] Compiling Client
[2:20:45 AM] Compiling Server
(node:47073) DeprecationWarning: Tapable.plugin is deprecated. Use new API on `.hooks` instead
[2:20:48 AM] Compiled Server in 3s
[2:20:50 AM] Compiled Client in 5s
WAIT  Rendering static HTML...

DONE  Success! Generated static files in foo.

【讨论】:

  • 不幸的是,父级 .vuepress 似乎不再起作用。 VuePress 1.5.0 要求配置在 docs/.vuepress/config.js 中
  • @akauppi 感谢您的更新!一个简单的解决方法是符号链接.vuepress,以便docs/.vuepress 链接到所需位置。
  • 我试过了,但后来改变了主意。我的目的是让我的存储库尽可能地对访问者开放,而符号链接通常会与之背道而驰。
【解决方案2】:

不认为有。 2018年,作者has stated

除了个人喜好,我认为这没有实际价值,所以可能没有。

【讨论】:

    猜你喜欢
    • 2015-10-17
    • 1970-01-01
    • 2013-05-21
    • 1970-01-01
    • 1970-01-01
    • 2012-03-01
    • 1970-01-01
    • 1970-01-01
    • 2016-02-10
    相关资源
    最近更新 更多