当前站点架构更新分析与下一步任务
根据最新仓库调整,分析已做内容与未完成问题
最近一次更新主要是补齐英文源内容、整理待办任务,并修正部分语言处理问题。
这篇文章直接分析当前仓库状态:哪些已经更新,哪些还需要继续修复。
一、当前更新概况
已补齐英文源内容 新增或补全了
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 共享逻辑。
引入统一配置文件,减少各处硬编码。
这次更新已经完成了内容补齐和任务梳理,下一阶段应把重点放在“让构建链变得稳定”和“让语言分支一致”。
|