如果你使用过 Stellar 的 wiki 系统,那么专栏就非常容易了,相当于一个简化版的 wiki 系统,区别是:

  • 无需「上架」动作
  • 文章创建于 blog/source/_posts 文件夹内
  • 按照时间排序,默认最新的排最上面
  • 页面布局类似于普通文章

基本流程

1. 创建一个专栏

blog/source/_data/ 文件夹中创建一个 topic 文件夹,在其中放入各个专栏的描述文件,文件名就是项目的 id

blog/source/_data/topic/id.yml
1
2
3
4
5
6
name: Stellar # 在面包屑导航上会显示较短的名字
title: Stellar - 每个人的独立博客 # 在列表页会显示完整的专栏标题
description: 关于搭建独立博客相关的知识和经验分享,以及 Stellar 的高级用法、版本更新相关的注意事项。
icon: https://res.xaox.cc/... # 专栏图标
cover: https://res.xaox.cc/... # 列表页最新文章卡片的背景图,固定 2:1 宽高比
order_by: -date # 默认是按发布日期倒序排序

专栏索引页(/topic/)以纯平铺布局展示全部专栏,并按照每个专栏最新文章的发布时间倒序排列(无文章的专栏排在末尾)。每个条目无卡片背景,条目间以分隔线衔接,专栏之间留出较大间隔;内部上下排列——顶部为专栏标题(居中、两侧 accent 斜杠装饰,复用文学文章的标题样式)与其下方的一句话描述,中间为最新文章卡片(背景为 cover 封面图,固定 2:1 宽高比,底部渐变模糊文字区显示最新文章标题与发布日期,标题大字随封面明暗黑白对比、日期小字取封面平均色变体,点击整卡进入最新文章),底部为按发布日期倒序排列的其他文章。其他文章复用归档列表的日期与标题样式,默认显示 3 篇;超过 3 篇时可通过列表下方的按钮展开全部剩余文章,并可再次收起。

2. 发布文章

在此专栏文章的 md 文件的 front-matter 部分指定所属的专栏 id (即上一步创建的文件名 id.yml

blog/source/_posts/20240114.md
1
2
3
4
5
6
---
title: 这是文章标题
topic: id # 这是专栏id,对应 blog/source/_data/topic/id.yml
---

文章正文

这个功能的定位是什么?

相比分类功能,它更偏向于一个更加有前后关系的文章集合,类似于文档的分页,但是相比文档,它又像文章一样持续增加新页面,一般以时间为排序依据。比分类更加结构化,比文档更加自动化,可以根据自己的需求选择使用不同的功能。