Reference

Cloudflare Pages

The wiki is a static site. Cloudflare Pages serves it straight from the repository, with no build step.

Pages settings

  • Project root: wiki
  • Build command: leave empty
  • Output directory: .
  • Custom domain: vibetrading.wiki

A push to main that touches wiki/ or agent/src/factors/ deploys it; the deploy generates the Alpha Library pages first.

Editing the docs

English pages live in wiki/docs/content.en.js, Chinese pages in wiki/docs/content.zh.js. Both must have the same pages and sections in the same order. English is served at /docs/latest/…, Chinese at /docs/zh/….

Every page of the site shares one header, footer and head block from wiki/partials/. The rest of the site is English HTML with Chinese in wiki/locales/zh.json. English is the default; the header button switches the whole site and remembers the choice. CI runs:

node wiki/scripts/check_docs_parity.mjs
python3 wiki/scripts/sync_site_chrome.py --check
python3 wiki/scripts/check_i18n.py

Why static

Docs, landing copy, redirects, theme, language and search all work as static files. No VPS, database or server process is needed; the only server-side code is an anonymous page-view counter.