A Teletype Games wikije telneten: élőben böngészi ezt a wikit a JSON API-ján át, az oldalakat lapozható, kereshető BBS-menükbe rendezi. Szupervizor-belépéssel a privát oldalak is megnyílnak.
Elérhető:
teletypegames.org:2325, böngészőben a bbsweb-en, és a TTG Gate BBS-en át
Ruby alkalmazás a rubbs gemre építve, mint a Teletype BBS. A bbs/ttg-bbs boards/wiki mappája, a wikit az interstack hálózaton olvassa. Egy porton két arca van. A hívás a rubbs Rubbs::Common::Call::Terminal kérdésével indul: a board legfeljebb 1,5 másodpercig várja a telnetválaszokat, és a 40 oszlopnál szélesebb ablak modern terminál; a 40 oszlop vagy a válasz hiánya (a WiFi-modem mögötti C64 sima TCP-t beszél) Commodore-nak számít. Az 1 a modern arcot, a 2 a C64-et választja, a RETURN elfogadja a tippet.
Teljes képernyős, Norton Commander-stílusú kétpaneles böngésző: balra az oldalfa (útvonal-mélység szerint behúzva), jobbra a kiválasztott oldal ANSI-markdownként. A böngésző maximalizálva nyílik; az F5 / Alt-Enter ablakká alakítja és vissza.
| Billentyű | Művelet |
|---|---|
| Fel / Le | Oldal választása (a jobb panel újratöltődik) |
| Tab | A fókusz az olvasópanelre |
| PgUp / PgDn / Home / End | Az olvasó görgetése |
| F2 | A böngésző újranyitása |
| F5 / Alt-Enter | Ablak / teljes képernyő |
| F8 | A wiki-index frissítése (az oldal-cache-t is üríti) |
| F10 | Menüsor |
| Alt-X / Esc | Kilépés / ablak bezárása |
A *-gal jelölt oldalak privátok (a wikin belépéshez kötöttek); a Wiki > Supervisor login feloldja őket, ugyanez a menüpont zárja vissza. Az egér is működik (xterm SGR), a görgővel együtt.
PETSCII 40×25-ön. Ugyanaz az oldalfa, képernyőnként egy szint, a rubbs számozott kurzoros menüjeként (Rubbs::Common::Screens::Selector): az aloldalas oldal jele >, a privát oldalé *. A CRSR mozgatja a sávot (balra-jobbra lapoz), a beírt szám kijelöl egy oldalt, a RETURN megnyitja vagy egy szinttel lejjebb visz, a Q (vagy ←) visszalép. Egy oldal képernyőnként jelenik meg (RETURN: tovább, Q: vissza), a végén a nyilvános címével. A legfelső szinten az S a szupervizor-belépés, az R újraolvassa az indexet.
A wiki két végpontja (sablonok a themes/ttgwiki2/templates/*.json.twig-ben, oldalak a pages/custom/-ban):
GET /custom/sitemap.json — minden routolható oldal: route, title, modified, updatedAt, tags és private (igaz, ha az oldalnak vagy egy ősének access: site.login van a frontmatterében). Törzs nélkül.GET /custom/page.json?route=/platforms/tic80 — egy oldal a markdown-jával és a html-jével. Privát oldalhoz a wiki SUPERVISOR_PASSWORD-jével egyező token= kell, különben a válasz {"error": "forbidden"}; ismeretlen útvonalra {"error": "not_found"}.Az oldalindex induláskor egyszer töltődik be, és minden munkamenet közösen használja; az F8 (C64-en R) mindenkinek újraolvassa. Ha induláskor a wiki nem válaszol (egy stack-deploy a Gravot is újraindítja), a board akkor is elindul, és 10 másodpercenként újrapróbálja az indexet. Az oldaltörzsek 5 percig cache-ben maradnak.
A zárat a wiki oldala kényszeríti ki: a Grav entrypointja a SUPERVISOR_PASSWORD-öt a site configjába teszi, és a JSON API egyező token nélkül nem adja ki a privát törzseket. A board a WIKI_BBS_SUPERVISOR_PASSWORD-öt küldi tokenként, ezért a kettőnek egyeznie kell; a compose egy változóból köti be mindkettőt.
| Változó | Alapérték | Mire való |
|---|---|---|
BBS_PORT |
2323 |
Telnetport (a boards.yml 2325-öt állít, a konténerben is) |
BBS_MAX_SESSIONS |
100 |
Egyszerre hány hívó (a boards.yml 50-et állít) |
BBS_IDLE |
900 |
Tétlenségi bontás, másodpercben |
WIKI_BBS_URL |
http://localhost:9120 |
A wiki alap-URL-je (a szerveren http://wiki-grav az interstack hálózaton) |
WIKI_BBS_SUPERVISOR_PASSWORD |
üres | Feloldja a privát oldalakat, és API-tokenként megy a wikinek; üresen zárva maradnak |
A kód a házi szerkezetet követi: lib/domain/ (PageModel, WikiRepository, WikiService, SupervisorService, és a WikiBBS, a környezetet olvasó kompozíciós gyökér) és lib/ui/ (UI::Modern, a kétpaneles böngésző; UI::Petscii a Browser-ével). A teljes leírás a repó README-je.
Jelvények. Fiókkal ez a board a hálózat közös jelvényein túl ezekbe számít: Scholar (10, 50, 200 elolvasott oldal).
A bbs/ttg-bbs boards/wiki mappájaként fut, a közös ttg-bbs konténerben; az adatai a /srv/stacks/ttg-bbs/boards/wiki/data-ban vannak, és a deployok között megmaradnak. A bbs/ttg-bbs masterére pusholt változást a Woodpecker élesíti (ci-deploy ttg-bbs); ha csak a boards/wiki változott, csak ez a board indul újra. A naplósorai a docker logs ttg-bbs-ben vannak, "board":"wiki-bbs" címkével. A Grav-ot http://wiki-grav néven éri el, ez a wiki konténerének neve az interstack-en. A többi board a BBS-hálózat oldalon van.