tools/devarea
4
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
30e9a5a6e26609e40d4b07cf3c66950973184eaa
devarea/WIKI_CONNECTION.md
T
mr.zeroandClaude Opus 5 30e9a5a6e2 Close the desktop store item, and fix a check that had started lying 
MORE_STORES item 2 is done: stores/warp-engine-desktop-store and
stores/ttg-desktop-store. The write-up records what the implementation changed
about the plan — chiefly that the `html` asset is not a downloadable archive but a
hosted directory, so a browser title becomes a menu entry that opens its page
rather than an offline install.

Separately: `check-repos.sh` reported `infra/wiki-pages` as STALE while the repo
was plainly there. Gitea caps a page at 50 items whatever `--limit` says, so
`tea repo list --limit 1000` had been quietly returning the first 50 — invisible
until today, when the estate reached 51 repos. The check now pages through, and
fails loudly if the server returns nothing at all rather than declaring the whole
workspace stale.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
2026-08-18 10:00:41 +02:00

71 lines
13 KiB
Markdown
Raw Blame History

# Wiki Connections
Folders (repos) in this workspace that **already have** a wiki page in the `wiki-pages` mirror. The wiki runs on **Grav CMS**; the content schema is `infra/wiki-pages/pages/<path>/default.md`. Wiki base URL: `https://wiki.teletypegames.org/` (without the `/en/` prefix, based on the pages' internal links).
The workspace folder layout mirrors the Gitea orgs one-to-one since 2026-08-16: `bbs/`, `build/`, `demos/`, `engines/`, `games/`, `infra/`, `services/`, `tools/` — so a repo's path is `<org>/<name>`, and the first two columns of the table agree by construction. Two things sit outside that: `devarea` itself, which has to stay at the workspace root because `clone-repos.sh` clones into its parent, and `media/`, which holds reference images rather than repos. The org taxonomy is described in `REPO_REFACT.md` next to this file.
This file lives in the `devarea` repo (`tools/devarea`). The repo's `scripts/` folder holds the workspace management scripts (`clone-repos.sh` — clones the whole workspace in this structure based on `repos.list`; `check-repos.sh` — compares the list against the Gitea server; `install-tea.sh` — tea CLI installation), tied together by the `Makefile` in the root (`make help`). Paths in the table are relative to the workspace root (the parent directory of `devarea`).
| Folder | Org | Title | Wiki file | URL |
|---|---|---|---|---|
| `bbs/bbs-server` | `bbs` | BBS Server | `infra/wiki-pages/pages/infrastructure/bbs/default.md` | https://wiki.teletypegames.org/infrastructure/bbs |
| `bbs/impostor-bbs` | `bbs` | BBS (Game 1.5) | `infra/wiki-pages/pages/projects/neumatronic-universe/arcs/norman-arc/games/015-bbs/default.md` | https://wiki.teletypegames.org/projects/neumatronic-universe/arcs/norman-arc/games/015-bbs |
| `bbs/sermo-bbs` | `bbs` | Sermo OS Showcase | `infra/wiki-pages/pages/projects/neumatronic-universe/scratchpad/sermo-os/default.md` | https://wiki.teletypegames.org/projects/neumatronic-universe/scratchpad/sermo-os |
| `build/bevy-tools` | `build` | Bevy | `infra/wiki-pages/pages/development/bevy/default.md` | https://wiki.teletypegames.org/development/bevy |
| `build/c64-tools` | `build` | Commodore 64 | `infra/wiki-pages/pages/development/c64/default.md` | https://wiki.teletypegames.org/development/c64 |
| `build/ebitengine-tools` | `build` | Ebitengine | `infra/wiki-pages/pages/development/ebitengine/default.md` | https://wiki.teletypegames.org/development/ebitengine |
| `build/godot-tools` | `build` | Godot | `infra/wiki-pages/pages/development/godot/default.md` | https://wiki.teletypegames.org/development/godot |
| `build/love-tools` | `build` | Löve | `infra/wiki-pages/pages/development/love/default.md` | https://wiki.teletypegames.org/development/love |
| `build/phaser-tools` | `build` | Phaser | `infra/wiki-pages/pages/development/phaser/default.md` | https://wiki.teletypegames.org/development/phaser |
| `build/tic80-tools` | `build` | TIC-80 | `infra/wiki-pages/pages/development/tic80/default.md` | https://wiki.teletypegames.org/development/tic80 |
| `build/tic80pro-dockerfile` | `github` | TIC-80 | `infra/wiki-pages/pages/development/tic80/default.md` | https://wiki.teletypegames.org/development/tic80 |
| `demos/bevy-demo` | `demos` | Bevy | `infra/wiki-pages/pages/development/bevy/default.md` | https://wiki.teletypegames.org/development/bevy |
| `demos/inkwell-demo` | `demos` | inkwell | `infra/wiki-pages/pages/engines/inkwell/default.md` | https://wiki.teletypegames.org/engines/inkwell |
| `demos/phaser-demo` | `demos` | Phaser | `infra/wiki-pages/pages/development/phaser/default.md` | https://wiki.teletypegames.org/development/phaser |
| `engines/inkwell` | `engines` | inkwell | `infra/wiki-pages/pages/engines/inkwell/default.md` | https://wiki.teletypegames.org/engines/inkwell |
| `engines/rubbs` | `engines` | rubbs | `infra/wiki-pages/pages/engines/rubbs/default.md` | https://wiki.teletypegames.org/engines/rubbs |
| `engines/warp_engine` | `engines` | WarpEngine | `infra/wiki-pages/pages/engines/warp-engine/default.md` | https://wiki.teletypegames.org/engines/warp-engine |
| `engines/warpstore` | `engines` | warpstore | `infra/wiki-pages/pages/engines/warpstore/default.md` | https://wiki.teletypegames.org/engines/warpstore |
| `games/blessingofra` | `games` | Blessing of Ra | `infra/wiki-pages/pages/projects/blessingofra/default.md` | https://wiki.teletypegames.org/projects/blessingofra |
| `games/c64-demo` | `games` | Teletype Games C64 Demo | `infra/wiki-pages/pages/projects/c64-demo/default.md` | https://wiki.teletypegames.org/projects/c64-demo |
| `games/impostor` | `games` | Definitely Not an Impostor | `infra/wiki-pages/pages/projects/impostor/default.md` | https://wiki.teletypegames.org/projects/impostor |
| `games/rabbitc64` | `games` | Rabbit Scooter — C64 | `infra/wiki-pages/pages/projects/rabbitc64/default.md` | https://wiki.teletypegames.org/projects/rabbitc64 |
| `games/rabbitroller` | `games` | Rabbit Roller | `infra/wiki-pages/pages/projects/rabbitroller/default.md` | https://wiki.teletypegames.org/projects/rabbitroller |
| `games/realworld` | `games` | Real World | `infra/wiki-pages/pages/projects/realworld/default.md` | https://wiki.teletypegames.org/projects/realworld |
| `infra/backup-scripts` | `infra` | Backup scripts | `infra/wiki-pages/pages/infrastructure/backup/default.md` | https://wiki.teletypegames.org/infrastructure/backup |
| `infra/wiki-pages` | `infra` | Wiki Site | `infra/wiki-pages/pages/infrastructure/wiki-site/default.md` | https://wiki.teletypegames.org/infrastructure/wiki-site |
| `media/nokiapunk` | — | Nokia-Punk | `infra/wiki-pages/pages/projects/neumatronic-universe/universe/nokia-punk/default.md` | https://wiki.teletypegames.org/projects/neumatronic-universe/universe/nokia-punk |
| `services/statusbot` | `services` | Discord Thread Scheduler | `infra/wiki-pages/pages/others/statusbot/default.md` | https://wiki.teletypegames.org/others/statusbot |
| `services/teletypegames` | `services` | Public site | `infra/wiki-pages/pages/infrastructure/public-site/default.md` | https://wiki.teletypegames.org/infrastructure/public-site |
| `services/updater` | `services` | Discord Updater Bot | `infra/wiki-pages/pages/others/updater/default.md` | https://wiki.teletypegames.org/others/updater |
| `stores/ttg-batocera-store` | `stores` | TTG Batocera Store | `infra/wiki-pages/pages/stores/ttg-batocera-store/default.md` | https://wiki.teletypegames.org/stores/ttg-batocera-store |
| `stores/ttg-retroarch-store` | `stores` | TTG RetroArch Store | `infra/wiki-pages/pages/stores/ttg-retroarch-store/default.md` | https://wiki.teletypegames.org/stores/ttg-retroarch-store |
| `stores/ttg-desktop-store` | `stores` | TTG Desktop Store | `infra/wiki-pages/pages/stores/ttg-desktop-store/default.md` | https://wiki.teletypegames.org/stores/ttg-desktop-store |
| `stores/warp-engine-batocera-store` | `stores` | WarpEngine Batocera Store | `infra/wiki-pages/pages/stores/warp-engine-batocera-store/default.md` | https://wiki.teletypegames.org/stores/warp-engine-batocera-store |
| `stores/warp-engine-retroarch-store` | `stores` | WarpEngine RetroArch Store | `infra/wiki-pages/pages/stores/warp-engine-retroarch-store/default.md` | https://wiki.teletypegames.org/stores/warp-engine-retroarch-store |
| `stores/warp-engine-desktop-store` | `stores` | WarpEngine Desktop Store | `infra/wiki-pages/pages/stores/warp-engine-desktop-store/default.md` | https://wiki.teletypegames.org/stores/warp-engine-desktop-store |
## Notes
- **Structure change**: instead of the former Wiki.js mirror (`wiki-pages/wiki/<path>.md`), the wiki now runs on Grav CMS with the `infra/wiki-pages/pages/<path>/default.md` schema. Each page's wiki path is also stored in the `wikipath` frontmatter field.
- **pncdsl → inkwell rename**: the former `pncdsl` repo lives on as `inkwell` (`tools_libs/inkwell`), and `pncdsl-demo` as `inkwell-demo` (`demos/inkwell-demo`). The wiki page moved too: `development/ebitengine/pncdsl` → `development/ebitengine/inkwell` (both repos are documented by the same page: framework intro + companion demo).
- For `games/realworld`, the `projects/realworld` page (tree) is the developer/project doc (login-protected, subpages: catalog, entities, story); there is also a NU lore page: `projects/neumatronic-universe/arcs/norman-arc/games/02-realworld`.
- The former separate `pipeline.md` + `makefile.md` pages of the `*-tools` repos were **merged** into the engine-wide pages (`development/ebitengine`, `development/love`, `development/tic80`): a single page holds the engine intro, the Makefile docs and the CI pipeline.
- The `tic80pro-dockerfile` repo no longer has a standalone `builder-image` page; the TIC-80 Pro builder image (`git.teletypegames.org/build/tic80pro`) is documented in the pipeline/export section of the TIC-80 page.
- For the `impostor` repo, the developer doc is the `projects/impostor` page (tree) (fact sheet: git repo, Redmine, Woodpecker + subordinate howto/design pages); there is also a Neumatronic Universe **lore page**: `projects/neumatronic-universe/arcs/norman-arc/games/01-definitely-not-an-impostor`.
- For `impostor-bbs`, the wiki page is still the NU lore page (Game 1.5), not classic repo documentation.
- For the `sermo-bbs` repo (rubbs-based SERMO-DOS telnet simulator), the related page is the Sermo OS Showcase design/lore doc (its sibling page is `scratchpad/sermo-os2`), not classic repo documentation.
- The `media/nokiapunk` folder contains real reference photos for the Nokia-Punk page (Apple II, ThinkPad, Nokia Communicator, etc.); the page references these devices.
- The `teletypegames` repo is a monorepo (`apps/api`: Rails 8 Catalog API + ActiveAdmin, `apps/frontend`: Vue 3 SPA), described by the `infrastructure/public-site` page.
- The former page of the `blog-writer` repo (`others/blog-writer`) is **gone** — it currently has no wiki page.
- The project pages of the `c64-demo`, `rabbitc64`, `rabbitroller` and `blessingofra` repos were created on 2026-07-28 (fact sheet + overview + controls + build, in the format of the `impostor`/`realworld` pages). The project pages are login-protected and also appear in the sidebar's Projects section (`config/sitenav.yaml`).
- The `c64-tools` repo is documented by the `development/c64` page (ACME + VICE toolchain, shared Makefile, CI pipeline) — following the engine pages' pattern; the page also links to the three C64 projects.
- `rabbitc64` is the C64 port of `rabbitroller`; both have their own project pages with cross-references.
- The `wiki-pages` repo (the wiki itself: Grav + fetcher + BBS front-end) documents itself on the `infrastructure/wiki-site` page.
- The `tools/warp_engine` repo (in `repos.list`, 2026-08-04) is a **read-only split mirror**: development happens in the `teletypegames` monorepo (`libs/ruby/warp_engine`), CI republishes the mirror on every change. The `infrastructure/warp-engine` page documents the engine as a standalone product (mountable Rails engine: catalog, CI-callable updater, JSON API, optional ActiveAdmin); the monorepo itself remains documented by `infrastructure/public-site`.
- The Batocera store (2026-08-10) was split in two on 2026-08-15: `warp-engine-batocera-store` is the reusable engine (the former `tools/batocera-store` repo, renamed), and `ttg-batocera-store` is our store on top of it — a `config.json` plus a wrapper installer. Each has its own page, and the old `others/batocera-store` page became `others/ttg-batocera-store` (id 233 kept); the engine page is new (id 235). Each has its own page in the sidebar's Stores section — see below. The engine speaks the WarpEngine API, so `infrastructure/warp-engine` is the catalog-side counterpart of both. The RetroArch store joined them on 2026-08-17 with the same two-repo shape and a shared core (`engines/warpstore`), and on 2026-08-18 all four repos moved from `tools` to their own `stores` org, the four wiki pages with them: `pages/others/<slug>` → `pages/stores/<slug>`, with a `Stores` sidebar section of its own and a Grav redirect per page in `config/site.yaml`, so the old `/others/...` URLs still resolve. The sidebar lists only the two **engines** plus `All stores`: our own two stores are configs on top of them, and the `/stores` section index (`child_index: true`) lists all four, so nothing is out of reach.
- The `bevy-tools` / `bevy-demo` and `phaser-tools` / `phaser-demo` repos (2026-07-31) are documented by the engine-wide `development/bevy` and `development/phaser` pages — the demos have no separate project pages, following the inkwell/inkwell-demo pattern. Both pages appear in the sidebar's Development section (`config/sitenav.yaml`).
- `demos/ebitengine-demo` is a borderline case: the `development/bevy` and `development/phaser` pages reference it ("the same demo"), and it is also the example project of the `development/ebitengine` page (`ebitenginedemo`), but that page has no reference-project section presenting the demo like the bevy/phaser pages do.
- The `games/nyuller` repo was cloned from Gitea (`games/nyuller`) on 2026-08-01; it has no wiki page.
- **Folders without a wiki page** (not in the table): `devarea`; `bbs/` — none; `demos/escoria-demo-game-main`, `demos/love-demo`, `demos/new-game-wireframe`; `engines/gorpg`; `games/bombexpert`, `games/c64-demo-cpp`, `games/mranderson`, `games/nyuller`, `games/pong`, `games/trickster-tiles`; `media/impostor-info`; `services/blog-writer`, `services/redmine-tree`, `services/social-updater`; `tools/tic80-draw-image`, `tools/ttg-marketplace`; and `teletype-orbit`, a local repo that has no remote yet.
Reference in New Issue View Git Blame Copy Permalink