当前位置: 首页 > 文档资料 > Jekyll 中文文档 >

创建页面

优质
小牛编辑
133浏览
2023-12-01

作为写文章的补充,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