Current Site Architecture Update Analysis & Next Steps

Analysis of what's been done and what remains based on the latest repository changes

The most recent update mainly focused on filling in English source content, organizing pending tasks, and fixing some language processing issues.

This article directly analyzes the current repository state: what has been updated and what still needs fixing.

I. Current Update Overview

English Source Content Filled In
Added or completed
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,
and src/content/page/en/example.html.

English Audit Descriptions Corrected
In the existing src/content/blog/en/framework-review.html,
the problem description now more accurately describes the actual issue of "English tag pages using Chinese sidebar labels."

Current TODOs Organized
TODO.md
has been updated with this round of changes, plus new follow-up tasks related to English builds, language branch verification, and page template extraction.

II. Major Deficiencies Still Present in the Current Architecture

Language Branch Is Not Yet Stable
Although English page source files have been filled in, the build scripts themselves haven't completed the language branch refactoring.
generate-archive.ps1 may still default to loading the Chinese sidebar, and the English build order in rebuild-all.ps1 still needs verification.

Page Skeleton Duplication Unresolved
Current HTML page assembly is still implemented separately in build.ps1, generate-archive.ps1, editor.py,
and other places. This means future layout changes still require maintaining multiple copies.

Configuration Not Yet Unified
Site name, paths, language, port, max guestbook entries, etc. are still scattered across different scripts.
The lack of a unified configuration file increases deployment and scaling difficulty.

CGI Common Logic Not Extracted
editor.py, guestbook.py and other scripts still independently implement form parsing, IP extraction, rebuild triggering, etc.
It is recommended to create cgi-bin/_common.py for shared functions as soon as possible.

III. Verification and Fix Priorities

Prioritize English Page Generation Verification
First run a full build and confirm that content from src/content/blog/en/ and src/content/page/en/ is correctly injected into dist/en/ output.

Prioritize Fixing Language Sidebar Selection
The most critical issue is making generate-archive.ps1 and build.ps1 consistently load sidebar-left-en.html / sidebar-right-en.html based on $Lang.

Prioritize Fixing English Latest-Posts Build Order
rebuild-all.ps1 should move the English generate-archive.ps1 -Lang en step before English page builds to avoid empty sidebar "Latest Posts" on first build.

Prioritize Extracting Shared Page Templates
Recommend creating src/components/page-shell.html so page skeletons are no longer scattered across multiple scripts.

IV. Next Steps Task List

Verify that newly added English pages are correctly integrated into the -Lang en build pipeline.

Fix generate-archive.ps1 English sidebar loading logic.

Correct rebuild-all.ps1 English latest-posts generation order.

Create cgi-bin/_common.py to extract CGI shared logic.

Introduce a unified configuration file to reduce hardcoded values throughout.

This update has completed content backfilling and task organization. The next phase should focus on "making the build chain stable" and "making language branches consistent."

« Hakimi Observation Diary

« Home

IE 5.5 Compatibility Audit »