new source of truth
Some checks are pending
/ deploy (push) Waiting to run

This commit is contained in:
Loyyd 2026-06-11 10:01:45 +02:00
parent 9d0a823351
commit d74495ddef
936 changed files with 80 additions and 69 deletions

View file

@ -6,8 +6,10 @@ explicitly says a change must preserve a URL.
## What This Is
This is an Astro-built static website. The current source content is exported
HTML plus CSS, JavaScript, images, PDFs, and other static assets.
This is an Astro-built static website. `content/` is the future source of truth
for editable blog and speech content. `archive-source/` keeps legacy exported
HTML plus CSS, JavaScript, images, PDFs, and other static assets while the
migration continues.
## Working Rules
@ -24,13 +26,13 @@ HTML plus CSS, JavaScript, images, PDFs, and other static assets.
| Path | What it is |
|------|------------|
| `website/index.html` | Home page |
| `website/about.html` | About page |
| `website/contact.html` | Contact page with the form |
| `website/` | Source HTML pages, blog posts, speech archives, categories, and tags |
| `website/PAGES.md` | Map from old folder paths to current HTML paths |
| `content/` | Extracted Markdown archive for speeches and blog posts |
| `src/pages/` | Astro endpoints that generate static output from `website/` |
| `content/` | Future source of truth for editable speeches and blog posts |
| `archive-source/index.html` | Legacy exported home page |
| `archive-source/about.html` | Legacy exported about page |
| `archive-source/contact.html` | Legacy exported contact page with the form |
| `archive-source/` | Legacy exported HTML pages, blog posts, speech archives, categories, and tags |
| `archive-source/PAGES.md` | Map from old folder paths to current HTML paths |
| `src/pages/` | Astro endpoints that generate static output from `archive-source/` where routes are not migrated |
| `src/components/` | Astro components for shared layout migration |
| `dist/` | Generated static output from `npm run build` |
| `css/` | Site-level stylesheets |

View file

@ -2,10 +2,14 @@
Local static website files built with Astro.
`content/` is the future source of truth for editable blog and speech content.
`archive-source/` keeps the legacy exported HTML used by the current static
archive routes while the migration continues.
## Project Structure
- `website/` - exported HTML source pages and archive pages
- `content/` - extracted Markdown content archive for speeches and blog posts
- `content/` - future source of truth for editable speeches and blog posts
- `archive-source/` - legacy exported HTML pages and archive pages
- `src/content/pages/` - preserved HTML body fragments for migrated public pages
- `src/pages/` - Astro routes for migrated public pages plus the static archive catch-all
- `src/components/` - Astro components for shared page layout
@ -13,12 +17,12 @@ Local static website files built with Astro.
- `src/pages/index.astro` - homepage route generated from migrated content
- `src/pages/about.astro` - about page route generated from migrated content
- `src/pages/contact.astro` - contact page route generated from migrated content
- `website/index.html`, `website/about.html`, `website/contact.html` - original exported source for migrated public pages
- `website/blog/YYYY/MM/DD/` - dated blog post pages
- `website/blog/categories/` - blog category archive pages
- `website/blog/tags/` - blog tag archive pages
- `website/speeches/` - speech archive indexes and speech category pages
- `website/PAGES.md` - map from the old folder URLs to the current HTML paths
- `archive-source/index.html`, `archive-source/about.html`, `archive-source/contact.html` - original exported source for migrated public pages
- `archive-source/blog/YYYY/MM/DD/` - legacy dated blog post pages
- `archive-source/blog/categories/` - legacy blog category archive pages
- `archive-source/blog/tags/` - legacy blog tag archive pages
- `archive-source/speeches/` - legacy speech archive indexes and speech category pages
- `archive-source/PAGES.md` - map from the old folder URLs to the current HTML paths
- `css/` - site-level stylesheets
- `css/theme.css` - extracted Parabola inline theme settings
- `css/site.css` - extracted site fixes and homepage/frontpage rules
@ -51,15 +55,15 @@ Run the static link and media audit against the generated `dist/` output:
npm run audit:links
```
Regenerate Markdown content from the exported post HTML:
Regenerate Markdown content from the legacy exported post HTML:
```bash
npm run extract:content
```
The important public pages are now Astro routes that reuse shared layout
components. The large blog and speech archive is still served from the exported
HTML through `src/pages/[...route].ts`.
components. The large blog and speech archive is still served from legacy
exported HTML in `archive-source/` through `src/pages/[...route].ts`.
The repeated exported inline styles have been moved into `css/theme.css` and
`css/site.css`. Tiny one-page WordPress block-support styles may still remain

Some files were not shown because too many files have changed in this diff Show more