输入关键词,开始搜索

↑↓ 选择↵ 打开esc 关闭
沉浸

开始04-组织内容,换个样子

3 min read

让读者找得到

文章多起来之后,Vergil 给你四种组织方式,各管一件事:

方式 一篇能有几个 回答的问题
分类 一组,可以多级 这篇属于哪个领域
标签 多个 这篇提到了什么
专栏 一个 这篇在哪个系列里、排第几
归档 自动 这篇是什么时候写的

分类要少。 五到八个就够,多了等于没分。

标签可以多。 文章右侧栏的「相关文章」就是按共同标签找出来的,这个专栏的四篇都打了「上手指南」,所以它们互相出现在对方的相关文章里。

专栏讲顺序。 你正在读的就是一个专栏,文章底部有上一篇和下一篇。专栏的文章可以收进一个目录,这个专栏就是这样放的:

src/content/series/搭建你的第一个站点.md    ← 专栏定义,写了 dir: 搭建你的第一个站点src/content/blog/搭建你的第一个站点/├── 01-run-in-ten-minutes.md├── 02-first-post.md├── 03-directives-in-writing.md└── 04-organize-and-style.md

目录里的文章自动属于这个专栏,不用逐篇写 series,目录名也不会出现在文章地址里。

一个实用建议:先只用分类,等文章攒到二三十篇、能看出主题聚集的时候,再回头补标签。

分类 标签 专栏 归档

换个样子

配色

内置好几套配色,每套都单独调过暗色模式。访客点右上角的主题图标就能切换,选择会记在浏览器里。你现在就可以试试,这篇文章会跟着变。

皮肤

皮肤管的是形状和质感:圆角多大、按钮什么样、卡片靠投影还是描边,每个皮肤还带着自己的几套配色,切皮肤时配色会换成新皮肤的默认配色。主题自带经典皮肤,更多皮肤用 vg skin add <名字> 从 vergil-skins 安装。访客可以在右上角的面板里自己切换皮肤,你在配置里定的是默认用哪一个:

src/data/config/identity.ts
export const siteInfo = {    // ...    skin: 'island',     // 默认是 'classic','island' 是大圆角的海岛风    skins: ['island'],  // vg skin add island 会自动写上};

视图

同一篇文章可以用不同方式读。极简模式 隐藏两侧的栏,只留正文,文章上方工具栏的「沉浸」按钮就能进入;简历页 是一个独立的个人介绍视图。

侧栏

首页右侧的欢迎卡片、热力图、精选文章、标签云都是可插拔的组件,按你想要的顺序排在数组里:

src/data/config/features.ts
export const sidebar = {    left: ['recentPosts', 'siteInfo'],    right: ['welcome', 'heatmap', 'featured', 'tags', 'notice'],};

文章的文件头里写 isFeatured: true,它就会出现在首页和文章页右侧栏的「精选文章」里。

这个专栏到这里就结束了。之后遇到具体问题,查文档就好:

内容组织 配色方案 界面皮肤 视图系统 边栏配置

© 本文著作权归作者所有,转载请注明出处。

未知标题
00:00
00:00
播放列表