# Galaxy project site

The public project site — an overview today, documentation as it grows.
Built with [VitePress](https://vitepress.dev) and served as static files
at the **root** (`/`) of the single-origin deployment; the game UI lives
under `/game/` (see `tools/dev-deploy/Caddyfile.dev`).

## Layout

- `index.md`, `ru/index.md` — per-locale home pages.
- `.vitepress/config.ts` — site config: locales (English + Russian, with
  the built-in language switcher), LaTeX math (`math: true`), and the
  two-column navigation (left sidebar = chapters, right outline =
  on-this-page).
- `.vitepress/theme/` — the default theme without bundled fonts, plus a
  minimal monospace type stack in `custom.css`.

## Authoring

- Add a page as Markdown and register it in the `sidebar` of each locale
  in `.vitepress/config.ts`.
- Localised content mirrors the English tree under `ru/`.
- **Game rules** (`ru/rules.md`) are the one exception to English-first:
  the Russian page is the authoritative source (ported from the former
  `game/rules.txt`), and the English `rules.md` is its mirror/translation.
  Keep the two in sync as with `FUNCTIONAL.md`/`FUNCTIONAL_ru.md`, but with
  Russian leading.
- Math uses LaTeX: inline `$E = mc^2$`, block `$$ … $$`.
- Link to the game with the root-relative `/game/` path so the build
  stays domain-agnostic (no hard-coded host).

## Commands

    pnpm install
    pnpm dev      # local dev server
    pnpm build    # static build into .vitepress/dist
    pnpm preview  # preview the build

The dev and prod deploys build the site via
`make -C tools/dev-deploy seed-site` and the `dev-deploy` /
`prod-build` workflows.