我怎样才能观看"杰基尔的多个源目录?

时间:2018-04-03 04:45:19

标签: jekyll jekyll-extensions

我很确定我在Jekyll博客项目中看到了多个源文档目录,例如_posts_pages,但是source参数在_config.yml文件只能将1个目录作为其参数,并且数组和空格分隔的目录字符串都不起作用。

我是否误解了source参数的含义?我希望手表可以使用它来指定哪些文件'更改将触发构建,以及要构建的文件。

另外,我有about.md这样的片段,可以包含在其他页面中。像这样的文件的最佳位置是什么?

2 个答案:

答案 0 :(得分:1)

source配置是指您的<project_root>,而不是项目根目录中的单个目录。默认情况下,它设置为您的current_directory(您正在运行的位置jekyll build (or) serve

默认情况下,Jekyll会监视源目录中的所有嵌套文件和目录。

about.md并不意味着被视为要包含在其他文件中的片段。它是一个完整的页面&#34;这将根据您的永久链接设置呈现为_site/about.html_site/about/index.html

要包含在其他页面中的片段位于_includes目录中,并通过Liquid构造{% include <fragment-filename>.html %}

插入

除了_layouts_includes_sass之外,Jekyll会忽略以下划线开头的目录,除非您配置 Jekyll将其视为&# 34;集合&#34 ;. _posts是一个预定义且硬编码的集合目录。

有关Jekyll的更多信息,请参阅https://jekyllrb.com

上的官方文档

答案 1 :(得分:0)

如果像我这样的人希望在 github-pages 中包含多个源文件夹,则只需在master分支的github-page中配置jekyll根即可。即不在gh-page分支上,也不在docs文件夹上。

因此,所有文件夹都已处理。 README.md被视为index.md,您可以轻松地从根主README.md到文件层次结构中“其下”的任何其他文档建立相对链接。因此,让jekyll覆盖了您所有的代码文档。