132 lines
7.3 KiB
Markdown
132 lines
7.3 KiB
Markdown
|
|
# Projekt-Hinweise: RPG Westreiche
|
|||
|
|
|
|||
|
|
## FTP-Zugang (Deployment)
|
|||
|
|
|
|||
|
|
Zugangsdaten stehen in `credentials.txt` im Projektwurzelverzeichnis (per
|
|||
|
|
`.gitignore` ausgeschlossen, niemals committen).
|
|||
|
|
|
|||
|
|
- **Methode:** explizites FTPS – also klassisches `ftp://` auf Port 21 mit
|
|||
|
|
erzwungener TLS-Aushandlung (`--ssl-reqd` / `AUTH TLS`).
|
|||
|
|
- **Nicht verwenden:** unverschlüsseltes FTP (Server antwortet
|
|||
|
|
`550 SSL/TLS required on the control channel`) und implizites FTPS
|
|||
|
|
(`ftps://` auf Port 990 – läuft in einen Timeout).
|
|||
|
|
- **Host:** `FTP_URL` aus `credentials.txt` (z. B. `www19.your-server.de`),
|
|||
|
|
Login `FTP_USER`, Passwort `FTP_PASSWORD`.
|
|||
|
|
|
|||
|
|
### Upload-Befehl
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
set -a; . ./credentials.txt; set +a
|
|||
|
|
|
|||
|
|
# Verzeichnis listen
|
|||
|
|
curl -s -S --ssl-reqd --user "$FTP_USER:$FTP_PASSWORD" \
|
|||
|
|
"ftp://$FTP_URL/" --list-only
|
|||
|
|
|
|||
|
|
# Einzelne Datei hochladen
|
|||
|
|
curl -s -S --ssl-reqd --user "$FTP_USER:$FTP_PASSWORD" \
|
|||
|
|
-T lokal/datei.html "ftp://$FTP_URL/public_html/datei.html"
|
|||
|
|
|
|||
|
|
# Verzeichnis rekursiv hochladen
|
|||
|
|
curl -s -S --ssl-reqd --user "$FTP_USER:$FTP_PASSWORD" \
|
|||
|
|
-T ./lokal/ "ftp://$FTP_URL/public_html/"
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
Beim rekursiven Upload keine abschließende Slash-Verwechslung: `-T ./dir/`
|
|||
|
|
lädt den Inhalt von `dir/` in das Zielverzeichnis.
|
|||
|
|
|
|||
|
|
### Server-Struktur (Wurzelverzeichnis)
|
|||
|
|
|
|||
|
|
`public_html`, `westreiche`, `www_logs`, `tippspiel_backup`, `vmail`,
|
|||
|
|
`.phpversion`, `.tmp`.
|
|||
|
|
|
|||
|
|
## Website (zauberturm.de)
|
|||
|
|
|
|||
|
|
Statischer Auftritt, aus dem Vault generiert:
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
python3 tools/build_site.py # baut web/ (Startseite, Galerie, Protokolle, Regel-Changelog)
|
|||
|
|
./tools/deploy_web.sh # Upload nach public_html/ per FTPS
|
|||
|
|
./tools/deploy_web.sh --dry-run # nur zeigen, was hochgeht
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
- `web/index.php` – Startseite mit beiden Projekten (aktuell nur Westreiche + Regel-Changelog)
|
|||
|
|
- `web/weltenauge.php` – Bildergalerie, liest serverseitig `public_html/weltenauge/`.
|
|||
|
|
**Ruht seit 20.11.2026:** Schalter `SHOW_WELTENAUGE = False` in
|
|||
|
|
`tools/build_site.py` → Seite wird nicht gebaut, Nav-Punkt und Startseiten-Karte
|
|||
|
|
entfallen, Footer sagt nur „Westreiche“. Zum Wiederbeleben: Schalter auf `True`,
|
|||
|
|
bauen, deployen (das Deploy-Skript lädt die Seite dann automatisch mit).
|
|||
|
|
Der Bilderordner `public_html/weltenauge/` bleibt auf dem Server unberührt,
|
|||
|
|
`public_html/weltenauge.php` wurde gelöscht (FTP `DELE`). Zusätzlich liegt dort
|
|||
|
|
eine `.htaccess` mit `Require all denied` – Bilder sind auch per Direkt-URL
|
|||
|
|
**403** (vorher 200, also direkt verlinkbar). Zum Reaktivieren: `.htaccess`
|
|||
|
|
löschen, dann `SHOW_WELTENAUGE = True` setzen.
|
|||
|
|
- `web/westreiche/index.html` + `protokolle/*.html` – **nur die Protokolle**;
|
|||
|
|
`(Notizen)`-Dateien sind per `PUBLISH_KINDS` in `tools/build_site.py`
|
|||
|
|
ausgeschlossen (Spieltisch-Notizen bleiben im Vault).
|
|||
|
|
`PUBLISH_KINDS` steht auf `{"Geschehnisse"}`: Notizen und ältere
|
|||
|
|
Kurzprotokolle (`Protokoll Sitzung #N.md`) werden nicht veröffentlicht, weil
|
|||
|
|
sie redundant zu den Geschehnissen sind.
|
|||
|
|
- `web/westreiche/regeln.html` – **datiertes Changelog aller Hausregel-Änderungen**
|
|||
|
|
(Nav-Punkt „Regeln"). Quelle ist
|
|||
|
|
`RPG/5-Regeln/Hausregeln/Regeländerungen (Changelog).md`;
|
|||
|
|
`build_regeln()` in `tools/build_site.py` rendert sie, neueste Einträge oben.
|
|||
|
|
**Achtung:** Diese Datei ist eine **Spieler-Übersicht** – wenige, offizielle Einträge. Neue Einträge **nur mit ausdrücklicher Zustimmung des SL**; Arbeitsstände und Details gehören in die jeweilige Hausregeldatei, nicht hierher (Format im Kopf der Datei:
|
|||
|
|
Datum + Betrifft/Vorher/Jetzt/Warum/Am Tisch, Zeilen nicht umbrechen), damit
|
|||
|
|
Website und Vault nicht auseinanderlaufen.
|
|||
|
|
- `web/assets/style.css`, `web/assets/logo_zauberturm.png` (per fal.ai erzeugt)
|
|||
|
|
|
|||
|
|
Hochgeladen wird ausschließlich `web/`; Bilder im Galerieordner werden nie
|
|||
|
|
überschrieben. Alte `index.php` liegt als `index.php.alt` auf dem Server,
|
|||
|
|
der frühere Bildordner `image_log/` wurde nach `weltenauge/` umbenannt.
|
|||
|
|
FTP-Rename braucht absolute Pfade (`RNFR /public_html/...`).
|
|||
|
|
|
|||
|
|
## Wissenslandkarte
|
|||
|
|
|
|||
|
|
Schnellzugriff auf Spieler, Welt, Regeln und Konventionen:
|
|||
|
|
**`.pi/wissensindex.md`** – bei Fragen zu Figuren, Fraktionen, Hausregeln oder
|
|||
|
|
Dateistruktur zuerst dort nachsehen, statt den Vault zu durchsuchen.
|
|||
|
|
Wichtige Einstiege: `RPG/2-Spieler/` (je ein Ordner pro Spieler),
|
|||
|
|
`RPG/1-Sessions/Geschehnisse-Index.md`, `RPG/3-Welt/Weltstatus & Offene Enden.md`,
|
|||
|
|
`RPG/5-Regeln/Hausregeln/` (vorrangig vor SRD), `RPG/offene_faeden.md`.
|
|||
|
|
|
|||
|
|
## Tooling
|
|||
|
|
|
|||
|
|
- `tools/md2odt.sh`, `tools/make_reference_odt.py`, `tools/autowidth.lua`:
|
|||
|
|
Markdown → ODT-Konvertierung für Druckmaterial.
|
|||
|
|
- `tools/build_zauber_almanach.py`: erzeugt das PDF-Handout
|
|||
|
|
`RPG/7-Prep/prep_2026-11-20/Arkane Zaubersprueche - Summarium von Rambastulon.pdf`
|
|||
|
|
(Titelblatt, Vorwort, Gildenregeln, Zauber nach Grad, Kurzreferenz) direkt aus
|
|||
|
|
`RPG/5-Regeln/Zauber/Arkan/Grad */*.md`. Braucht `reportlab`
|
|||
|
|
(`python3 -m venv .venv && .venv/bin/pip install reportlab`, ohne pandoc).
|
|||
|
|
- `tools/build_liturgie_summarium.py`: klerikales Gegenstück – erzeugt
|
|||
|
|
`RPG/7-Prep/prep_2026-11-20/Goettliche Liturgien - Summarium fuer Terian.pdf` (Titelblatt,
|
|||
|
|
Vorwort von Vater Damian, Hausregeln aus `Liturgien und Glaubensgemeinschaften`,
|
|||
|
|
Liturgien nach Grad mit „Gelehrt von“, Kurzreferenz, Anhang Naturzirkel).
|
|||
|
|
- `tools/build_sl_tabellen.py`: SL-Handout zum Ausdrucken
|
|||
|
|
(`RPG/7-Prep/prep_2026-11-20/SL-Tabellen - Ausbrennen und Entrueckung.pdf`, A4; mit `--a5` als Heftchen nach
|
|||
|
|
`RPG/7-Prep/prep_2026-11-20/pdf_export/SL-Tabellen - Ausbrennen und Entrueckung (A5).pdf`) – liest die Burnout-Tabelle
|
|||
|
|
aus `RPG/3-Welt/Geheimnisse/Es gibt kein unbegrenztes Zaubern.md` und die Entrückungstabelle
|
|||
|
|
aus `Liturgien und Glaubensgemeinschaften` §9. **SL-Wissen, nie veröffentlichen.**
|
|||
|
|
- `tools/build_sl_schirm.py`: baut den verdeckten **SL-Schirm** (A5 quer, 8 Karten:
|
|||
|
|
Fraktionen, offene Fäden als „Uhren“, NSC-Register, Gruppenstatus, Hausregeln,
|
|||
|
|
Improvisationshilfen, Kalender, Reveal-Warteschlange) nach
|
|||
|
|
`RPG/7-Prep/<prep>/SL Schirm/SL-Schirm (A5 quer).pdf`. **Inhalt und Layout sind
|
|||
|
|
getrennt:** die Karten stehen als Markdown in `SL Schirm/SL-Schirm Inhalt.md`
|
|||
|
|
(`## Karte …` = eine Seite, `farbe:` = Farbcode, Pipe-Tabellen + Stichpunkte;
|
|||
|
|
Frontmatter `titel`/`untertitel`/`ingame` – `ingame` steht im Kopf jeder Seite).
|
|||
|
|
Für eine neue Prep-Session die Markdown-Datei kopieren, aktualisieren und
|
|||
|
|
`build_sl_schirm.py -s … -o …` neu bauen – das Skript muss dafür nicht angepasst
|
|||
|
|
werden. Ebenfalls SL-Wissen.
|
|||
|
|
- `tools/pdf_sync.py`: hält die **ausgelagerten Fremd-PDFs** (Regelwerke, Abenteuer,
|
|||
|
|
Magazine, ~1 GB) synchron. Sie liegen nicht in Git, sondern auf dem Server unter
|
|||
|
|
`pdf_archiv/blobs/<sha256>.pdf` – **außerhalb von `public_html`**, also für Crawler
|
|||
|
|
unerreichbar. `tools/pdf_manifest.json` (Pfad → SHA-256 + Größe) ist versioniert und
|
|||
|
|
lädt einen frischen Checkout nach: `--pull`; hochladen: `--push`; prüfen: `--check`;
|
|||
|
|
Manifest neu schreiben: `--scan`. Auf dem Server liegt zusätzlich `pdf_archiv/index.json`
|
|||
|
|
(dieselbe Tabelle), damit das Archiv auch ohne Repo lesbar bleibt. Eigene Handouts
|
|||
|
|
(Summarien, SL-Tabellen, SL-Schirm) bleiben bewusst in Git.
|
|||
|
|
- `tools/add_guild_notes.py` / `tools/add_gemeinschaft_notes.py`: schreiben die
|
|||
|
|
Zugangs-Abschnitte (`## Gilde` bzw. `## Gemeinschaft`) in die Zauberdateien –
|
|||
|
|
inkl. Sonderlehrstätten (`Tote erwecken` & Co., Hausregel §3.5). Nach Änderung
|
|||
|
|
der MAPPING-Tabellen `--force` laufen lassen und das PDF neu bauen.
|