【技术分享】YTBlog Theme + FluxgridEditor

为什么再造一个轮子

Typecho 默认主题简单可靠，但放在 2026 年看，已经稍显朴素：

YTBlog Theme 的核心特性

首页 Hero —— 让落地页有「态度」

首页顶部会自动抓取最新 5 篇带封面的文章做轮播，左侧显示标题 / 摘要 / CTA，右侧是动态的代码窗口卡片，把站点信息渲染成 JS 对象的样子。整体配上粒子背景，第一眼就能看出和默认主题的差异。

短代码系统 —— 不写 HTML 也能排版

主题内置 9 种短代码，全部支持 Markdown 内嵌，互相也可以嵌套。下面这些就是用短代码写出来的：

[tag type="primary"]Primary[/tag]

[button color="success" url="https://..."]按钮文字[/button]

# 短代码会被解析成 <details>，原生支持键盘和无障碍
echo "Hello World"

[collapse title="点我展开"]内容[/collapse]

多层内容加密 —— 从一段话到全站

对于「半私密」内容，主题内置了六种粒度的加密能力，可按需组合：

其他能写进首页 README 的细节

• GitHub 个人页 —— page-github.php 模板，输入用户名即可拉取仓库列表 / 贡献热力图
• 暗色 / 亮色双主题 —— 顶栏右上角一键切换，状态写入 localStorage
• 粒子背景 —— Canvas 实现，自动根据屏幕分辨率调节粒子密度
• PJAX-friendly —— 主题脚本封装在 initPageContent()，切换页面无需重新初始化
• 响应式 —— 4 个断点（>1280 / 1060 / 768 / 480）覆盖桌面到手机

FluxgridEditor —— 配套的写作引擎

Typecho 默认编辑器是一个朴素 textarea，写一篇带图带数学公式的长文几乎是不可能的。FluxgridEditor 用 Vditor 3.10 替换默认编辑器，提供三种模式：

图片和附件的自动分流

拖拽 / 粘贴 / 上传
        │
        ▼
   是图片 ?
    ├── 是 → 兰空 Pro v2 API（直传或外链转存）
    └── 否 → S3 兼容存储（PUT 走 AWS Sig v4）
                ↑
            未配置 S3 时回退到 Typecho 默认附件

支持的存储后端：

外链图自动转存

粘贴一张外站图片，插件会经服务端中继抓取后转存到兰空，避免外链失效或防盗链问题。中继路由用 relay.php 直连，绕开 Typecho action 路由不稳定的坑。

安装

一些坑和折中

写在最后

主题 + 插件这套组合是给 工程师博主 准备的：要的是写起来顺手、看起来不土、出问题能直接读源码定位。如果你也是这类用户，欢迎试用并提 issue。