-
把博客列表变成画廊
有时候,认出一篇文章最快的办法是看封面。旅行手记、速写集、项目记录,都可能 比普通技术文章更适合先看图、再读标题。 OINK 1.4.0 新增一种博客视图:gallery。每篇文章成为一张可点击的 封面,默认按比例拼成行;鼠标悬停或键盘聚焦时,标题和描述浮现出来,点击则 进入文章。 已随 OINK 1.4.0 发布 画廊已经属于正式主题。它沿用普通博客文章模型,只增加一种以封面浏览同一批文章的方式。 同一批文章,四种浏览方式 现有的几种视图各有用途。知道日期或标题时,表格最便于查找;想先读摘要, …
有时候,认出一篇文章最快的办法是看封面。旅行手记、速写集、项目记录,都可能 比普通技术文章更适合先看图、再读标题。 OINK 1.4.0 新增一种博客视图:gallery。每篇文章成为一张可点击的 封面,默认按比例拼成行;鼠标悬停或键盘聚焦时,标题和描述浮现出来,点击则 进入文章。 已随 OINK 1.4.0 发布 画廊已经属于正式主题。它沿用普通博客文章模型,只增加一种以封面浏览同一批文章的方式。 同一批文章,四种浏览方式 现有的几种视图各有用途。知道日期或标题时,表格最便于查找;想先读摘要, …
-
在 Blog 布局中实现沉浸式阅读
本页直接由标准 Blog 布局渲染,无需新增专门的内容类型。只需四个 front matter 键 就能切换版式;也可以在栏目 cascade 中统一配置: featured_image: hero # 题图作为全幅开场背景 toc_style: flow # 更宽的大纲栏从正文起点开始 toc_taxonomies: false # 右栏只保留大纲 sidebar_enabled: false Hero 开场 带有题图的页面可以用它作为开场。hero 会把图片铺满视口顶部, 将标题下移留出空间 …
本页直接由标准 Blog 布局渲染,无需新增专门的内容类型。只需四个 front matter 键 就能切换版式;也可以在栏目 cascade 中统一配置: featured_image: hero # 题图作为全幅开场背景 toc_style: flow # 更宽的大纲栏从正文起点开始 toc_taxonomies: false # 右栏只保留大纲 sidebar_enabled: false Hero 开场 带有题图的页面可以用它作为开场。hero 会把图片铺满视口顶部, 将标题下移留出空间 …
-
OINK 实现预览正式亮相
今天,我们发布 OINK 实现预览:它从 Docsy 直接演进而来,提供统一的产品页面骨架、仅依赖 Hugo 的站点构建、本地优先的浏览器依赖、通用多语言框架,以及一组从 PGSTY 文档站提炼出的可复用内容组件。 这次预览完成了首个正式标签与 Cloudflare Pages 生产部署之前的实现与文档里程碑。 为什么需要 OINK? 多个成熟的文档站此前各自复制了相同的 Docsy 布局、导航、搜索代码、SCSS、JavaScript 与短代码。每当修复一个共性问题,都必须在多个仓库里重复改动 …
今天,我们发布 OINK 实现预览:它从 Docsy 直接演进而来,提供统一的产品页面骨架、仅依赖 Hugo 的站点构建、本地优先的浏览器依赖、通用多语言框架,以及一组从 PGSTY 文档站提炼出的可复用内容组件。 这次预览完成了首个正式标签与 Cloudflare Pages 生产部署之前的实现与文档里程碑。 为什么需要 OINK? 多个成熟的文档站此前各自复制了相同的 Docsy 布局、导航、搜索代码、SCSS、JavaScript 与短代码。每当修复一个共性问题,都必须在多个仓库里重复改动 …
-
OINK 实施日记:从复制外壳到统一主题
OINK 源于一个现实痛点:手头的多个生产文档站本就同源,却把公共实现拆成了散落各处的复制文件。虽然前台外观看着一致,日常维护却要在多个仓库里来回同步。 这篇日记记录我们如何把散落的站点覆盖项收敛为一套统一主题,重点交代背后的技术取舍、迁移演练与测试设计。 锁定产品契约 第一项真正有价值的工作是做减法。选择实现方式之前,我们先写清产品必须是什么: 从 Docsy 直接演化而来的独立主题; 唯一标准外壳,而不是可切换皮肤; Hugo Extended 是消费端唯一构建依赖; 所有主题自带浏览器资源 …
OINK 源于一个现实痛点:手头的多个生产文档站本就同源,却把公共实现拆成了散落各处的复制文件。虽然前台外观看着一致,日常维护却要在多个仓库里来回同步。 这篇日记记录我们如何把散落的站点覆盖项收敛为一套统一主题,重点交代背后的技术取舍、迁移演练与测试设计。 锁定产品契约 第一项真正有价值的工作是做减法。选择实现方式之前,我们先写清产品必须是什么: 从 Docsy 直接演化而来的独立主题; 唯一标准外壳,而不是可切换皮肤; Hugo Extended 是消费端唯一构建依赖; 所有主题自带浏览器资源 …