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

View file

@ -2,10 +2,14 @@
Local static website files built with Astro. 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 ## Project Structure
- `website/` - exported HTML source pages and archive pages - `content/` - future source of truth for editable speeches and blog posts
- `content/` - extracted Markdown content archive for 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/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/pages/` - Astro routes for migrated public pages plus the static archive catch-all
- `src/components/` - Astro components for shared page layout - `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/index.astro` - homepage route generated from migrated content
- `src/pages/about.astro` - about page 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 - `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 - `archive-source/index.html`, `archive-source/about.html`, `archive-source/contact.html` - original exported source for migrated public pages
- `website/blog/YYYY/MM/DD/` - dated blog post pages - `archive-source/blog/YYYY/MM/DD/` - legacy dated blog post pages
- `website/blog/categories/` - blog category archive pages - `archive-source/blog/categories/` - legacy blog category archive pages
- `website/blog/tags/` - blog tag archive pages - `archive-source/blog/tags/` - legacy blog tag archive pages
- `website/speeches/` - speech archive indexes and speech category pages - `archive-source/speeches/` - legacy speech archive indexes and speech category pages
- `website/PAGES.md` - map from the old folder URLs to the current HTML paths - `archive-source/PAGES.md` - map from the old folder URLs to the current HTML paths
- `css/` - site-level stylesheets - `css/` - site-level stylesheets
- `css/theme.css` - extracted Parabola inline theme settings - `css/theme.css` - extracted Parabola inline theme settings
- `css/site.css` - extracted site fixes and homepage/frontpage rules - `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 npm run audit:links
``` ```
Regenerate Markdown content from the exported post HTML: Regenerate Markdown content from the legacy exported post HTML:
```bash ```bash
npm run extract:content npm run extract:content
``` ```
The important public pages are now Astro routes that reuse shared layout 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 components. The large blog and speech archive is still served from legacy
HTML through `src/pages/[...route].ts`. exported HTML in `archive-source/` through `src/pages/[...route].ts`.
The repeated exported inline styles have been moved into `css/theme.css` and 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 `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