创建页面
作为写文章的补充,Jekyll 还可以创建静态页面。利用 Jekyll 带来的便利,你只需要复制文件或文件夹,就是这么简单。
主页
像任何网站的配置一样,需要按约定在站点的根目录下找到 index.html
文件,这个文件将被做为主页显示出来。除非你的站点设置了其它的文件作为默认文件,这个文件就将是你的 Jekyll 生成站点的主页。
提示: 在主页上使用布局
站点上任何 HTML 文件,包括主页,都可以使用 layout 和 include 中的内容作为公用的内容,如页面的 header 和 footer. 将合适的部分抽出放到布局中。
其它的页面的位置
将 HTML 文件或者 Markdown 放在哪里取决于你想让它们如何工作。有两种方式可以创建页面:
- 将为页面准备的命名好的 HTML 文件或者 Markdown 文件放在站点的根目录下。
- 在站点的根目录下为每一个页面创建一个文件夹,并把 index.html 文件或者 index.md 放在每个文件夹里。
这两种方法都可以工作(并且可以混合使用),它们唯一的区别就是访问的 URL 样式不同。
命名 HTML 文件
增加一个新页面的最简单方法就是把给 HTML 文件起一个适当的名字并放在根目录下。一般来说,一个站点下通常会有:主页 (homepage), 关于 (about), 和一个联系 (contact) 页。根目录下的文件结构和对应生成的 URL 会是下面的样子:
.
|-- _config.yml
|-- _includes/
|-- _layouts/
|-- _posts/
|-- _site/
|-- about.html # => http://example.com/about.html
|-- index.html # => http://example.com/
|-- other.md # => http://example.com/other.html
└── contact.html # => http://example.com/contact.html
命名一个文件夹并包含一个 index.html 文件
上面的方法可以很好的工作,但是有些人不喜欢在 URL 中显示文件的扩展名。用 Jekyll 达到这种效果,你只需要为每个顶级页面创建一个文件夹,并包含一个 index.html
文件。这样,每个 URL 就将以文件夹的名字作为结尾,网站服务器会将对应的 index.html
展示给用户。下面是一个示例来展示这种结构的样子:
.
├── _config.yml
├── _includes/
├── _layouts/
├── _posts/
├── _site/
├── about/
| └── index.html # => http://example.com/about/
├── contact/
| └── index.html # => http://example.com/contact/
|── other/
| └── index.md # => http://example.com/other/
└── index.html # => http://example.com/
这种方式可能不适合每个人,对那些喜欢干净 URL 的人这是一种简单有效的方法。最终选择哪种方法完全由你来决定!
提示:使用头信息变量 permalink
干净的 URLs 也可以通过在头信息中定义 permalink
实现。就上边的第一个例子而言,在 other.md 文件的头信息中定义:permalink: /other
,你就能得到 URL http://example.com/other