Files
galaxy-game/site
Ilia Denisov 140ee8e0ee
Build · Site / build (push) Successful in 8s
Tests · Go / test (push) Successful in 2m27s
Tests · UI / test (push) Waiting to run
Tests · Integration / integration (pull_request) Successful in 1m45s
Build · Site / build (pull_request) Successful in 9s
Tests · Go / test (pull_request) Successful in 3m14s
Tests · UI / test (pull_request) Successful in 3m14s
docs(site): edit rules for clarity + cross-links; migrate off rules.txt
Editorial pass over site/ru/rules.md (on top of the verbatim port):
- moved the lore intro to the RU home page, rewritten in a modern voice;
- fixed typos, replaced the TODO/WTF cargo-tech note and the abandoned
  (---ссылка---) marker with the verified mechanic and a real cross-link,
  dropped the report TODO row;
- wove organic intra-page cross-links (#combat, #movement, #victory, ...);
- documented engine nuances verified against the code: ore auto-farming
  and the capital / "запасы промышленности" store (industry capped at
  population); cargo lost with ships destroyed in battle; and that a
  losing race's colonists at a neutral planet are NOT lost — they stay
  aboard (this corrects the audit note, verified in route.go).

Migration: delete game/rules.txt (its content now lives, authoritative,
in site/ru/rules.md) and repoint every reference to it (ui/frontend code
comments + tests, ui/docs, tools, ui/PLAN.md links). Record the
RU-authoritative rule in site/README.md and CLAUDE.md. The English
site/rules.md mirror follows in a separate stage.
2026-05-31 15:56:00 +02:00
..

Galaxy project site

The public project site — an overview today, documentation as it grows. Built with VitePress 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.