使用默认模板制作的 github 页面是否也可以从同一存储库按原样呈现自定义 html 文件？

Question

我已经使用 Jekyll 和 gh-pages 分支上的默认最小主题成功设置了 Github 页面。它作为我在 master 分支中的代码的一个很好的文档。但是我现在希望它也呈现一个 自定义 html 页面 .

这是什么意思？
html是一个完全完成的页面，不需要模板但仍然需要输出

通常我们用 markdown 编写，Github 会搞定一切。但是这个自定义 html 文件不能那样准备。它有一些交互元素、脚本等，不能用 markdown 写下来，预计 Github 会正确准备它们（或者实际上有可能破解模板来做到这一点吗？）。我真的不在乎页面的端点，它可以是任何东西。

如果可以，请告诉我怎么做。

编辑：

使用当前解-

---

---
<html>
.
.
</html>

我能够部分呈现 HTML 文件，即即使我 根本不想要主题中的任何格式，模板的格式仍然适用 .

如何让 Github 仅针对这个 html 文件忽略主题中的所有格式？

编辑2：

我还在 assets/css/style.scss 文件中尝试了以下基于 customizing your theme's css help -

---
---

@import "{{ site.theme }}";
.title{}
.body{}
.div{}

但是什么也没发生。

编辑3

我还没有尝试过 customizing your html layout，但这似乎也是一个解决方案。

我也尝试直接在 index.md 文件中使用以下内容 -

---
layout: doom
---

其中 doom 未在任何地方定义。
这似乎有效!!

Answer 1

The docs 关于在 Jekyll 中使用 front matter 有一个注释，指定了以下内容：

If you want to use Liquid tags and variables but don’t need anything in your front matter, just leave it empty! The set of triple-dashed lines with nothing in between will still get Jekyll to process your file.

所以在 html 文件的顶部，您可以只包含以下内容：

---
---

<html>
    <head>
    ....
</html>

Jekyll 将处理该文件，因为它看到了这组行。它不会应用任何内容，因为行内没有任何内容。之后，输出 url 可能会遵循该文件所在位置的文件结构。

编辑

如果您不想让 Jekyll 添加主题，您可以拥有一个完全空的布局文件，并在自定义 html 页面的首页使用该布局。

//_layouts/empty.html
{{content}}

//customPage.html
---
layout: empty
---

<html>
    <head>
    ....
</html>

使用默认模板制作的 github 页面是否也可以从同一存储库按原样呈现自定义 html 文件？

Can a github page made using default templates ALSO render a custom html file AS IS from the same repository?

html

github

jekyll

github-pages

jekyll-theme

编辑：

编辑2：

编辑3

编辑