Follow the workspace and wiki reshuffle

The workspace folders now match the Gitea orgs one-to-one, so the note
that they deliberately differ no longer holds. wiki-pages sits under
infra/, and the wiki gained an engines/ section for our own engines and
libraries.

Also records that moving a wiki page means adding a redirect in
config/site.yaml, which is how the engine pages kept their old URLs
working.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
This commit is contained in:
2026-08-16 16:06:04 +02:00
co-authored by Claude Opus 5
parent 5ceff41668
commit bab8bacf33
2 changed files with 4 additions and 3 deletions
+2 -2
View File
@@ -35,13 +35,13 @@ A `private` a tartalom érzékenységéről szóljon, ne az orgról.
## 3. Nyilvántartásba vétel
- **`devarea/scripts/repos.list`** — új sor `<workspace-útvonal>|ssh://git@git.teletypegames.org:2222/<org>/<repo>` alakban, ábécérendben a blokkján belül. A workspace-mappa és az org **szándékosan nem azonos**: a mappák aszerint csoportosítanak, hogyan dolgozol rajtuk, az orgok aszerint, mi a repo.
- **`devarea/scripts/repos.list`** — új sor `<org>/<repo>|ssh://git@git.teletypegames.org:2222/<org>/<repo>` alakban, az org blokkjába, ábécérendben. A workspace-mappa 2026-08-16 óta **egy az egyben az org**, tehát az útvonal az orgból következik. Egyetlen kivétel a `devarea`, ami a gyökérben marad, mert a `clone-repos.sh` a szülőkönyvtárába klónoz.
- **`devarea/scripts/check-repos.sh`** — futtasd. Ha zöld, a lista fedi a szervert. Ez a lépés fogja el a „elkészült, de sehol nincs nyilvántartva" hibát.
- **`devarea/WIKI_CONNECTION.md`** — ha lesz wiki-oldala, új sor a táblázatba (`Folder`, `Org`, `Title`, `Wiki file`, `URL`). Ha nem lesz, vedd fel a „Folders without a wiki page" felsorolásba.
## 4. Wiki-oldal
Ha a repo dokumentálást érdemel, hozz létre `wiki-pages/pages/<szekció>/<repo>/default.md`-t. Szekció-választás a rendeltetés szerint: `development/` platformok, `infrastructure/` kiszolgáló, `others/` eszközök, `projects/` termékek.
Ha a repo dokumentálást érdemel, hozz létre `infra/wiki-pages/pages/<szekció>/<repo>/default.md`-t. Szekció-választás a rendeltetés szerint: `development/` platformok, `engines/` saját motorok és könyvtárak, `infrastructure/` kiszolgáló, `others/` eszközök, `projects/` termékek.
A frontmatter kötelező mezői: `title`, `visible`, `id`, `description`, `date`, `locale`, `repo`, `taxonomy.tag`. **Az `id` legyen egyedi** — ellenőrizd (`grep -rh "^id:" pages/ | sort | uniq -d`), a legnagyobb használt fölött adj újat. A `config/sitenav.yaml`-ba is kerüljön bejegyzés, ha a menüben a helye.
@@ -33,7 +33,7 @@ Ha a változás egy **mintát** érint, ami több repóban ismétlődik (pl. egy
## 3. Wiki — a `wiki-pages` repo
A wiki **Grav CMS**, a tartalom `wiki-pages/pages/<útvonal>/default.md`. Az oldal nem CMS-ben, hanem fájlban él, tehát szerkeszthető.
A wiki **Grav CMS**, a tartalom `infra/wiki-pages/pages/<útvonal>/default.md` (a repo neve `wiki-pages`, a workspace-ben az `infra/` alatt). Az oldal nem CMS-ben, hanem fájlban él, tehát szerkeszthető.
**Melyik oldal tartozik a repóhoz:** a `devarea/WIKI_CONNECTION.md` táblázata mondja meg (`Folder``Wiki file`). Ha nincs benne, vagy `grep -rl "<repo>" wiki-pages/pages/`.
@@ -42,6 +42,7 @@ Amire figyelj:
- **Frontmatter.** A `repo:` mező URL-je is elavulhat. Az `id` egyedi legyen (`grep -rh "^id:" pages/ | sort | uniq -d`).
- **Mindkét irány.** Ha egy oldal átnevezésre vagy kettévágásra kerül, a `config/sitenav.yaml` bejegyzését is vezesd át, és a **másik két célpontban** lévő wiki-linkeket is (a publikus oldal `CONFIG.wikiBase`-re épülő URL-jét is beleértve).
- **Nem csak `pages/`.** A `wiki-pages` repóban van `README.md`, `bbs/` (Gemfile is!), `fetcher/` — ezekben is lehet érintett hivatkozás.
- **Oldal áthelyezésekor** vedd fel a `config/site.yaml` `redirects:` térképébe a régi útvonalat, hogy a kimenő linkek és a könyvjelzők ne törjenek el.
- **Commit-konvenció.** A `wiki-pages` repónak saját `git-commit` skillje van, és a konvenciója szerint **nem kerül trailer az üzenetbe** (se `Co-Authored-By`, se generált aláírás). Kövesd.
## 4. Publikus oldal — a `teletypegames` repo