关于GitHub的Jekyll页面:它是如何工作的?

时间:2013-09-19 05:20:21

标签: github jekyll github-pages

我的项目有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 个答案:

答案 0 :(得分:1)

这里有几个问题:

  1. 您需要在本地安装Jekyll。这并不难,它让生活变得更轻松。按照http://jekyllrb.com

  2. 上的说明操作
  3. 您的.markdown文件需要进入您网站的_posts目录,以便Jekyll将其转换为帖子。任何以YAML前端开头的文件(虚线之间文件顶部的内容)也会被处理。

  4. 要使用布局,您需要在页面的YAML前端内容中进行设置。因此,如果您将上面的示例更改为:

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

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