11ty Subspace Builder v1.0.0

# 发布一款曲速前进的 Eleventy 起步模板

v1.0.0 标志着 Subspace Builder 正式起航：这是一个功能齐备的 Eleventy 3 起步模板，有明确的设计取向，方便快速发布，也保留了灵活性。我们着重打磨了无障碍体验、清晰度，以及以 Tachyons 为基础、几分钟就能改出自己风格的设计系统。

它看起来是这样的。

# 目录

# v1.0.0 包含什么

• Eleventy 3，内置 Markdown-it、自动标题锚点和导航插件，支持丰富的内容集合。
• 开箱即用的 Tachyons 工具类，以及适配主题的文字大小体系。
• 从单栏到侧边栏导航都能适配的响应式布局，切换时不丢失上下文。
• 可复用的文章列表宏，合理截取摘要，让归档保持整洁。
• 现代化的 OG 图片生成器，直接根据 Markdown 渲染带品牌风格的卡片。

# 随手预览主题

主题切换由数据驱动：_data/themes.yaml 提供选项，布局脚本会在标签页之间同步你的选择，并保存在 localStorage 中。悬停预览和键盘焦点使用同一套机制，因此可以先看看 “Sun”、“Mint” 或 “Midnight” 的效果，再决定是否切换。中间色调的强调色甚至会自动调整标题装饰。

# 随内容一起成长的导航

home.njk 布局接入 Eleventy Navigation，用带有无障碍语义的标记构建递归菜单。在窄屏上，汉堡按钮会以动画展开和收起侧边栏，同时保留焦点状态。配合 Tachyons 配色，导航可以随着内容树增长而扩展，无需手工调整。

# 不打扰写作的创作流程

内容作者只管写 Markdown，其余交给过滤器。自定义的 excerpt 辅助函数会提取前几个段落，或回退到智能截短的文本；posts/posts.json 中的 front matter 默认值则确保每篇文章继承相同布局。想突出展示某个集合？导入 renderPostList，格式交给模板处理。

# 自动生成分享素材

现在，npx @11ty/eleventy 会在每次构建前触发 generate-og-images.js。脚本会遍历文章，用 gray-matter 解析 front matter，再通过 Satori 和 Resvg 渲染高对比度卡片。缓存清单让重复构建保持快速，你无需手工设计，就能在 assets/og/ 中拿到可直接用于生产的图片。

# 开始使用

你可以直接发布这个模板，也可以花一个下午把它改成自己的品牌风格。

npm install
npx @11ty/eleventy --serve

访问 http://localhost:8080，切换主题预览，然后开始编辑 posts/ 中的 Markdown。准备上线时，运行：

npx @11ty/eleventy

把 _site/ 的输出部署到你喜欢的静态托管平台，网站就上线了。

# 接下来

v1.0.0 提供了稳定的基础，我们也已经在探索更多主题、图片优化和更丰富的内容宏。欢迎试用，告诉我们你做了什么，一起推动下一个版本。