62 lines
1.8 KiB
Markdown
62 lines
1.8 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. The current source content is exported
|
|
HTML plus CSS, JavaScript, images, PDFs, and other static assets.
|
|
|
|
## Working Rules
|
|
|
|
- All files in this repository may be changed when needed.
|
|
- 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.
|
|
|
|
## Repo Map
|
|
|
|
| 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 |
|
|
| `src/pages/` | Astro endpoints that generate static output from `website/` |
|
|
| `src/components/` | Astro components for shared layout migration |
|
|
| `dist/` | Generated static output from `npm run build` |
|
|
| `css/` | Site-level stylesheets |
|
|
| `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 the Nginx preview:
|
|
|
|
```bash
|
|
npm run build
|
|
```
|
|
|
|
```bash
|
|
docker compose up
|
|
```
|
|
|
|
Then open:
|
|
|
|
```text
|
|
http://localhost:8080/
|
|
```
|