diff --git a/README.md b/README.md index bf1a485..e0df150 100644 --- a/README.md +++ b/README.md @@ -1,14 +1,24 @@ # Research Notes -Evidence-led writing on artificial intelligence, robotics, and technical -strategy by Theodore Ouyang. Every work is preserved as a complete Chinese -edition and a complete English edition; the reading site shows one language at -a time. +**A bilingual, evidence-led research archive by Theodore Ouyang.** -[中文阅读](https://research-notes-130u.jiligualapiqiu.chatgpt.site/) · -[Read in English](https://research-notes-130u.jiligualapiqiu.chatgpt.site/?lang=en) · +围绕人工智能、机器人与技术路径,把复杂问题整理成可审阅、可引用、可复核的判断。 + +Every work is preserved as a complete Chinese edition and a complete English edition, with its evidence boundary and audit trail kept close to the writing. + +**[中文阅读](https://research-notes-130u.jiligualapiqiu.chatgpt.site/)** · +**[Read in English](https://research-notes-130u.jiligualapiqiu.chatgpt.site/?lang=en)** · [Research](research/) · [Articles](articles/) · [Reflections](reflections/) +`Astro 7` `TypeScript` `Bilingual` `Evidence-led` `GitHub Pages disabled` + +## At a glance + +- **Three published works:** two research dossiers and one technical essay. +- **Complete bilingual editions:** language switching preserves the reader's position instead of replacing full works with summaries. +- **Reviewable provenance:** manifests, source ledgers, audit notes, and preserved research archives travel with the relevant work. +- **Independent reading surface:** the static Astro site is hosted separately from `theodoreoy.com` and from GitHub Pages. + ## Work @@ -31,7 +41,16 @@ a time. [中文全文](research/2026-08-03-manifold-world-model-landscape/README.zh-CN.md) · [English version](research/2026-08-03-manifold-world-model-landscape/README.en.md) · [Read on web](https://research-notes-130u.jiligualapiqiu.chatgpt.site/manifold-world-model-landscape/) -## Repository +## What this repository demonstrates + +| Layer | What is shown | +| --- | --- | +| Research | Source-led analysis with explicit separation between evidence, claims, explanation, and interpretation | +| Editorial | Complete Chinese and English editions with stable metadata and collection indexes | +| Product | A responsive reading interface with persistent language choice, accessible navigation, and compact-screen outlines | +| Engineering | Schema validation, deterministic index generation, static-site auditing, and a version-locked Astro build | + +## Repository map Each work lives in its own folder. The report, sources, audit trail, figures, and any preserved research archive travel together instead of being scattered @@ -59,14 +78,23 @@ Markdown inside each project folder is the canonical editable source. A provenance for projects that need them. Generated HTML under `_site/` is disposable. -## Maintenance +## Local verification + +```powershell +npm ci +npm run check +npm run build +``` + +`npm run check` validates content manifests, generated indexes, and Astro types. The build then copies public source artifacts and audits the generated site. + +## Maintenance and deployment boundary The repository uses a version-locked Astro static build. Operational details live in the [Publishing Standard](PUBLISHING_STANDARD.md); architectural decisions live in [ADR-001](ARCHITECTURE.md). -GitHub Actions validates the archive, but GitHub Pages remains disabled. The -public reading site is hosted independently from the validated repository. +GitHub Actions validates the archive, but **GitHub Pages remains disabled**. The public reading site is hosted independently so this project cannot inherit or alter the custom-domain behavior of the separate personal-site repository. ## Rights diff --git a/public/og.png b/public/og.png new file mode 100644 index 0000000..555bdf6 Binary files /dev/null and b/public/og.png differ diff --git a/src/components/PostCard.astro b/src/components/PostCard.astro index f1f7ec0..58e40a7 100644 --- a/src/components/PostCard.astro +++ b/src/components/PostCard.astro @@ -32,6 +32,12 @@ const number = String(data.seriesNo).padStart(2, "0");

{data.languages.en.summary}

+ diff --git a/src/components/SiteHeader.astro b/src/components/SiteHeader.astro index 024a205..2114f9c 100644 --- a/src/components/SiteHeader.astro +++ b/src/components/SiteHeader.astro @@ -2,21 +2,26 @@ import { collectionHref } from "../lib/site"; const home = import.meta.env.BASE_URL; +const pathname = Astro.url.pathname; +const isCollection = (path: string) => pathname.includes(`/${path}/`); ---