在 Github 页面中使用 index.html 时,Jekyll 不呈现主题布局

Jekyll does not render theme layout when using index.html in Github Pages

我正在尝试学习如何使用 Github 页面,所以我创建了第一个页面并向其中添加了 Jekyll cayman 主题。

在添加主题之前,我可以使用 index.html 文件来呈现我的主页。但是,现在我添加了 cayman 主题,index.html 文件不再读取,只读取 index.md 文件。

结果 github 页面:
https://scinana.github.io/hellopages/

代码:
https://github.com/scinana/hellopages

为什么我必须添加 index.md 文件?

如果我想继续直接使用 html 文件而不是 md 文件怎么办?我可以在使用 Jekyll 主题时使用 html 个文件吗?

您可以使用 html 文件。只需添加一个 front matter 并插入默认布局即可。

这是一个例子:

---
layout: default
---
  
<!doctype html>
<html>
  <head>
    <title>This is the title of the webpage!</title>
  </head>
  <body>
    <p>This is an example paragraph. Anything in the <strong>body</strong> tag will appear on the page, just like this <strong>p</strong> tag and its contents.</p>
  </body>
</html>

来自https://jekyllrb.com/docs/step-by-step/04-layouts/

Layouts are templates that can be used by any page in your site and wrap around page content. They are stored in a directory called _layouts.

来自https://jekyllrb.com/docs/structure/

index.html or index.md and other HTML, Markdown files
Provided that the file has a front matter section, it will be transformed by Jekyll. The same will happen for any .html, .markdown, .md, or .textile file in your site’s root directory or directories not listed above.