tools/devarea
4
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

translate to english

Browse Source
This commit is contained in:
mr.zero
2026-08-01 17:25:00 +02:00
parent 2237b4a180
commit b448592a20
8 changed files with 117 additions and 116 deletions
Download Patch File Download Diff File Expand all files Collapse all files
WIKI_CONNECTION.md
+24 -24
View File
@@ -1,12 +1,12 @@
# Wiki Connections
Azok a mappák (repók) ebben a workspace-ben, amelyekhez **már létezik** wiki oldal a `wiki-pages` mirrorban. A wiki **Grav CMS**-en fut, a tartalom sémája: `wiki-pages/pages/<út>/default.md`. A wiki bázis URL: `https://wiki.teletypegames.org/` (az oldalak belső linkjei alapján `/en/` előtag nélkül).
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 `wiki-pages/pages/<path>/default.md`. Wiki base URL: `https://wiki.teletypegames.org/` (without the `/en/` prefix, based on the pages' internal links).
A workspace 2026-08-01-én kategória-mappákba lett rendezve: `demos/`, `games/`, `media/`, `tools/`, `tools_bbs/`, `tools_build/`, `tools_libs/`, `archive/`; a `teletypegames`, a `wiki-pages` és a `devarea` a gyökérben van. A táblázat első oszlopa a workspace-relatív út.
The workspace was reorganized into category folders on 2026-08-01: `demos/`, `games/`, `media/`, `tools/`, `tools_bbs/`, `tools_build/`, `tools_libs/`, `archive/`; `teletypegames`, `wiki-pages` and `devarea` live in the root. The first column of the table is the workspace-relative path.
Ez a fájl a `devarea` repóban (`tools/devarea`) él. A repó `scripts/` mappájában vannak a workspace-kezelő scriptek (`clone-repos.sh` — a teljes workspace klónozása ebben a struktúrában a `repos.list` alapján; `check-repos.sh` — a lista összevetése a Gitea szerverrel; `install-tea.sh` — tea CLI telepítés), amelyeket a gyökérben lévő `Makefile` köt össze (`make help`). A táblázat útvonalai a workspace gyökeréhez (a `devarea` szülőmappájához) képest értendők.
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`).
| Mappa | Title | Wiki fájl | URL |
| Folder | Title | Wiki file | URL |
|---|---|---|---|
| `demos/bevy-demo` | Bevy | `wiki-pages/pages/development/bevy/default.md` | https://wiki.teletypegames.org/development/bevy |
| `demos/c64-demo` | Teletype Games C64 Demo | `wiki-pages/pages/projects/c64-demo/default.md` | https://wiki.teletypegames.org/projects/c64-demo |
@@ -37,24 +37,24 @@ Ez a fájl a `devarea` repóban (`tools/devarea`) él. A repó `scripts/` mappá
| `tools_libs/rubbs` | rubbs | `wiki-pages/pages/others/rubbs/default.md` | https://wiki.teletypegames.org/others/rubbs |
| `wiki-pages` | Wiki Site | `wiki-pages/pages/infrastructure/wiki-site/default.md` | https://wiki.teletypegames.org/infrastructure/wiki-site |
## Megjegyzések
## Notes
- **Struktúraváltás**: a korábbi Wiki.js mirror (`wiki-pages/wiki/<út>.md`) helyett a wiki most Grav CMS-en fut, `wiki-pages/pages/<út>/default.md` sémával. Az oldal wiki-útvonala a frontmatter `wikipath` mezőjében is szerepel.
- **pncdsl → inkwell átnevezés**: a korábbi `pncdsl` repó `inkwell` néven él tovább (`tools_libs/inkwell`), a `pncdsl-demo` pedig `inkwell-demo` néven (`demos/inkwell-demo`). A wiki oldal is átköltözött: `development/ebitengine/pncdsl` → `development/ebitengine/inkwell` (mindkét repót ugyanaz az oldal dokumentálja: framework-bemutató + companion demo).
- A `games/realworld` repóhoz a `projects/realworld` oldal(fa) a fejlesztői/projekt doksi (login-védett, aloldalak: catalog, entities, story); emellett létezik a NU lore-oldala is: `projects/neumatronic-universe/arcs/norman-arc/games/02-realworld`.
- A `*-tools` repók korábbi külön `pipeline.md` + `makefile.md` oldalai **beolvadtak** az engine-átfogó oldalakba (`development/ebitengine`, `development/love`, `development/tic80`): egy oldalon van az engine-bemutató, a Makefile-doksi és a CI pipeline.
- A `tic80pro-dockerfile` repónak nincs többé önálló `builder-image` oldala; a TIC-80 Pro builder image (`git.teletype.hu/internal/tic80pro`) a TIC-80 oldal pipeline/export szekciójában van dokumentálva.
- Az `impostor` repóhoz a fejlesztői doksi a `projects/impostor` oldal(fa) (adatlap: git repo, Redmine, Woodpecker + alávetett howto/design oldalak); emellett létezik a Neumatronic Universe **lore-oldala** is: `projects/neumatronic-universe/arcs/norman-arc/games/01-definitely-not-an-impostor`.
- Az `impostor-bbs` esetében a wiki oldal továbbra is a NU lore-oldal (Game 1.5), nem klasszikus repó-dokumentáció.
- A `sermo-bbs` repóhoz (rubbs-alapú SERMO-DOS telnet szimulátor) a kapcsolódó oldal a Sermo OS Showcase design-/lore-doksi (a testvéroldala a `scratchpad/sermo-os2`), nem klasszikus repó-dokumentáció.
- A `media/nokiapunk` mappa a Nokia-Punk oldalhoz tartozó valós referenciafotókat tartalmazza (Apple II, ThinkPad, Nokia Communicator stb.); az oldal ezekre az eszközökre hivatkozik.
- A `teletypegames` repo monorepo (`apps/api`: Rails 8 Catalog API + ActiveAdmin, `apps/frontend`: Vue 3 SPA), amelyet az `infrastructure/public-site` oldal ír le.
- A `blog-writer` repó korábbi oldala (`others/blog-writer`) **megszűnt** — jelenleg nincs hozzá wiki oldal.
- A `c64-demo`, `rabbitc64`, `rabbitroller` és `blessingofra` repók projekt oldalai 2026-07-28-án készültek (adatlap + ismertető + irányítás + build, az `impostor`/`realworld` oldalak formátumában). A projekt oldalak login-védettek, és a sidebar Projects szekciójában is szerepelnek (`config/sitenav.yaml`).
- A `c64-tools` repót a `development/c64` oldal dokumentálja (ACME + VICE toolchain, közös Makefile, CI pipeline) — az engine-oldalak mintájára; az oldal a három C64 projektre is linkel.
- A `rabbitc64` a `rabbitroller` C64 portja; mindkettőnek saját projekt oldala van, kereszthivatkozásokkal.
- A `wiki-pages` repó (maga a wiki: Grav + fetcher + BBS front-end) önmagát az `infrastructure/wiki-site` oldalon dokumentálja.
- A `bevy-tools` / `bevy-demo` és a `phaser-tools` / `phaser-demo` repókat (2026-07-31) az engine-átfogó `development/bevy`, ill. `development/phaser` oldalak dokumentálják — a demók külön projekt oldal nélkül, az inkwell/inkwell-demo mintájára. Mindkét oldal szerepel a sidebar Development szekciójában (`config/sitenav.yaml`).
- Az `demos/ebitengine-demo` határeset: a `development/bevy` és `development/phaser` oldalak hivatkoznak rá ("the same demo"), és a `development/ebitengine` oldal példaprojektje is (`ebitenginedemo`), de az oldalnak nincs a bevy/phaser oldalakéhoz hasonló, a demót bemutató reference-project szekciója.
- A `games/nyuller` repó 2026-08-01-én lett leklónozva a Giteáról (`games/nyuller`); wiki oldala nincs.
- **Wiki oldal nélküli mappák** (nem szerepelnek a táblázatban): `devarea`; `archive/mranderson`; `demos/c64-demo-cpp`, `demos/escoria-demo-game-main`, `demos/love-demo`, `demos/new-game-wireframe`, `demos/trickster-tiles`; `games/bombexpert`, `games/nyuller`, `games/pong`; `media/impostor-info`; `tools/blog-writer`, `tools/nginx-conf`, `tools/redmine-tree`, `tools/social-updater`, `tools/tic80-draw-image`, `tools/ttg-marketplace`; `tools_libs/gorpg`.
- **Structure change**: instead of the former Wiki.js mirror (`wiki-pages/wiki/<path>.md`), the wiki now runs on Grav CMS with the `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.teletype.hu/internal/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 `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`; `archive/mranderson`; `demos/c64-demo-cpp`, `demos/escoria-demo-game-main`, `demos/love-demo`, `demos/new-game-wireframe`, `demos/trickster-tiles`; `games/bombexpert`, `games/nyuller`, `games/pong`; `media/impostor-info`; `tools/blog-writer`, `tools/nginx-conf`, `tools/redmine-tree`, `tools/social-updater`, `tools/tic80-draw-image`, `tools/ttg-marketplace`; `tools_libs/gorpg`.