Oink 博客
| 把博客列表变成画廊 | Oink | |
| 在 Blog 布局中实现沉浸式阅读 | Oink | |
| OINK 实现预览正式亮相 | Oink | |
| OINK 实施日记:从复制外壳到统一主题 | Oink |
把博客列表变成画廊
用文章封面浏览博客,支持等高拼接、无缝和瀑布流,并为触屏与键盘保留完整的文字入口。
在 Blog 布局中实现沉浸式阅读
四个 front matter 键即可把普通 Blog 页面切换为阅读优先的版式: 以全幅 Hero 开场,再用随文大纲栏承接正文。
OINK 实现预览正式亮相
OINK 将直接定制的 Docsy 代码库演化为本地优先、仅依赖 Hugo 的文档主题,并提供多语言基础设施与可复用内容组件。
OINK 实施日记:从复制外壳到统一主题
记录 OINK 实现预览背后的技术决策、迁移方法、安全边界、测试与文档工作。
-
把博客列表变成画廊
有时候,认出一篇文章最快的办法是看封面。旅行手记、速写集、项目记录,都可能 比普通技术文章更适合先看图、再读标题。 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 是消费端唯一构建依赖; 所有主题自带浏览器资源 …