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

13 KiB
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