Dusk · Open Source Theme
把注意力
还给阅读
暮秋 Dusk 是一款为长文阅读而写的 Typecho 主题。清醒的排版、克制的动效、完整的深色模式，让内容成为页面上唯一的主角。
当前版本 0.15.23 · 不绑定域名 · 无授权码 · 无付费版
Features
为阅读准备的每一个细节
主题不追求堆功能。导航、文章、侧栏、评论和编辑器延伸能力围绕同一套排版系统，桌面与手机保持一致的阅读节奏。
三栏与响应式布局
桌面端左侧导航、正文、右侧信息栏；平板与手机自动收敛为单列，阅读宽度和留白随屏幕调整。
完整深色模式
首屏前完成主题判定，无闪烁切换；正文、卡片、代码块、评论和编辑器面板均适配深色。
目录与阅读进度
长文自动生成目录，滚动高亮当前章节；顶部阅读进度提示当前位置，折叠目录在手机上保持轻量。
代码高亮与公式
代码块按语言高亮并带复制按钮；MathJax 按需加载，行内公式和独立公式都能正常渲染。
多媒体短代码
视频、音乐、友链和下载链接使用简短标记插入，输出原生播放器与结构化卡片，不依赖第三方嵌入。
编辑器延伸
后台工具栏提供标题、列表、引用、表格、代码、图片、视频、音乐、表情等 21 项能力，实时预览后发布。
搜索与评论
站内搜索支持键盘操作；评论区保留嵌套回复、表情和审核状态，移动端保持可点击尺寸。
缓存与性能
支持 Redis 或文件缓存，文章片段与页面按代际失效；缩略图按需生成并缓存，避免重复裁剪。
可访问性
键盘焦点可见、跳转链接、语义化标题层级和减少动效偏好均有处理，触屏与键鼠共用一套组件。
Engineering
轻量，但不简陋
主题只加载当前页面需要的能力。编辑器、公式、代码高亮和媒体组件按页面条件加载，避免把所有依赖塞进首屏。
- 01零 jQuery导航、搜索、主题切换、目录和阅读进度使用原生 JavaScript。
- 02资源按需加载编辑器脚本只在后台编辑页加载；前台代码高亮与公式按内容检测后加载。
- 03两代缓存策略Redis 适用于多进程站点，文件缓存适用于无 Redis 环境；发布文章自动失效。
- 04缩略图代理本地裁剪并缓存封面尺寸，输出统一比例，减少原图流量和布局抖动。
- 05渐进增强无 JavaScript 时仍可阅读、搜索和提交评论；增强功能失败不影响正文。
快速开始
git clone https://gitea.com/xkd/Dusk.git \
usr/themes/Dusk
chown -R www-data:www-data usr/themes/Dusk
在 Typecho 后台启用主题，按需填写首页大图、导航、置顶推荐与缓存设置。生产环境建议开启 Redis 缓存并配置 HTTPS。
Specs
技术信息
主题代码开源，站点内容与演示文章独立维护。升级前请备份主题目录与数据库。
| 主题版本 | 0.15.23 |
|---|---|
| 运行环境 | Typecho 1.2 / 1.3，PHP 8.1–8.4，MySQL 或 SQLite |
| 开源协议 | GPL-2.0，可自由使用、修改与分发 |
| 源码仓库 | gitea.com/xkd/Dusk |
| 前端依赖 | 无 jQuery、无第三方 UI 框架、无 CDN 强依赖 |
| 缓存方式 | Redis 或文件缓存，页面、片段和缩略图分层缓存 |
| 内容能力 | 目录、代码高亮、数学公式、表情、视频、音乐、友链、相关文章 |
| 演示站点 | senls.cn，即本站 |
FAQ
常见问题
关于授权、升级和二次开发的几个高频问题。
主题是免费的吗？
是。暮秋 Dusk 以 GPL-2.0 协议开源，不设付费版、授权码或域名绑定，个人博客和商业站点都可以直接使用。
可以修改主题吗？
可以。你可以直接修改源码，也可以基于主题做二次开发。再分发时请保留原作者版权声明并继续使用 GPL 协议。
升级会覆盖我的设置吗？
主题选项保存在数据库中，正常覆盖主题文件不会丢失设置。升级前仍建议备份主题目录和数据库，避免自定义代码被覆盖。
为什么首页推荐区和文章列表分开？
推荐区用来放编辑精选的置顶文章，使用双栏封面卡片；最新文章列表保持单列阅读节奏。两处内容自动去重。
如何反馈问题？
可以在开源仓库提交 Issue，附上 Typecho、PHP 版本、复现步骤和截图；也欢迎直接提交 Pull Request。
暮秋 Dusk · 开源 Typecho 主题 · 演示站点 senls.cn
评论区 暂无评论
评论已关闭。