如何让 GitHub 的 Jekyll 与 index.html 一起工作？

Question

我正在尝试创建一个 GitHub 页面。一开始，我使用 GitHub 生成器。我包括 Gemfile 和 _config.yml 来生成 SEO 标签，它按预期工作。生成的站点将包括以下部分。

<!-- Begin Jekyll SEO tag v2.6.1 -->
  <meta ...
<!-- End Jekyll SEO tag -->

现在，我刚刚使用 HTML5 UP 中的 HTML 模板将我的网站更新为新网站。它正常运行，但是，我找不到让 Jekyll 为我的 index.html 文件生成 SEO 标签的方法。我试图在第一行的 index.html 中添加三重破折号（前面的内容）。

---
---
<!DOCTYPE HTML>
<!-- Other code below -->

问题是，它部分破坏了站点（页面未正确呈现）。因此，我必须 copy/paste 生成的标签并将它们手动添加到我的代码中。有没有办法让 Jekyll 为我的网站正确创建 SEO 标签？还是我误解了一些非常基本的东西？

明确地说，我在网络开发方面的知识非常有限，这就是我首先使用模板的原因。这是我的页面，以防它有助于澄清问题 https://hunghvu.github.io/ and here is its GitHub repository 如果您想了解文件结构。

更新

(09/30)
- 我试图将 index.html 文件转换为 index.md，同时仍保留所有代码（加上三重破折号）。从某种意义上说，它有效。该页面已生成，但仍然无法像我使用 html 格式时那样正确呈现。我知道使用 Jekyll 实际构建网站的方式有很大不同，但这并没有回答我的问题。
- 如果有必要说明我所说的“未正确呈现”的意思，我稍后会更新这个问题。
(09/31)
- 下图是我添加 front matter 和 {% seo %} 后页面的样子。请注意，当我第一次转到该页面时，边栏已经在 SOME OTHER WORK 或最后一节中。它应该在 WELCOME 上。 WELCOME 部分未呈现，边栏功能已损坏。

Answer 1

问题

GitHub 页 gem 未包含在您的项目中，因此 GitHub 不是运行 Jekyll 构建。此外，您在前面的内容中没有指定任何内容。你也没有布局。

在您的 Gemfile 中包含 gem "github-pages", "~> VERSION", group: :jekyll_plugins。

考虑使用 front matter 并创建布局文件 _layouts/default.html 并将除正文（包括 SEO）之外的所有内容移至布局文件。 index.html 应该通过在前面指定布局属性来扩展布局。