在现有 html 上应用 GitHub 页面主题

Apply GitHub pages theme on existing html

我有一个现有的 GitHub 项目,该项目已经有几个 html 页。现在,我使用 master 分支中的 docs 文件夹创建了项目的 GitHub 页站点,但是当我尝试应用现有的jekyll 主题到页面,主题没有应用。文档文件夹包含一个名为 index.html 的文件。

我是否需要向我的 html 页面添加某种导入语句,或者我真的需要将它们转换为降价语法吗?也许我在这里做错了什么?

The GitHub project is found here

The GitHub pages site for my project is here

从普通 HTML 网站到 Jekyll 网站

如果您想要一个普通的 html 网站使用布局,您的 html 页面开始于:

---
layout: page
---

您可以自由地将文件从 .html 重命名为 .md,因为 .md 页面包含 HTML 是可以的。接下来,您只需在 _layouts 目录中创建 page.html 布局文件。


使用 Github 页面主题

如果您想使用 Github 主题,您可以 download 主题并将文件放在根目录中。您可以通过将此单行添加到 _config.yml:

来实现相同的目的
theme: jekyll-theme-hacker

这里的主题名称是'jekyll-theme-hacker'。或者,如果您想在计算机上预览您的网站,请将以下内容添加到您网站的 Gemfile:

gem "github-pages", group: :jekyll_plugins

来源:https://github.com/pages-themes/hacker#usage

如果您的 _layouts 目录包含与新主题布局文件同名的文件,它们将优先于主题文件。

这就是 Jekyll 使自定义主题成为可能的方式。

在这种情况下,删除 _layouts 目录,Github 页面将使用所需的主题。