Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen angezeigt.

--- minikurse:raspberry:dokuwiki_basis:lektionen:lektion_04 [2025/06/23 00:29] – strangelove
+++ minikurse:raspberry:dokuwiki_basis:lektionen:lektion_04 [2025/06/23 23:19] (aktuell) – [DokuWiki herunterladen und vorbereiten] strangelove
@@ Zeile 3: / Zeile 3: @@
 <WRAP round info 90% center>
 Ziel dieser Lektion:
-Du installierst DokuWiki im Standard-Webverzeichnis von Apache und richtest es vollständig im Browser ein.
+Du installierst DokuWiki lokal auf deinem Raspberry Pi, richtest die ersten Einstellungen ein und behebst typische Einsteigerfehler.
 </WRAP>
-===== Schritt 1 – DokuWiki herunterladen =====
+===== DokuWiki herunterladen und vorbereiten =====
-Lade dir DokuWiki auf deinem Hauptrechner herunter:
+  - Rufe https://download.dokuwiki.org auf
+  - Lade die aktuelle Stable-Version als `.tgz`-Datei herunter
+  - Entpacke den Inhalt lokal auf deinem Rechner (z. B. `dokuwiki-2024-XX-XX`)
+===== Dateien auf den Raspberry Pi übertragen =====
-  * Besuche: https://download.dokuwiki.org
+Nutze FileZilla (SFTP), um die entpackten Dateien auf den Pi zu übertragen.
-  * Wähle die **aktuelle Stable-Version (.tgz)**
-  * Entpacke die Datei → z. B. in `dokuwiki-20xx-xx-xx/`
-===== Schritt 2 – Dateien mit FileZilla übertragen =====
+Verbindungsdaten:
-Verbinde dich per **SFTP** mit dem Raspberry Pi:
 ^ Einstellung       ^ Wert                         ^
@@ Zeile 25: / Zeile 24: @@
 | Port              | 22                           |
-→ Navigiere auf dem Raspberry Pi zu: `/var/www/html`
+So gehst du vor:
-→ Lösche ggf. vorhandene Dateien wie `index.html`
-→ Ziehe den **Inhalt** des entpackten DokuWiki-Ordners in dieses Verzeichnis
-===== Schritt 3 – Dateiberechtigungen korrekt setzen =====
+  * Verbinde dich per SFTP mit deinem Pi
+  * Wechsle in das Verzeichnis: `/var/www/html`
+  * Lösche ggf. vorhandene `index.html`
+  * Übertrage den gesamten Inhalt des lokalen `dokuwiki-…`-Ordners nach `/var/www/html`
-Damit Apache DokuWiki ausführen kann und du **gleichzeitig mit FileZilla Dateien löschen oder bearbeiten kannst**, müssen die Dateirechte korrekt gesetzt werden:
+<WRAP round tip 85%>
+Hinweis zur Nutzung von FileZilla:
+Falls du beim Löschen oder Überschreiben von Dateien Probleme bekommst, kannst du den Besitz des Zielverzeichnisses vorübergehend an den Benutzer `pi` übergeben – so lassen sich Änderungen via SFTP komfortabler vornehmen:
 <code bash>
 sudo chown -R pi:www-data /var/www/html
-sudo chmod -R 775 /var/www/html
+sudo chmod -R 755 /var/www/html
 </code>
