# Site structure

This repository is the production source for `https://familyfed.bcgen.ie/`.
Everything is served as static files, so top-level page folders are also URL
paths.

## Do not casually move these

These top-level directories are public routes. Renaming or moving them changes
the live URL unless redirects are added at the hosting layer.

- `about-us/`
- `contact/`
- `events/`
- `register/`
- `services/`
- `the-founders/`
- `videos/`
- `2013-sunday-service-archive/` through `2018-sunday-service-archive/` compatibility redirects
- `blog/`

## Main content groups

| Group | Paths | Notes |
| --- | --- | --- |
| Core pages | `index.html`, `about-us/`, `contact/`, `events/`, `register/`, `services/`, `the-founders/`, `videos/` | Best first targets for active maintenance. |
| Sunday service archives | `archive/sunday-services/YYYY/`, plus `services/` | Mostly link lists to Vimeo or YouTube. Old top-level year folders are redirect stubs only. |
| Speeches archive | `archive/speeches/`, `archive/speeches/rev-dr-sun-myung-moon/YYYY/` | Large historical text archive. Old top-level speech folders are not kept. |
| Blog mirror | `blog/` | Generated archive, category, tag, and dated pages. |
| Static assets | `assets/` | CSS, JavaScript, fonts, images, PDFs, and static vendor files. |

## Asset locations

- Site theme CSS, JavaScript, fonts, and images live under `assets/theme/parabola/`.
- Shared page/content CSS lives under `assets/css/`.
- General JavaScript lives under `assets/js/`.
- Uploaded images and PDFs live under `assets/uploads/`.
- Static vendor files used by old exported pages live under `assets/vendor/`.

For new production images or PDFs, prefer adding them under
`assets/uploads/YYYY/MM/`.

## Maintenance notes

- Use a local web server when previewing: `docker compose up`.
- Check pages at `http://localhost:8080/...`, not by opening files directly.
- Keep edits small and URL-aware.
- Keep real archive pages under `archive/`.
  The old top-level Sunday service folders are kept only so old links redirect
  instead of breaking. Old top-level speech folders have been removed.
- When editing shared header, navigation, or footer markup, remember that the
  markup is duplicated across many HTML files.
- Some legacy class names remain in exported markup and CSS. Treat them as static
  styling hooks, not as a CMS dependency.