# Wiki-Setup für Gitea Die Wiki-Dokumentation ist bereits im Repository unter `wiki/` verfügbar. ## Option 1: Gitea Wiki aktivieren (Empfohlen) 1. Gehen Sie zu Ihrem Repository in Gitea: ``` https://backoffice.userman.de/MediaMetz/customer-installer ``` 2. Klicken Sie auf **Settings** (Einstellungen) 3. Unter **Features** aktivieren Sie: - ☑ **Wiki** (Enable Wiki) 4. Klicken Sie auf **Update Settings** 5. Gehen Sie zum **Wiki**-Tab in Ihrem Repository 6. Klicken Sie auf **New Page** und erstellen Sie die erste Seite "Home" 7. Kopieren Sie den Inhalt aus `wiki/Home.md` 8. Wiederholen Sie dies für alle Wiki-Seiten: - Home.md - Installation.md - Credentials-Management.md - Testing.md - Architecture.md - Troubleshooting.md - FAQ.md ## Option 2: Wiki via Git klonen und pushen Nachdem das Wiki in Gitea aktiviert wurde: ```bash # Wiki-Repository klonen git clone ssh://backoffice.userman.de:2223/MediaMetz/customer-installer.wiki.git # In Wiki-Verzeichnis wechseln cd customer-installer.wiki # Wiki-Dateien kopieren cp /root/customer-installer/wiki/*.md . # Dateien hinzufügen git add *.md # Commit git commit -m "Add comprehensive wiki documentation" # Push git push origin master ``` ## Option 3: Direkt im Gitea Web-Interface 1. Gehen Sie zu: https://backoffice.userman.de/MediaMetz/customer-installer/wiki 2. Klicken Sie auf **New Page** 3. Für jede Seite: - Seitenname eingeben (z.B. "Home", "Installation", etc.) - Inhalt aus entsprechender .md-Datei kopieren - Speichern ## Wiki-Seiten-Übersicht Die folgenden Seiten sollten erstellt werden: 1. **Home** (`wiki/Home.md`) - Wiki-Startseite mit Navigation - System-Übersicht - Schnellstart 2. **Installation** (`wiki/Installation.md`) - Installations-Anleitung - Parameter-Dokumentation - Post-Installation 3. **Credentials-Management** (`wiki/Credentials-Management.md`) - Credentials-Verwaltung - Update-Workflows - Sicherheit 4. **Testing** (`wiki/Testing.md`) - Test-Suites - Test-Durchführung - Erweiterte Tests 5. **Architecture** (`wiki/Architecture.md`) - System-Architektur - Komponenten - Datenfluss 6. **Troubleshooting** (`wiki/Troubleshooting.md`) - Problemlösung - Häufige Fehler - Diagnose-Tools 7. **FAQ** (`wiki/FAQ.md`) - Häufig gestellte Fragen - Antworten mit Beispielen ## Automatisches Setup-Script Alternativ können Sie dieses Script verwenden (nachdem Wiki in Gitea aktiviert wurde): ```bash #!/bin/bash # setup-wiki.sh WIKI_DIR="/tmp/customer-installer.wiki" SOURCE_DIR="/root/customer-installer/wiki" # Wiki klonen git clone ssh://backoffice.userman.de:2223/MediaMetz/customer-installer.wiki.git "$WIKI_DIR" # In Wiki-Verzeichnis wechseln cd "$WIKI_DIR" # Wiki-Dateien kopieren cp "$SOURCE_DIR"/*.md . # Git-Konfiguration git config user.name "Customer Installer" git config user.email "admin@userman.de" # Dateien hinzufügen git add *.md # Commit git commit -m "Add comprehensive wiki documentation - Add Home page with navigation - Add Installation guide - Add Credentials-Management documentation - Add Testing guide - Add Architecture documentation - Add Troubleshooting guide - Add FAQ Total: 7 pages, 2800+ lines of documentation" # Push git push origin master echo "Wiki successfully uploaded!" ``` ## Hinweise - Das Wiki verwendet Markdown-Format - Interne Links funktionieren automatisch (z.B. `[Installation](Installation.md)`) - Bilder können im Wiki-Repository gespeichert werden - Das Wiki hat ein separates Git-Repository ## Support Bei Problemen: 1. Prüfen Sie, ob das Wiki in den Repository-Settings aktiviert ist 2. Prüfen Sie SSH-Zugriff: `ssh -T git@backoffice.userman.de -p 2223` 3. Prüfen Sie Berechtigungen im Repository --- **Alle Wiki-Dateien sind bereits im Repository unter `wiki/` verfügbar und können direkt verwendet werden!**