Skip to content

Adopt scalable bilingual Astro publishing system - #1

Merged
130U merged 2 commits into
mainfrom
codex/pi0-bilingual-reading-note
Aug 2, 2026
Merged

Adopt scalable bilingual Astro publishing system#1
130U merged 2 commits into
mainfrom
codex/pi0-bilingual-reading-note

Conversation

@130U

@130U 130U commented Aug 2, 2026

Copy link
Copy Markdown
Owner

Outcome

This turns 130U/portfolio into a version-locked Astro publishing system for a growing bilingual archive, while preserving the approved π₀ article and its WM/WAM interpretation.

Architecture

  • Root and collection READMEs are generated from each article's strict post.json manifest and include direct Chinese, English, and web links.
  • Astro Content Collections produce the homepage, collection pages, stable /<slug>/ routes, posts.json, RSS, sitemap, canonical URLs, and TechArticle JSON-LD.
  • Chinese, English, and aligned bilingual modes use complete build-time HTML; JavaScript is progressive enhancement only.
  • KaTeX renders math at build time with no runtime CDN.
  • A committed publishing standard, ADR, strict JSON Schemas, source registry, audit record, and collision-safe article scaffold establish the reusable contract.
  • Only pushes to main may deploy GitHub Pages; pull requests validate and build.

π₀ integrity

  • 57 ordered bilingual semantic pairs, 31 display-equation blocks per language, and 20 unique registered sources are build-gated.
  • Language-specific DOM IDs remain unique while shared pair IDs preserve alignment.
  • Publication status has a single source of truth in the manifest.
  • The article's reasoning and conclusions are unchanged; only presentation metadata, anchor metadata, and portable math delimiters were normalized.

Validation

  • npm ci
  • npm run check: 0 Astro errors, warnings, or hints
  • npm run build: 6 HTML pages and 1 published route; built-site audit passed
  • npm audit: 0 vulnerabilities
  • Desktop and 390×844 browser QA: 3 language modes, 44 px controls, no duplicate IDs, no overflow, 162 rendered math elements
  • Three independent final read-only reviews: no remaining P1/P2 findings

Repository boundary

130U/130U.github.io was used only as a read-only design reference and was not modified.

@130U 130U changed the title Add bilingual π₀ research reader Adopt scalable bilingual Astro publishing system Aug 2, 2026
@130U
130U marked this pull request as ready for review August 2, 2026 09:22
@130U
130U merged commit f21a4a5 into main Aug 2, 2026
2 checks passed
@130U
130U deleted the codex/pi0-bilingual-reading-note branch August 2, 2026 09:23
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant