docs(readme): unify workspace table and German structure with gregFramework

Made-with: Cursor
This commit is contained in:
Marvin
2026-04-10 02:04:08 +02:00
parent cfaa5550d4
commit 66b8446d19

View File

@@ -1,74 +1,63 @@
# gregWiki # gregWiki
Docusaurus site for **gregFramework** / Data Center modding: configuration (`docusaurus.config.js`, `sidebars.js`), React under `src/`, content under [`docs/`](./docs/). Published route base path: **`/wiki`**. Docusaurus-Site für **gregFramework** / Data-Center-Modding: `docusaurus.config.js`, `sidebars.js`, React unter `src/`, Inhalte unter [`docs/`](./docs/). Öffentliche Route-Basis: **`/wiki`**.
--- | | |
|:---|:---|
| **Im Workspace** | Pfad `gregFramework/gregWiki/`. Überblick: [gregFramework README](../README.md). |
| **Remote** | [`mleem97/gregWiki`](https://github.com/mleem97/gregWiki) |
## Part of gregFramework ## Lokale Entwicklung
This directory is part of the **[gregFramework](https://github.com/mleem97/gregFramework)** workspace. Clone sibling repositories side by side so each project lives at `gregFramework/<RepoName>/`. See the workspace [README](https://github.com/mleem97/gregFramework/blob/master/README.md) for the full layout and migration notes.
**Remote:** [`mleem97/gregWiki`](https://github.com/mleem97/gregWiki) — on-disk path: `gregFramework/gregWiki/`.
---
## Local development
```bash ```bash
npm install npm install
npm run start npm run start
``` ```
Production build: Produktions-Build:
```bash ```bash
npm run build npm run build
``` ```
Optional: mirror the legacy GitHub Wiki — see [`docs/getting-started/documentation-layout.md`](./docs/getting-started/documentation-layout.md) and scripts `wiki:sync` / `wiki:normalize-i18n`. Optional: Legacy-GitHub-Wiki spiegeln — siehe [`docs/getting-started/documentation-layout.md`](./docs/getting-started/documentation-layout.md) und Skripte `wiki:sync` / `wiki:normalize-i18n`.
---
## Deployment (Coolify / CI) ## Deployment (Coolify / CI)
- **Default branch:** `main`use this for new work and PRs. - **Standard-Branch:** `main`für neue Arbeit und PRs.
- **`master`:** may still exist for older deployments; in Coolify, set the branch to **`main`** when possible. - **`master`:** kann für ältere Deployments parallel existieren; in Coolify den Branch auf **`main`** stellen, wenn möglich.
### Coolify (Dockerfile) — missing `/app/package.json` ### Coolify (Dockerfile) — `/app/package.json` fehlt
The image expects **`package.json` at the image root `/app`**. That only works if the **Docker build context** is this repository (gregWiki), not a parent monorepo folder without adjustments. Das Image erwartet **`package.json` im Image-Root `/app`**. Das passt nur, wenn der **Docker-Build-Kontext** dieses Repo (gregWiki) ist — nicht ein übergeordneter Monorepo-Ordner ohne Anpassung.
| Setting | Value | | Einstellung | Wert |
|---------|--------| |-------------|------|
| **Dockerfile** | `Dockerfile` at the gregWiki root | | **Dockerfile** | `Dockerfile` im gregWiki-Root |
| **Base directory** | **`.`** when only `gregWiki` is cloned. If gregWiki sits **next to** gregCore in the same clone, often set **`gregWiki`** as the subdirectory. | | **Base directory** | **`.`**, wenn nur `gregWiki` geklont wird. Liegt gregWiki **neben** gregCore im gleichen Clone, oft **`gregWiki`** als Unterverzeichnis setzen. |
| **Volumes** | Do not use an empty host mount over `/app` that hides `package.json`. | | **Volumina** | Kein leerer Host-Mount über `/app`, der `package.json` verdeckt. |
Symptom: `docker-entrypoint: ERROR: /app/package.json not found`wrong context or volume. Symptom: `docker-entrypoint: ERROR: /app/package.json not found`falscher Kontext oder Volume.
--- ## Docker (lokal)
## Docker (local) Build-Kontext = **dieses** Repository (Ordner mit `package.json`):
Build context = **this** repository (folder that contains `package.json`):
```bash ```bash
cd path/to/gregWiki cd path/to/gregWiki
docker compose up --build docker compose up --build
``` ```
If gregWiki lives inside **gregFramework**, from the workspace root: Liegt gregWiki in **gregFramework**, alternativ vom Workspace aus:
```bash ```bash
cd path/to/gregFramework cd path/to/gregFramework
docker compose -f docker-compose.gregwiki.yml up --build docker compose -f docker-compose.gregwiki.yml up --build
``` ```
(`docker-compose.gregwiki.yml` sets `build.context: ./gregWiki`.) (`docker-compose.gregwiki.yml` setzt `build.context: ./gregWiki`.)
--- ## Siehe auch
## See also - [gregFramework README](../README.md) — flaches Layout `gregFramework/{RepoName}/`
- Quellcode und Builds: **gregCore**, `gregMod.*`, `gregExt.*` als eigene Repos (nicht nur diese Doku)
- [gregFramework README](../README.md) — flat layout `gregFramework/{RepoName}/`
- Source code and builds: **gregCore**, **gregMod.*** , **gregExt.*** as separate repositories (not only this documentation)