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

Posted

技术标签:

【中文标题】将 .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:

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

【讨论】:

以上是关于将 .vuepress 文件夹存储在另一个目录中的主要内容,如果未能解决你的问题,请参考以下文章

如何将 jQuery 添加到 VuePress 文件中

在另一个 git 存储库中维护一个 Git 存储库

将提交的文件拆分并推送到两个不同的分支

vuepress更改根目录地址及nginx转发笔记

vuepress更改根目录地址及nginx转发笔记

vuepress更改根目录地址及nginx转发笔记