volks-typo
Astro / 博客 · 作者 jdrhyne
以包豪斯与战时纪念碑风格为视觉核心的 Astro 博客主题,内置暗色模式、MDX、目录与阅读时长。
使用许可与条件
免费使用 · 保留许可声明
MIT许可,允许免费使用、修改、分发及商用,仅需保留版权与许可声明;README未增设额外授权限制。
使用时需要遵守
- 保留原作者版权声明和 MIT 许可证声明。
- 保留版权声明与许可声明于所有副本或实质部分
需要另行核对
- 自托管字体(Oswald、Roboto Condensed、Work Sans、JetBrains Mono)的独立字体许可未在提供文本中确认
查看原文依据
Permission is hereby granted, free of charge, to any person obtaining a copy
许可证原文
This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
README 原文
https://github.com/jdrhyne/volks-typo/blob/main/LICENSEhttps://github.com/jdrhyne/volks-typo/blob/HEAD/README.mdPermission is hereby granted, free of char
许可证原文
DeepSeek 根据仓库许可证和 README 整理 · 2026-09-24。结果仅覆盖已读取资料,依赖、图片、字体及后续条款变更以各自原文为准。

模板详细介绍
Volks-Typo 是一个 Astro 博客主题,视觉上刻意把包豪斯功能主义与二战时期纪念碑式排版放在一起,形成 README 所说的“不和谐的和声”。结构上它仍是标准博客骨架:首页、博客列表、动态文章页、分类页、关于页和联系页,桌面端带左侧栏,移动端为单列布局,配色以黑白灰为主、红色作强调。
内容层面支持 Markdown 与 MDX,文章 frontmatter 可填标题、日期、作者、摘要、分类、标签、封面图和草稿标记;阅读时长按约 200 词/分钟自动计算,H2–H4 标题会生成带滚动高亮的目录。暗色模式通过 localStorage 持久化并做了防闪烁处理,字体自托管,站点信息集中在 src/config.ts,另附 Playwright 测试与视觉回归基线。
它适合想用 Astro 搭建个人写作站点、且愿意接受强风格视觉的人。需要留意:README 未说明评论、搜索、RSS 或 CMS 集成,联系页只是静态页面,不涉及真实后端;部署到子路径时需要配置 SITE 与 BASE_PATH,上线前建议自行核对构建产物与无障碍表现。
主要特点
- 包豪斯与战时纪念碑风格混合的强视觉排版
- 暗色模式切换,localStorage 持久化并防 FOUC
- 同时支持 Markdown 与 MDX 内容文件
- 自动阅读时长与带滚动高亮的目录
- 自托管字体,无外部字体请求
- 内置 Playwright 功能测试与视觉回归基线
适用场景
- 个人设计、排版或历史主题博客
- 想用 Astro + MDX 写长文并需要目录导航的站点
- 需要暗色模式与自托管字体、注重隐私的静态博客
- 希望用 Playwright 做视觉回归检查的主题二次开发
适合人群
- 熟悉 Astro 或愿意学习其内容集合机制的开发者
- 接受强风格视觉、不打算大改设计系统的写作者
- 部署到 Netlify、Vercel 或 GitHub Pages 等静态托管的项目
使用前需要核对
- 需要 Node.js 18.14.1 或更高版本
- 站点标题、作者、社交链接等集中在 src/config.ts 修改
- 部署到子目录(如 GitHub Pages)需设置 SITE 与 BASE_PATH 环境变量
- README 未提及评论、搜索、RSS 或 CMS,若需要应自行确认或另行集成
- 联系页与关于页为静态页面,不包含真实后端提交逻辑
本介绍由 AI 根据目录元数据和仓库 README 整理,实际功能以原仓库为准。
功能与适用范围
目录记录的用途为博客,主要技术栈为Astro。功能是否完整实现,需要在源码和演示中进一步确认。
- Astro
- 博客