mirror of https://github.com/mleem97/gregWiki.git synced 2026-04-10 19:19:18 +02:00

Files

Marvin e2839584f4 Merge Docusaurus site: all content under docs/, align with gregFramework split layout

- Move markdown and wiki-import tree into docs/; keep app shell at repo root
- Point docusaurus docs path to docs/; edit links to mleem97/gregWiki
- Sync and i18n scripts use gregWiki root and ../.wiki under gregFramework
- Sidebars: workspace layout from root docs ids; plugins under mods/extensions
- Fix redirects, module catalog URLs, release note paths, and wiki-import category keys
- Update repo inventory for split repos; Dockerfile for single-repo context

Made-with: Cursor

2026-04-09 23:39:32 +02:00

3.4 KiB

Raw Blame History

Documentation layout (`docs/`)

This folder is the single source of truth for the public Docusaurus site. The Docusaurus app lives in the repository root next to docs/; built pages are served under the /wiki base path.

How content is organized

Area	Path	Purpose
Landing	`intro.md`	Site home (`/wiki/docs`).
Curated topics	`topics/`	Hubs: Rollen (Spieler, Moddevs, Contributor, Sponsoren → `audiences/overview`), Roadmap, Security, Wiki-Import.
Mods & plugins	`mods/`	Framework, plugin wiki, mod wiki, standalone index.
Releases	`releases/`	Per-artifact release notes.
Reference	`reference/`	Hooks, naming, MCP, generated catalogs.
Contributors	`contributors/`	Repo layout, Docusaurus workflow, design system.
Audiences	`audiences/`	Newbies / intermediates / professionals.
Roadmap	`roadmap/`	Planning docs.
Meta	`meta/`	Workshop, devserver, backlog.
Monorepo wiki stubs	`wiki/`	Short pages tied to the target repo layout (e.g. Hexmod). Not the GitHub Wiki import.
Legacy GitHub Wiki import	`wiki-import/`	Bulk import from `.wiki/` (see below).

Legacy GitHub Wiki (`docs/wiki-import/`)

Long-form pages that originally lived in the GitHub Wiki are mirrored here so they are searchable and versioned with the repo.

Clone or update the wiki working tree next to this repo as ../.wiki/ under the parent gregFramework/ folder (separate clone: https://github.com/<org>/<repo>.wiki.git), or set up the same path the sync script expects.
From the gregWiki repository root, refresh the mirror and split locales:
- npm run wiki:refresh
- Or stepwise: npm run wiki:sync → npm run wiki:normalize-i18n (optional --dry-run first).
German translations for paired pages live under i18n/de/docusaurus-plugin-content-docs/current/wiki-import/ after normalization.
New curated docs should usually be added as normal Markdown under docs/ (topics, reference, mods), not only under wiki-import/, so they stay easy to find. Use wiki-import/ for bulk legacy material and incremental fixes; migrate important pages into docs/topics/ or docs/reference/ when you rewrite them.

Details: topics/wiki-import/overview.md.

URLs

Doc id intro → /wiki/docs (see front matter).
Most docs → /wiki/<doc-path> (e.g. mods/framework → /wiki/mods/framework).
The monorepo stub folder uses ids like wiki/mods/hexmod → /wiki/wiki/mods/hexmod (double wiki in the path). Prefer linking by doc id or stable titles rather than hand-typing URLs.

Scripts (repository root)

Script	Location	Role
Sync `../.wiki` → `docs/wiki-import/`	`scripts/sync-wiki-to-docs.mjs`	Copies `*.md` from the sibling `.wiki/` clone under `gregFramework/`.
Split DE/EN pairs	`scripts/normalize-wiki-import-i18n.mjs`	EN default locale, DE under `i18n/de/...`.
Sidebar category keys	`scripts/write-wiki-import-category-keys.mjs`	Regenerates `_category_.json` keys under Guides/Reference/Troubleshooting (if present).

3.4 KiB Raw Blame History

Documentation layout (docs/)