github - GitHub 上的 Jekyll 页面：它是如何工作的？

Question

我的项目有我的gh-pages分支，并试图为它创建一些文档。在 GitHub 上，我读到每次我将内容推送到 GitHub 服务器时，页面实际上都会被馈送到 Jekyll。

我没有在本地安装 Jekyll。现在，我只想使用 GitHub，并且基本上充当“用户”。

但是......它实际上是如何工作的？我创建了一个.markdown页面，并看到.html创建并标记了等效页面，如下所示：

---
title: This will be used as the title-tag of the page head
---

Now, let's see.

# Is this working?

但是......我如何知道如何实际使用 Jekyll？

我知道http://jekyllrb.com/docs/但我仍然不能完全弄清楚我还能做什么，而且 - 更重要的是 - 如何简单地放置一个将被“模板化”的降价文件当前模板？

谢谢！

score 1 · Accepted Answer

这里有几个问题：

你需要在本地安装 Jekyll。这并不难，它让生活更轻松。按照http://jekyllrb.com上的说明进行操作。
您的.markdown文件需要进入您网站的_posts目录，以便 Jekyll 将其转换为帖子。任何以 YAML 开头的文件（位于文件顶部的虚线之间的内容）也会被处理。
为了使用布局，您需要在页面的 YAML 前端中提及它。因此，如果您将上面的示例更改为：

---
title: This will be used as the title-tag of the page head
layout: default
---

default.html然后将使用您站点_layouts文件夹中调用的模板生成此页面。

1 回答 1