170 lines
3.8 KiB
Markdown
170 lines
3.8 KiB
Markdown
|
|
# 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!**
|