Neuinitialisierung ohne den PDF-Ballast (Regelwerke/Abenteuer/Magazine liegen auf dem Server, siehe tools/pdf_sync.py und tools/pdf_manifest.json). Vorherige Historie bewusst verworfen.
7.3 KiB
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_URLauscredentials.txt(z. B.www19.your-server.de), LoginFTP_USER, PasswortFTP_PASSWORD.
Upload-Befehl
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:
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 serverseitigpublic_html/weltenauge/. Ruht seit 20.11.2026: SchalterSHOW_WELTENAUGE = Falseintools/build_site.py→ Seite wird nicht gebaut, Nav-Punkt und Startseiten-Karte entfallen, Footer sagt nur „Westreiche“. Zum Wiederbeleben: Schalter aufTrue, bauen, deployen (das Deploy-Skript lädt die Seite dann automatisch mit). Der Bilderordnerpublic_html/weltenauge/bleibt auf dem Server unberührt,public_html/weltenauge.phpwurde gelöscht (FTPDELE). Zusätzlich liegt dort eine.htaccessmitRequire all denied– Bilder sind auch per Direkt-URL 403 (vorher 200, also direkt verlinkbar). Zum Reaktivieren:.htaccesslöschen, dannSHOW_WELTENAUGE = Truesetzen.web/westreiche/index.html+protokolle/*.html– nur die Protokolle;(Notizen)-Dateien sind perPUBLISH_KINDSintools/build_site.pyausgeschlossen (Spieltisch-Notizen bleiben im Vault).PUBLISH_KINDSsteht 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 istRPG/5-Regeln/Hausregeln/Regeländerungen (Changelog).md;build_regeln()intools/build_site.pyrendert 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-HandoutRPG/7-Prep/prep_2026-11-20/Arkane Zaubersprueche - Summarium von Rambastulon.pdf(Titelblatt, Vorwort, Gildenregeln, Zauber nach Grad, Kurzreferenz) direkt ausRPG/5-Regeln/Zauber/Arkan/Grad */*.md. Brauchtreportlab(python3 -m venv .venv && .venv/bin/pip install reportlab, ohne pandoc).tools/build_liturgie_summarium.py: klerikales Gegenstück – erzeugtRPG/7-Prep/prep_2026-11-20/Goettliche Liturgien - Summarium fuer Terian.pdf(Titelblatt, Vorwort von Vater Damian, Hausregeln ausLiturgien 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--a5als Heftchen nachRPG/7-Prep/prep_2026-11-20/pdf_export/SL-Tabellen - Ausbrennen und Entrueckung (A5).pdf) – liest die Burnout-Tabelle ausRPG/3-Welt/Geheimnisse/Es gibt kein unbegrenztes Zaubern.mdund die Entrückungstabelle ausLiturgien 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) nachRPG/7-Prep/<prep>/SL Schirm/SL-Schirm (A5 quer).pdf. Inhalt und Layout sind getrennt: die Karten stehen als Markdown inSL Schirm/SL-Schirm Inhalt.md(## Karte …= eine Seite,farbe:= Farbcode, Pipe-Tabellen + Stichpunkte; Frontmattertitel/untertitel/ingame–ingamesteht im Kopf jeder Seite). Für eine neue Prep-Session die Markdown-Datei kopieren, aktualisieren undbuild_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 unterpdf_archiv/blobs/<sha256>.pdf– außerhalb vonpublic_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ätzlichpdf_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 (## Gildebzw.## Gemeinschaft) in die Zauberdateien – inkl. Sonderlehrstätten (Tote erwecken& Co., Hausregel §3.5). Nach Änderung der MAPPING-Tabellen--forcelaufen lassen und das PDF neu bauen.