Jekyll项目中的Collections功能详解：构建作者管理系统-优快云博客

本文链接：https://blog.youkuaiyun.com/gitblog_00801/article/details/148324857

Jekyll项目中的Collections功能详解：构建作者管理系统

jekyll 项目地址: https://gitcode.com/gh_mirrors/jek/jekyll

什么是Collections

在Jekyll静态网站生成器中，Collections（集合）是一种强大的内容组织方式，它允许开发者创建不依赖于时间序列的内容集合。与博客文章不同，集合中的内容不需要按照日期进行分组，这为构建各种类型的内容管理系统提供了极大的灵活性。

为什么需要Collections

在构建内容型网站时，我们经常需要管理多种类型的内容实体，比如：

产品目录
团队成员介绍
项目案例
客户评价

这些内容通常不需要按照时间顺序排列，而是需要按照其他逻辑进行组织和展示。Collections正是为解决这类需求而设计的。

配置Collections

要使用Collections功能，首先需要在项目的_config.yml文件中进行配置：

collections:
  authors:

这个配置告诉Jekyll我们要创建一个名为"authors"的集合。配置完成后，需要重启Jekyll服务使更改生效。

创建集合内容

集合中的每个项目称为"文档"(document)，它们存储在项目根目录下以集合名命名的文件夹中（前缀为下划线）。例如，对于"authors"集合，我们需要创建_authors文件夹。

每个作者可以创建一个Markdown文件，例如：

_authors/jill.md:

---
short_name: jill
name: Jill Smith
position: 主编
---
Jill是法国南部的资深水果种植专家。

文件中的YAML前置数据(Front Matter)可以定义任意字段，这些字段可以在模板中访问。

展示集合内容

我们可以创建一个页面来展示所有作者信息。Jekyll通过site.authors变量提供对集合的访问：

<h1>团队成员</h1>

<ul>
  {% for author in site.authors %}
    <li>
      <h2>{{ author.name }}</h2>
      <h3>{{ author.position }}</h3>
      <p>{{ author.content | markdownify }}</p>
    </li>
  {% endfor %}
</ul>

注意使用markdownify过滤器将Markdown内容转换为HTML。

为集合项生成独立页面

默认情况下，集合中的文档不会生成独立页面。要启用此功能，需要在配置中添加output: true：

collections:
  authors:
    output: true

然后可以为每个作者创建单独的布局模板_layouts/author.html：

<h1>{{ page.name }}</h1>
<h2>{{ page.position }}</h2>

{{ content }}

高级功能：前置数据默认值

为了避免在每个文件中重复指定布局，可以使用前置数据默认值功能：

defaults:
  - scope:
      path: ""
      type: "authors"
    values:
      layout: "author"

这样所有作者文档都会自动使用"author"布局，无需在每个文件中单独指定。

关联内容展示

一个强大的功能是可以在作者页面展示其发表的所有文章：

<h2>发表的文章</h2>
<ul>
  {% assign filtered_posts = site.posts | where: 'author', page.short_name %}
  {% for post in filtered_posts %}
    <li><a href="{{ post.url }}">{{ post.title }}</a></li>
  {% endfor %}
</ul>

同样，在文章页面也可以添加作者链接：

{% assign author = site.authors | where: 'short_name', page.author | first %}
{% if author %}
  - <a href="{{ author.url }}">{{ author.name }}</a>
{% endif %}