Jekyll 教程——合集（collections）

上一篇我们介绍了 Jekyll 的博客功能，本质上博客是一个文章的集合，集合内的文件遵循某种约定。

本篇要介绍的合集（collection）也具备这个功能，两者的不同之处在于：

posts 是相对独立的内容，有发布日期
collection 是一类文章的合集，可以有自己的页面，但是发布日期不重要

既然合集是对内容进行分组，那它的内容一定有共同之处，比如可以是一群人，也可以是某类食谱。

合集内的内容可以展示在一个页面，也可以分开展示，而博文往往只能独立展示。

我们以本篇所属的博客专栏「Jekyll 基础教程」为例要讲解一下合集的具体用法。

首先在项目根目录下创建一个 html 文件：

tutorial-jekyll.html

---
layout: page
title: Jekyll 教程
permalink: /tutorial/jekyll
---{% for lesson in site.jekyll%}<h2><a href="{{lesson.url}}">{{ lesson.title }}</a></h2>
{% endfor %}

这个文件中用到了 site.jekyll 这个变量，它就是我们的合集名称，定义在 _config.yml 文件中：

# Collections
collections:jekyll:output: truesort_by: lesson

其中

output: true 表示这个合集下每个文件都会被渲染成独立的 html 文件
sort_by: lesson 表示合集内容会根据 lesson 字段来排序

lesson 定义在每个合集文件的 Front Matter 中，比如：

_jekyll/liquid.md

---
layout: post
title: Jekyll 中文教程之「模板语言 Liquid」
lesson: ch03
---
Liquid 出自 Shopify 团队，和 Jekyll 一样，都是 Ruby 写成的。
（略）

所有的合集文件会放在一个以下划线开头的文件夹下。

我们在 _config.yml 中定义的合集名称叫 jekyll，那对应的文件就是 _jekyll，文件结构如下所示：

├── _jekyll
│   ├── getting-started.md
│   ├── installing.md
│   └── liquid.md

合集就是这么简单，具体可以参考我用 Jekyll 搭建的个人博客 feelang.github.io。

下一篇将介绍 Jekyll 的数据文件，相当于一个小型的数据库，敬请期待。

Jekyll 教程——合集（collections）相关推荐

PaddleHub教程合集
原文链接:https://aistudio.baidu.com/aistudio/projectdetail/2168053 PaddleHub教程合集 PaddleHub是基于PaddlePaddl ...
Fiddler 和 Wireshark抓包教程合集
本教程包括: 一:Wireshark专区 [1Wireshark网络分析实践] [2Wireshark视频教程(基础设置)] [3Wireshark协议分析从入门到精通] [4网络数据包分析协议分析 ...
Revit教程合集110部
Revit教程合集110部教程说明:英文视频教程,部分有中文字幕,大部分有工程文件教程格式:Flv.MP4格式,大部分高清,确保能看清软件上的文字发货方式:百度网盘下载链接(教程较多,可转存到自 ...
ncl如何添加线shp文件_教程合集 | 地图数据找不到？家园都有解决方案！
原标题:教程合集 | 地图数据找不到?家园都有解决方案! 本栏目为气象家园各类优质教程的合集,每期一个主题. 各位小伙伴在画图的时候是否曾经因为地图问题而头秃呢?第一期将从地图数据部分开始,打好小旗子 ...
百度百科创建词条教程合集分享，赶紧收藏起来
每一个企业.品牌.人物.产品想要提升自己的知名度,都要创建一个属于自己的百度百科词条,互联网时代,百度搜索引擎的地位是不可撼动的,每天都有上亿的用户在百度上搜索相关内容,百度百科词条在网络营销中占据着 ...
java开发工具IntelliJ IDEA全面教程合集
IntelliJ IDEA在业界被公认为优秀的Java开发平台之一,在智能代码助手.代码自动提示.重构.J2EE支持.Ant.JUnit.CVS整合.代码审查. 创新的GUI设计等方面表现突出,并支持 ...
《JavaCV从入门到实战教程合集》介绍和目录
前言 <JavaCV从入门到实战教程合集>是2016年<JavaCV开发实战教程>和2018年<JavaCV入门教程>2022年<JavaCV音视频实战宝典& ...
Vue3全套教程合集
Vue3全套教程合集点击跳转具体教程,以下所有教程基于脚手架书写,运行代码需要在脚手架环境. 一.Vue3学习-初识Vue3.创建Vue3.0工程二.Vue3学习-分析工程结构.初识setup 三 ...
Vue2基础篇教程合集
Vue2基础篇教程合集点击跳转具体教程,该教程基于HTML书写,深度理解Vue如何运行. 一.Vue2基础篇-初识Vue 二.Vue2基础篇-模板语法三.Vue2基础篇-理解MVVM模型三.Vu ...

Jekyll 教程——合集（collections）

Jekyll 教程——合集（collections）相关推荐

最新文章

热门文章