|
当前站点架构更新分析与下一步任务
根据最新仓库调整,分析已做内容与未完成问题
最近一次更新主要是补齐英文源内容、整理待办任务,并修正部分语言处理问题。
这篇文章直接分析当前仓库状态:哪些已经更新,哪些还需要继续修复。
一、当前更新概况
已补齐英文源内容
新增或补全了
`src/content/blog/en/202603.html`、`src/content/blog/en/202605.html`、
`src/content/blog/en/generate-rss.html`、`src/content/page/en/downloads.html`
和 `src/content/page/en/example.html`。
已修正英文审计描述
现有 `src/content/blog/en/framework-review.html`
中,问题描述已更准确地指出“英文标签页使用中文侧边栏标签”的实际现象。
已整理当前待办
`TODO.md`
已记录这次更新,并新增了与英文构建、语言分支验证、页面模板抽取相关的后续任务。
二、当前架构仍存在的主要缺陷
语言分支还不够稳固
虽然补齐了英文页面源文件,但构建脚本本身还没有完成语言分支重构。
`generate-archive.ps1` 仍可能默认加载中文侧边栏,`rebuild-all.ps1` 的英文
build 顺序也需要验证。
页面骨架重复未解决
当前 HTML 页面构建仍在 `build.ps1`、`generate-archive.ps1`、`editor.py`
等多个地方单独拼装。 这意味着后续布局修改仍然需要重复维护。
配置尚未统一
站点名、路径、语言、端口、最大留言数等配置仍散落在不同脚本中。
没有统一配置文件会增加部署和扩展的难度。
CGI 公共逻辑仍未抽离
`editor.py`、`guestbook.py` 等脚本仍然分别实现表单解析、IP
提取、重建触发等功能。 建议尽快创建 `cgi-bin/_common.py` 进行共享。
三、验证与修复优先级
优先验证英文页面生成
先执行完整构建,确认 `src/content/blog/en/` 和 `src/content/page/en/`
的内容是否被正确注入到 `dist/en/` 输出中。
优先修复语言侧边栏选择
最关键的是让 `generate-archive.ps1` 和 `build.ps1` 根据 `$Lang` 一致加载
`sidebar-left-en.html` / `sidebar-right-en.html`。
优先修正英文 latest-posts 顺序
`rebuild-all.ps1` 应将英文 `generate-archive.ps1 -Lang en`
提前到英文页面构建之前,避免首次构建显示空侧边栏。
优先抽取共享页面模板
建议创建 `src/components/page-shell.html`,让页面骨架不再被各脚本分散实现。
四、下一步任务清单
- 确认新补的英文页面是否已正确集成到 `-Lang en` 构建流程。
- 修复 `generate-archive.ps1` 的英文侧边栏加载逻辑。
- 修正 `rebuild-all.ps1` 中英文 latest-posts 的生成顺序。
- 创建 `cgi-bin/_common.py`,抽离 CGI 共享逻辑。
- 引入统一配置文件,减少各处硬编码。
这次更新已经完成了内容补齐和任务梳理,下一阶段应把重点放在“让构建链变得稳定”和“让语言分支一致”。
|