22 June 2026, 20:00 (CST)
2026年06月22日(东八区)
大版本更新:周计划看板 v1.0 + Design 页
概述
本次为站点 Out - Projects 区的一次大功能迭代:上线 周计划看板(列表 + 明细 + 规则引擎 + 加权进度),并同步完成 Design 应用网格 样式对齐。数据与 content/ 同级存放在 kanban/,未修改 themes/。
更新明细
1. 周计划看板 · 架构
| 层级 | 路径 / 文件 |
|---|---|
| 数据源 | kanban/<周一日期>.md |
| Zola 分区 | content/kanban/(symlink 指向数据源) |
| 静态读取 | static/kanban/ → 前端 fetch 原始 MD |
| 规则引擎 | static/js/kanban-rules.js |
| 明细 UI | static/js/kanban-board.js + templates/kanban.html |
| 列表 UI | static/js/kanban-list.js + templates/kanban_list.html |
| 样式 | sass/kanban/style.scss |
| 映射文档 | kanban/kanban-mapping.md |
| Edit 缓冲 | kanban/_edit-buffer.md |
入口:侧边栏 → Out - Projects → 周计划 → /kanban/
2. 列表页(图一)
- 标题显示
core_tasks(如「看板规则引擎 · Trello 明细页…」),不显示日期区间 - 元信息一行(article 图标风格):开始 · 截止 · 剩余天数 · 进度% · 重要等级(5 星)
- 剩余天数 = 截止日 − 基准日(东八区;早于
week_start时以开始日为基准) - 统计行:共 N 项 / 已完成 / 待办 / 进行中
- 背景色:待办 > 3 → 全红;全完成 → 浅绿;其余 → 按加权进度渐变
3. 明细页(图二 · Trello 五列)
| 列 | 参与进度 | 说明 |
|---|---|---|
| 待办 / 进行中 / 已完成 | ✅ | 可拖拽(解锁后) |
| 资源 | ❌ | 淡绿托盘,列出所需资源 |
| 目标 | ❌ | @goal complete 淡蓝 / @goal risk 灰爆样式 |
- 页头仅显示 本周核心(
core_tasks),无重复日期标题 - 卡片:顶栏色(
@top)+ 标签条(@labels)+ checklist + 描述;不显示开始/截止/星级(这些只在列表页) - 列头深色块:待办蓝 / 进行中橙 / 已完成绿 / 资源绿 / 目标灰
4. 锁定 / 解锁 / 保存
| 状态 | 行为 |
|---|---|
| 锁定(默认) | 不可拖拽;隐藏 ReDeplog / Edit Post / 映射说明 |
| 解锁 | 仅在 week_start~week_end(东八区)内可切换;可拖拽跨列(本地预览) |
| Edit Post | 点击前按规则引擎序列化 → 写入 buffer → 复制剪贴板 /(可选 Token)API 覆盖 kanban/<周>.md |
| 超期 | 超过 week_end 永久只读 |
5. 加权进度公式
以 50% 为基准,仅统计前三列:
| 列 | 单项贡献 |
|---|---|
| 待办 | −10% × n |
| 进行中 | +5% × n |
| 已完成 | +15% × n |
n = 该卡片 @labels 数量(无标签时 n = 1)。结果 clamp 至 0–100%,写入 stats.progress_pct。
示例(6.16–6.22 周):待办 4 / 进行中 2 / 已完成 2 → 45%;待办 > 3 → 列表背景红色。
6. Design 页(同期)
/design/应用网格对齐 ensili.co More apps 布局- 文件:
templates/design.html、sass/design/style.scss、static/js/design-apps.js
7. 其他
zola.toml导航增加 周计划- 示例看板:
kanban/2026-06-16.md - 完整映射:
kanban/kanban-mapping.md
看板简易映射规则
# 列名 → 看板一列(待办 / 进行中 / 已完成 / 资源 / 目标)
## 卡片标题 → 一张卡片
@start 2026-06-16 开始(数据用,列表页展示)
@due 2026-06-22 截止
@priority 4 重要等级 1–5(列表页星级)
@top orange 明细页顶部粗色条
@labels red, blue 明细页顶部细色条 + 进度权重 n
@bg #FFF8E1 卡片背景色
@goal complete 目标看板 · 完成效果(淡蓝)
@goal risk 目标看板 · 未完成后果(灰爆)
- [ ] / - [x] checklist 勾选框Front Matter 要点:
[extra]
week_start = "2026-06-16"
week_end = "2026-06-22"
core_tasks = "本周核心任务一句话"
importance = 4
stats = { total = 8, done = 2, todo = 4, doing = 2, progress_pct = 45 }下次更新计划
测试解锁后编辑功能
- 解锁 → 拖拽跨列 / 勾选 checklist → 点击 Edit Post
- 验证序列化往返、
kanban/_edit-buffer.md缓冲、Codeberg 粘贴 / Token 同步 - 确认 ReDeplog 部署后列表进度与明细一致
针对特定设备显示解锁功能
- 评估移动端 / 平板是否展示「解锁 · 可拖拽」(触摸拖拽与桌面差异)
- 可按 viewport 或 UA 限制:小屏只读、桌面可编辑;或提供显式「桌面模式」提示
22 June 2026, 10:00 (CST)