我很确定我在Jekyll博客项目中看到了多个源文档目录,例如_posts
和_pages
,但是source
参数在_config.yml
文件只能将1个目录作为其参数,并且数组和空格分隔的目录字符串都不起作用。
我是否误解了source
参数的含义?我希望手表可以使用它来指定哪些文件'更改将触发构建,以及要构建的文件。
另外,我有about.md
这样的片段,可以包含在其他页面中。像这样的文件的最佳位置是什么?
答案 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覆盖了您所有的代码文档。