作为写文章的补充,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 会是下面的样子:

  1. .
  2. |-- _config.yml
  3. |-- _includes/
  4. |-- _layouts/
  5. |-- _posts/
  6. |-- _site/
  7. |-- about.html # => http://example.com/about.html
  8. |-- index.html # => http://example.com/
  9. |-- other.md # => http://example.com/other.html
  10. └── contact.html # => http://example.com/contact.html

命名一个文件夹并包含一个 index.html 文件

上面的方法可以很好的工作,但是有些人不喜欢在 URL 中显示文件的扩展名。用 Jekyll 达到这种效果,你只需要为每个顶级页面创建一个文件夹,并包含一个 index.html 文件。这样,每个 URL 就将以文件夹的名字作为结尾,网站服务器会将对应的 index.html 展示给用户。下面是一个示例来展示这种结构的样子:

  1. .
  2. ├── _config.yml
  3. ├── _includes/
  4. ├── _layouts/
  5. ├── _posts/
  6. ├── _site/
  7. ├── about/
  8. | └── index.html # => http://example.com/about/
  9. ├── contact/
  10. | └── index.html # => http://example.com/contact/
  11. |── other/
  12. | └── index.md # => http://example.com/other/
  13. └── index.html # => http://example.com/

这种方式可能不适合每个人,对那些喜欢干净 URL 的人这是一种简单有效的方法。最终选择哪种方法完全由你来决定!

提示™:使用头信息变量 permalink

干净的 URLs 也可以通过在头信息中定义 permalink 实现。就上边的第一个例子而言,在 other.md 文件的头信息中定义:permalink: /other,你就能得到 URL http://example.com/other