Inkstone（砚）— 一个为长读、慢写、中英排版而生的极简 Hugo 主题
本帖使用社区开源推广，符合推广要求。我申明并遵循社区要求的以下内容：- 我的帖子已经打上 开源推广 标签： 是
- 我的开源项目完整开源，无未开源部分： 是（MIT，仓库公开，无任何闭源模块、付费功能、赞助渠道）
- 我的开源项目已链接认可 LINUX DO 社区： 是（仓库 README 末尾设有 LINUX DO 友链，见 README “友链” 段）
- 我帖子内的项目介绍，AI 生成、润色内容部分已截图发出： 是
- 以上选择我承诺是永久有效的，接受社区和佬友监督： 是
以下为项目介绍正文内容，AI 生成、润色内容已使用截图方式发出
各位佬友好。
分享一个自己写、自己天天在用的 Hugo 主题：Inkstone（砚）。
[软件] 58 元买断的软件，希望可以终生维护，为什么 58 元买的衣服，吃的快餐，没有同样的要求呢？
[问与答] 58 元买断的软件，希望可以终生维护，为什么 58 元买的衣服，吃的快餐，没有同样的要求呢？
起因挺无聊的——我想给自己的博客挑个主题，要求不多：中英双语、长文好看、shortcode 别太抠门。结果找了一圈：要么 i18n 是事后补丁、装上之后 zh-cn 一半 UI 还是英文；要么中文阅读时间按英文单词数算，3000 字的中文长文显示"1 min read"；要么 shortcode 只有 figure 和 youtube，写点 callout / tab / 图表都得自己缝。
折腾两个周末没找到顺手的，索性自己写一个，从 v0.1.0 慢慢迭代到 v0.1.7。
仓库和 Demo 在这：
- GitHub：GitHub - BerBai/inkstone: A minimal bilingual Hugo template for longreads. Opinionated about CJK typography, two-column whono-flavored layout, and 25 built-in shortcodes. · GitHub
- 在线 Demo：https://inkstone.125520.xyz/
- License：MIT
项目截图
仓库 images/ 目录里的官方截图，3:2 比例，按 Hugo Themes Gallery 规范做的。
它能干嘛
下面这张图是 AI 协助我整理的项目介绍要点（按特性、对比同类主题的差异分类罗列）。按社区规范，AI 生成与润色的内容部分以截图形式发出：
简单说几个我自己用着最舒服的点：
- CJK 排版是设计目标，不是适配项。阅读时间按字符数算，中英混排的标点、引号、行高都调过；
- i18n 一开始就在主题里，不是后补的。中英两套 UI 字符串都全，要加别的语言复制一份 toml 翻译就行；
- 25+ 内置 shortcode：callout / admonition / tab / gallery / video / mermaid / markmap / antv-g2 / 图表对比 / 豆瓣卡片……写长文那些花活儿基本不用再自己写；
- Tailwind v4 走 Hugo 0.128+ 自带的
css.TailwindCSS，不用单独跑 PostCSS / Vite 这一套构建链； - Pagefind 搜索 内置 ⌘K modal，按需启用；
- 深色模式 跟系统 + localStorage 持久化。
不适合追求花哨动效、瀑布流卡片、落地页式滚动叙事——不是它的设计目标，这一点想先说清楚，免得佬友 clone 下来才发现不是自己要的菜。
三分钟跑起来
前置：Hugo extended ≥ 0.128。
hugo new site mysite
cd mysite
git init
git submodule add https://github.com/BerBai/inkstone themes/inkstone
# 装 Tailwind v4 CLI
npm init -y && npm install -D tailwindcss @tailwindcss/cli
echo 'theme = "inkstone"' >> hugo.toml
hugo server
打开 http://localhost:1313/，首页就出来了。
不想装 Node 的话也行，主题支持 Tailwind standalone CLI（brew install tailwindcss 即可），README 里写了三条路径和各自踩过的坑。
适合谁
- 想写中英双语博客的人
- 主要写长文、希望排版克制干净的人
- 不想折腾 CSS 构建链的人
- 想要一个能直接覆盖 partial / shortcode 来魔改的底座
写在最后
第一次在 LINUX DO 发开源推广，规则读了几遍，希望没踩坑。
欢迎佬友们 star、提 issue、提 PR，或者直接评论区拍砖。
如果你也在折腾 Hugo / 静态博客 / 中英双语写作，希望 Inkstone 能帮上忙。
1 个帖子 - 1 位参与者