-→ Damit gehört das Webverzeichnis dem Benutzer `pi`, der es bearbeiten darf
+Nach dem Upload solltest du die Dateiberechtigungen wieder korrekt setzen (siehe nächster Abschnitt).
-→ Die Gruppe `www-data` erlaubt Apache, auf das Wiki zuzugreifen
+</WRAP>
-💡 Wenn du DokuWiki später regelmäßig per FileZilla bearbeiten willst, ist diese Variante besonders praktisch.
+===== Dateiberechtigungen korrekt setzen =====
-→ Zusätzlich kann Apache durch die Gruppenrechte (`775`) auf alles zugreifen, ohne dass du auf Sicherheitsfunktionen verzichten musst.
+Damit DokuWiki korrekt funktioniert:
-===== Schritt 4 – DokuWiki im Browser installieren =====
+<code bash>
+sudo chown -R www-data:www-data /var/www/html
+sudo find /var/www/html -type d -exec chmod 755 {} \;
+sudo find /var/www/html -type f -exec chmod 644 {} \;
+</code>
-Öffne auf deinem Hauptrechner den Browser und gib ein:
+→ Apache hat jetzt vollständige Rechte, und alle Dateien sind korrekt lesbar/ausführbar.
-  * http://raspberrypi.local/install.php
+<WRAP info 90%>
-  * oder: http://192.168.X.X/install.php (ersetze X durch deine IP)
+🔍 **Was bedeuten 755 und 644 bei `chmod`?**
-→ Du solltest nun das Installationsformular sehen.
+Diese Zahlen sind sogenannte **numerische Dateiberechtigungen**, bei denen jede Ziffer für die Rechte einer Benutzergruppe steht:
-===== Schritt 5 – Konfiguration abschließen =====
+  * Erste Ziffer → **Besitzer**
+  * Zweite Ziffer → **Gruppe**
+  * Dritte Ziffer → **Alle anderen**
-Trage im Formular ein:
+Die Ziffern stehen für:
-  * Wiki-Titel: z. B. „Mein Pi-Wiki“
+  * `7` = Lesen (4) + Schreiben (2) + Ausführen (1) → volle Rechte
-  * Admin-Benutzername & Passwort
+  * `5` = Lesen (4) + Ausführen (1)
-  * E-Mail (optional)
+  * `4` = Lesen (4)
-  * Sprache: Deutsch
-  * Lizenz: „Keine Lizenz“ oder „Creative Commons“
-  * ACL aktivieren: ✅
-→ Klicke auf **„Speichern“**
+**Beispiele:**
-===== Schritt 6 – Wiki testen =====
+  * `755` = Besitzer darf alles, Gruppe & andere dürfen lesen + ausführen
+  * `644` = Besitzer darf lesen + schreiben, Gruppe & andere dürfen nur lesen
-Nach der Installation:
+So stellst du sicher, dass z. B. HTML/PHP-Dateien korrekt ausgeführt und gelesen werden können, aber nicht jeder diese ändern darf.
+</WRAP>
-  * Startseite: http://raspberrypi.local/doku.php?id=start
+===== DokuWiki im Browser installieren =====
-  * Adminbereich: http://raspberrypi.local/doku.php?do=admin
+Öffne den Browser auf deinem Rechner:
+- `http://raspberrypi.local/install.php`
+- oder direkt per IP: `http://192.168.X.X/install.php`
+→ Es erscheint das Installationsformular von DokuWiki.
+===== Konfiguration im Web-Installer =====
+Trage folgende Informationen ein:
+  * **Wiki-Titel**: z. B. „Mein Pi-Wiki“
+  * **Admin-Benutzername** und **Passwort**
+  * **E-Mail-Adresse**: optional bei lokalem Einsatz
+  * **Sprache**: Deutsch
+  * **Lizenz**: „Privat“ oder „Creative Commons“
+  * **ACL aktivieren**: Haken setzen
+Dann auf **„Speichern“** klicken.
+===== Funktion prüfen =====
+- Startseite: `http://raspberrypi.local/doku.php?id=start`
+- Adminbereich: `http://raspberrypi.local/doku.php?do=admin`
+→ DokuWiki sollte jetzt betriebsbereit sein.
+===== Fehler: Setup Error (datadir/pages fehlt) =====
+Wenn du folgenden Fehler siehst:
+> The datadir ('pages') is not found, isn't accessible or writable.
+Dann:
+- Überprüfe, ob du **den gesamten Ordner** (inkl. `data`, `conf`, `lib`) übertragen hast
+- Setze die Berechtigungen nochmals korrekt (siehe oben)
+===== Fehler: xml_parser_create fehlt =====
+Wenn diese Fehlermeldung erscheint:
+> Call to undefined function xml_parser_create()
+→ Die PHP-XML-Erweiterung fehlt. Installiere sie mit:
+<code bash>
+sudo apt update
+sudo apt install php-xml
+sudo systemctl restart apache2
+</code>
 ===== Was du jetzt kannst =====
 <WRAP round important 90% center>
-– DokuWiki korrekt im Standard-Webverzeichnis installiert
+  * DokuWiki vollständig auf dem Pi installieren und einrichten
-– Dateien per FileZilla übertragen und verwaltet
+  * Dateiberechtigungen korrekt setzen
-– Rechte so gesetzt, dass Apache UND du Zugriff haben
+  * Typische Fehler wie 403 oder Setup-Fehler lösen
-– Browserbasierte Einrichtung abgeschlossen
+  * Apache mit PHP-XML für DokuWiki konfigurieren
 </WRAP>
 ===== Nächste Schritte =====
-→ [[minikurse:raspberry:dokuwiki_basis:lektionen:lektion_05|Lektion 5 – Zugriff im lokalen Netzwerk]]
+→ [[minikurse:raspberry:dokuwiki_basis:lektionen:lektion_05|Lektion 5 – Zugriff im lokalen Netzwerk (WLAN/LAN)]]
 ----