我的项目有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/但我仍然无法弄清楚我还能做些什么,而且 - 更重要的是 - 如何简单地放置一个与当前“模板化”的降价文件模板?
谢谢!
答案 0 :(得分: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 ---
然后会在您网站的default.html
文件夹中使用名为_layouts
的模板生成此页面。