This commit is contained in:
parent
9d0a823351
commit
d74495ddef
936 changed files with 80 additions and 69 deletions
20
AGENTS.md
20
AGENTS.md
|
|
@ -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 |
|
||||||
|
|
|
||||||
26
README.md
26
README.md
|
|
@ -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
Loading…
Add table
Add a link
Reference in a new issue