Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen angezeigt.

--- minikurse:dokuwiki_on_a_stick:lektion_3 [2025/06/29 15:33] – [📁 Lektion 3: Ordnerstruktur & Webserver starten] strangelove
+++ minikurse:dokuwiki_on_a_stick:lektion_3 [2025/06/29 16:39] (aktuell) – strangelove
@@ Zeile 1: / Zeile 1: @@
 ====== Lektion 3: Ordnerstruktur & Webserver starten ======
-<wrap lo>Jetzt geht’s richtig los: In dieser Lektion starten wir den integrierten Webserver auf dem USB-Stick und rufen dein DokuWiki im Browser auf. Danach bist du bereit für die Installation.</wrap>
+<wrap lo>Jetzt geht’s richtig los: In dieser Lektion starten wir den integrierten Webserver auf dem USB-Stick und rufen dein DokuWiki im Browser auf. Danach bist du bereit für die Erstinstallation.</wrap>
 ----
@@ Zeile 7: / Zeile 7: @@
 ===== 1. Überblick: Ordner nach dem Entpacken =====
-Wenn du die „on-a-stick“-Version entpackt hast, solltest du folgende Ordner und Dateien auf deinem USB-Stick sehen:
+Nach dem Entpacken des offiziellen DokuWiki-Pakets für Windows findest du im Zielverzeichnis (z. B. `Downloads` oder direkt auf dem USB-Stick) folgende Struktur:
-  * **dokuwiki\\** → Die eigentlichen DokuWiki-Dateien
+  * **server** → Der integrierte Apache2 Mini-Webserver mit PHP
-  * **apache\\** → Ein vorkonfigurierter Mini-Webserver (MicroApache)
+  * **dokuwiki** → Das eigentliche DokuWiki-System
-  * **php\\** → Eine portable PHP-Laufzeitumgebung
+  * **run.cmd** → Die Startdatei, um Webserver und Wiki gemeinsam zu starten
-  * **dokuwiki-on-a-stick.cmd** → Die Startdatei für Windows-Nutzer
-→ Wenn du doppelt auf `dokuwiki-on-a-stick.cmd` klickst, startet der Webserver automatisch.
+<wrap tip>Diese Struktur ist speziell für den portablen Einsatz unter Windows vorkonfiguriert.</wrap>
 ----
@@ Zeile 20: / Zeile 19: @@
 ===== 2. Lokalen Webserver starten =====
-<wrap tip>Wichtig: Stelle sicher, dass keine andere Software bereits Port 8800 blockiert (z. B. Skype, XAMPP).</wrap>
+So startest du dein Wiki lokal im Browser:
-So startest du dein Wiki:
+  * Doppelklicke auf die Datei **`run.cmd`**
+  * Es öffnet sich ein schwarzes Terminalfenster (Kommandozeile) mit dem Apache-Startprotokoll
+  * Öffne nun deinen Browser (z. B. Chrome oder Firefox)
+  * Gib in die Adresszeile ein:
-  * Doppelklick auf `dokuwiki-on-a-stick.cmd`
+→ **http://127.0.0.1:8800/install.php**
-  * Es öffnet sich ein kleines Kommandozeilen-Fenster mit dem Apache-Startprotokoll
-  * Öffne dann deinen Browser und gib ein:
+Dort startet der DokuWiki-Installationsassistent.
-    **http://127.0.0.1:8800/install.php**
+<wrap round tip>
+Falls der Port 8800 bereits von einer anderen Anwendung verwendet wird, kannst du ihn in der Konfiguration im `server\conf\httpd.conf` ändern.
+</wrap>
+----
+===== 3. DokuWiki einrichten: Schritt für Schritt =====
+<wrap hi>Folgende Felder solltest du ausfüllen:</wrap>
+  * **Wiki-Name** – z. B. „Mein USB-Wiki“ oder „Offline Notizen“
+  * **Admin-Benutzername** – z. B. `admin`
+  * **Passwort + Wiederholung** – ein sicheres Kennwort wählen!
+  * **E-Mail-Adresse** – optional (für Passwort-Reset)
+  * **Sprache** – z. B. `Deutsch`
+Du kannst auch Optionen wie Open Registration (Benutzer dürfen sich selbst registrieren) deaktivieren, da du vermutlich allein mit dem Stick arbeitest.
+Dann klickst du auf:
+→ **Installation starten**
 ----
-===== 3. Fehlermeldungen? Das kannst du tun: =====
+===== 4. Fehlermeldungen? Das kannst du tun: =====
 <wrap hi>
-Wenn das Startfenster sofort wieder geschlossen wird:
+Wenn das Startfenster sofort wieder geschlossen wird oder nichts passiert:
 </wrap>
-  * Mit Rechtsklick → „Als Administrator ausführen“ versuchen
+  * Rechtsklick auf `run.cmd` → „Als Administrator ausführen“
-  * Prüfen, ob dein USB-Stick Schreibrechte hat
+  * Stelle sicher, dass dein USB-Stick **Schreibrechte** hat
-  * Testweise auf den Desktop entpacken
+  * Starte testweise vom **lokalen Laufwerk** (z. B. Desktop)
+  * Antivirenprogramm kann blockieren – Ausnahmeregel prüfen
-<wrap warning>Hinweis: Diese portable Version läuft nur unter **Windows**!</wrap>
+<wrap warning>Wichtig: Diese portable Version funktioniert nur unter **Windows**!</wrap>
-Für Linux- oder macOS-Nutzer gibt es alternative Wege (z. B. portable Server wie USBWebserver oder eigene LAMP-Konfiguration).
+Für macOS oder Linux sind eigene Installationswege notwendig, z. B. über lokale Webserver wie MAMP oder XAMPP.
 ----
-===== 4. Was passiert beim ersten Aufruf? =====
+===== 5. Was passiert beim ersten Aufruf? =====
-Wenn alles geklappt hat, öffnet sich jetzt die Seite:
+Wenn alles funktioniert, öffnet sich im Browser automatisch die Seite:
 → **install.php**
-Hier beginnt die Erstinstallation von DokuWiki – mehr dazu in der nächsten Lektion!
+Hier beginnt die einmalige Einrichtung deines DokuWikis.
+Mehr dazu erfährst du in der nächsten Lektion.
-→ [[minikurse:dokuwiki_usb:lektion_04|Weiter zu Lektion 4]]
+→ [[minikurse:dokuwiki_usb:lektion_04|Weiter zu Lektion 4: DokuWiki installieren]]
 ----
-{{tag>minikurs dokuwiki usb lektion_03 webserver start ordnerstruktur}}
+{{tag>minikurs dokuwiki usb lektion_03 ordnerstruktur webserver start run.cmd windows}}