【问题标题】:Managing Jekyll Pages in Folders (on github-pages)管理文件夹中的 Jekyll 页面(在 github-pages 上)
【发布时间】:2020-06-02 14:06:58
【问题描述】:

我有一个托管在 GitHub Pages 上的 Jekyll 网站。现在我有这么多页面,我想在一个名为_pages 的文件夹中管理它们。理想情况下,我希望有这样的结构:

root
  |-> _pages
      |-> Index.md
      |-> contact.md
      |-> cv
          |-> cv.md
          |-> my_cv.pdf
  |-> _posts
  |-> [other things such as config and gemfile]

我已经在_config.yml 中添加了默认永久链接:

include:
  - _pages

defaults:
  - scope:
      path: "_pages"
      type: "pages"
    values:
      permalink: /:basename/ # make URL of pages in the folder _pages as on the root.

效果很好。

但是,正如您在 _pages 中看到的那样,我希望有另一个名为 cv 的子文件夹并将我的 cv.md 和 my_cv.pdf 放在同一个文件夹中(在实际网站中,我有更多这些文件页面。)。 最终我想受益于使用[Download my CV](my_cv.pdf) 相对本地链接,我想这是因为 pdf 和 .md 文件位于同一文件夹中,它会识别它。然而事实并非如此。 cv.md 具有 /cv/ 的永久链接,而不是 cv 文件夹。因此,当我使用 [Download my CV](my_cv.pdf) 时,它会创建 root/cv/my_cv.pdf,而这个 pdf 文件实际上并不存在!

我该如何解决这个问题?你有什么绝招?

【问题讨论】:

    标签: jekyll github-pages permalinks


    【解决方案1】:

    您不能将静态文件放在以下划线开头的目录中。它们在构建过程中/之后将不可用:

    Which folder should I put my static files in Jekyll?

    【讨论】:

    • 感谢您的回答。解决方案一不会发生,因为 cv.md 本身的实际路线在_pages/cv/ 中,my_cv.pdf 也在其中。因此,全局永久链接更改了 md 文件的永久链接,而不是 static_files。
    • 谢谢,你说得对。我已经更新了答案。
    • 实际上它们会出现并且可用,即使您将它们放在下划线命名的文件夹中也是如此。诀窍是在配置中包含路径。
    【解决方案2】:

    除非您计划将其推广到数十个子目录或数十个站点,否则我只会添加链接的完整路径。类似[Download my CV]({{ '/path/my_cv.pdf' | relative_url }}) 或[Download my CV]({{ '/path/my_cv.pdf' | absolute_url }})。

    如果做不到这一点,您可以在 cv.md frontmatter 中添加 permalink: /path/where/pdf/lives/。这样他们都将在同一个目录中。当然,这意味着您的 cv.md 不会在 example.com/cv/ 上构建。

    【讨论】:

      猜你喜欢
      • 1970-01-01
      • 2021-07-27
      • 1970-01-01
      • 2017-09-14
      • 1970-01-01
      • 1970-01-01
      • 1970-01-01
      • 2018-04-01
      • 2017-06-17
      相关资源
      最近更新 更多