将 .vuepress 文件夹存储在另一个目录中

Posted 2023-02-22

【中文标题】将 .vuepress 文件夹存储在另一个目录中

【英文标题】：Store .vuepress folder in another directory

【发布时间】：2018-12-21 22:17:14

【问题描述】：

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

【问题讨论】：

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

【参考方案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/：

在docs/的父目录下创建.vuepress/config.js。

编辑该文件以包含以下配置：

module.exports = 
  dest: 'foo' // desired path to VuePress output

在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：

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