博客主题
Methanol 内置了一个专为内容驱动型站点设计的博客主题 (themes/blog)。该主题提供以下特性:
- 针对首页、分类及集合页面(如系列文章)的专用布局。
- 基于
methanol:pages虚拟模块实现的客户端动态筛选功能。 - 高性能渲染:首屏列表采用静态渲染以实现极速加载,随后通过客户端水合(Hydration)支持交互式的筛选与分页。
导航链接
主题会从项目的根页面 (pages/index.mdx) 读取 navLinks 配置。虽然主题已提供默认链接,但你可以在 Frontmatter 中进行自定义:
---
navLinks:
- label: Home
href: /
- label: About
href: /about
- label: Categories
href: /categories
- label: Collections
href: /collections
---
内部链接会自动处理,以确保其兼容基路径配置。
集合与标题
集合(Collections)是根据页面的目录结构自动推断的(例如 /series/post 将归入 series 集合)。集合的显示标签优先使用对应索引页(如 /series/index.mdx)的标题;若该页面不存在,则默认使用目录名。
隐藏文章
在 Frontmatter 中标记为 hidden: true 的页面将不会出现在任何自动生成的列表或 methanol:pages 索引中。