39b96cd34e
All checks were successful
Build and publish static site / build (push) Successful in 1m26s
75 lines
2.6 KiB
Markdown
75 lines
2.6 KiB
Markdown
# AGENTS.md - Family Fed Ireland website
|
|
|
|
This repository is for local work only. Do not treat it as a live production
|
|
server, and do not avoid changes because of live URL concerns unless the user
|
|
explicitly says a change must preserve a URL.
|
|
|
|
## What This Is
|
|
|
|
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
|
|
|
|
- All files in this repository may be changed when needed.
|
|
- For requested website changes, deploy the completed change to the live site by
|
|
default. Do not start or present a local preview unless the user explicitly
|
|
asks for one.
|
|
- When the user says to move something, move it. Do not only copy it or create a
|
|
parallel structure unless the user specifically asks for a copy.
|
|
- If moving files requires updating links, imports, scripts, stylesheets, image
|
|
paths, or documentation, update those references too.
|
|
- Keep the structure simple and close to what the user asks for.
|
|
- `.forgejo/` and deployment configuration are not special unless the user says
|
|
they are.
|
|
- Feature-branch Actions build and validate only. Production Garage publishing
|
|
is restricted to commits on `main`.
|
|
|
|
## Repo Map
|
|
|
|
| Path | What it is |
|
|
|------|------------|
|
|
| `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 |
|
|
| `css/theme.css` | Extracted Parabola inline theme settings |
|
|
| `css/site.css` | Extracted site fixes and homepage/frontpage rules |
|
|
| `js/` | Site-level scripts |
|
|
| `assets/` | Images, PDFs, fonts, theme files, uploads, and static vendor files |
|
|
| `docs/` | Maintainer notes and site-structure documentation |
|
|
|
|
## Local Preview
|
|
|
|
For Astro development:
|
|
|
|
```bash
|
|
npm run dev
|
|
```
|
|
|
|
For a production-style Astro preview:
|
|
|
|
```bash
|
|
npm run build
|
|
npm run preview
|
|
```
|
|
|
|
For a build health check:
|
|
|
|
```bash
|
|
npm run check
|
|
```
|
|
|
|
Then open:
|
|
|
|
```text
|
|
http://localhost:4321/
|
|
```
|