Jekyll 教程——博客功能（blog）

Posted 2022-12-01 feelang

相信很多程序员选择 Jekyll 是为了搭建个人博客，虽然它远不止于此。本篇我们就来介绍 Jekyll 的博客功能。

博客文件约定

当一个全新的 Jekyll 项目创建完成时，默认会生成一个 _posts 文件夹和一篇简单的示例博客。

其中博文对应的文件遵守如下约定：

• 文件名格式为 [year]-[month]-[day]-[post-name].md
• 文件内容一般为 Markdown，不过 html 也可以
• 文件必须包含 Front Matter（可以不用定义任何变量）

示例如下：
_posts/2021-09-26-my-post.md

---
title: A blog post
---

访问博客文章

Jekyll 在执行构建时，针对博文会做出如下处理：

• 将博文输出为 HTML
• 为每篇博文创建一个 post 对象，属性包括日期、标题以及 url
• 生成一个全局对象 site.posts，可访问所有博文

既然所有的博文都会归类于 site.posts，当我们需要一个页面来展示所有博文时，就可以写成如下形式：

blog.html

---
layout: default
title: Blog Page
---
<ul>
% for post in site.posts %
  <li><a href=" post.url "> post.title </a></li>
% endfor %
</ul>

博文对应的文件也支持指定布局，比如我们可以在 _layouts 目录下创建一个 post.html 的布局文件：

minima/_layouts/post.html

---
layout: default
---
<article class="post h-entry" itemscope itemtype="http://schema.org/BlogPosting">

  <header class="post-header">
    <h1 class="post-title p-name" itemprop="name headline"> page.title | escape </h1>
    <p class="post-meta">
      %- assign date_format = site.minima.date_format | default: "%b %-d, %Y" -%
      <time class="dt-published" datetime=" page.date | date_to_xmlschema " itemprop="datePublished">
         page.date | date: date_format 
      </time>
      %- if page.modified_date -%
        ~ 
        %- assign mdate = page.modified_date | date_to_xmlschema -%
        <time class="dt-modified" datetime=" mdate " itemprop="dateModified">
           mdate | date: date_format 
        </time>
      %- endif -%
      %- if page.author -%
        • % for author in page.author %
          <span itemprop="author" itemscope itemtype="http://schema.org/Person">
            <span class="p-author h-card" itemprop="name"> author </span></span>
            %- if forloop.last == false %, % endif -%
        % endfor %
      %- endif -%</p>
  </header>

  <div class="post-content e-content" itemprop="articleBody">
     content 
  </div>

  <a class="u-url" href=" page.url | relative_url " hidden></a>
</article>

然后创建博文时，在 Front Matter 内指定布局：

_posts/2021-09-26-my-post.md

---
title: A blog post
layout: post
---

这样，每次新建博文时就可以专注于内容，展示方式全部交由布局文件 _layouts/post.html 去处理。

除此之外，Jekyll 还支持用合集（collection）的方式来归类文章，我们下一篇见~