GitHub 上的 Jekyll 页面：它是如何工作的？答案

【问题标题】：Jekyll pages on GitHub: how does it work?GitHub 上的 Jekyll 页面：它是如何工作的？
【发布时间】：2013-09-19 05:20:20
【问题描述】：

我的项目有我的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/，但我仍然不能完全弄清楚我还能做什么，而且——更重要的是——如何简单地放置一个将使用当前模板“模板化”的降价文件？

谢谢！

【问题讨论】：

【解决方案1】：

这里有几个问题：

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

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

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

【讨论】：