组件合集

陈列里的每一个组件都从 astro-inkstone/components/ 按路径导入,用包的默认 token 渲染。组件是纯展示的:数据与标签文案都走 props(默认英文),任何语言的站点传自己的即可。

3 章 · 24 个组件 · 全部从 astro-inkstone/components/ 按路径导入

三个章节

每张卡对应侧栏章节轨上的一章;卡上的 chip 报的是这一章都演些什么。

第 I 部

行文由这些零件搭成——callout、chip、栅格、步骤轨、统计行、论文卡与文献列表。

CalloutPaperCardGridStepsStats

7 个组件→

第 II 部

这座园地的书架就是用这套分类组件搭的,外加两块链接图面板——反向链接与侧栏的局部关系图。

NoteCardFacetNavTaxonomyLineBacklinksLocalGraph

8 个组件→

第 III 部

一个真实运行的 canvas 演示与站点持有的加载器契约,再加页面配件——hero、hub 卡、页内跳转列表、页脚。

DemoMountHeroHubCardLocalTocPageFooter

9 个组件→

这篇笔记本身就是 hub 的现场演示:一篇顶层笔记,frontmatter 里声明了 nav——一份有序的章节清单。此刻在你眼前运转的机制有这些:

侧栏在 hub 字标下方挂出章节轨(I/II/III),每章末尾带上一章/下一章翻页;
章节继承 hub 的分类:三章没有一章自己声明 kind、domain 或 status,页头的元信息却一章不缺——继承的都是本篇的;哪一章自己声明了,该字段就整个以它为准(和别处同一条规则:写了就算自己的);
在导览页上,hub 是一个整体:一张卡、标着章数——章节不会散落到书架上;
每章的 part: 编号必须与它在 nav 里的位置一致,否则构建直接失败——章节轨和 frontmatter 不可能各说各话;
上面的卡片是排在 .hub-grid 里的 HubCard;下面这个框是阅读路径(.path),hub 的另一件配件。

从哪读起

初次接触这个包 → 第 I 部→第 II 部;要搭导览站 → 直接进第 II 部→快速上手;同一套东西的 markdown 侧 → 全要素演示。