Die lokale Offline-Option der Rocrail-Dokumentation für den Fall, dass am Standort der Modelleisenbahn kein Internet verfügbar ist.
Hinweis: Diese Dokumentation ist eine Momentaufnahme der Online-Dokumentation.

Es wird beschrieben, wie ein Ordner DokuWikiStick inkl. aller erforderlichen Komponenten für die Anwendung DokuWiki im Betriebssystem Windows erstellt wird.

Prinzipiell ist die Beschreibung auch auf andere Betriebssysteme anwendbar. Evtl. sind aber auf dieser Seite beschriebene Pfade und Ordner daran anzupassen und es ist ein anderer Webserver erforderlich.

Der Ordner DokuWikiStick kann auch, z.B. per USB-Stick, portabel auf anderen PCs mit gleichem Betriebssystem verwendet werden.

• Hinweise:
  • Der implementierte Webserver wird nur in der Windows 64bit-Version angeboten.
  • Das Rocrail-"Wiki ZIP Archive (Wiki Offline)" (siehe hier) ist ca. 1 GB groß,
    enthält die Wiki-Seiten und Medien in ca. 12.000 Dateien und ca. 400 Ordnern.
  • Das Extrahieren kann je nach PC-Performance mehr als 1 Std. dauern.
  • Der fertige Ordner DokuWikiStick mit "DokuWiki", Webserver und "Rorail-Wiki offline" ist ca. 1.1 GB groß

Der Abschnitt gilt nur für Windows; Für PiOS gehts hier weiter.

Für die Installation wird eine Download-Datei auf der Seite https://download.dokuwiki.org/ konfiguriert.
Auf dieser Seite Download DokuWiki sind folgende Optionen einzustellen:

• Im Abschnitt Include Web-Werver die Option "MicroApache (Windows 64bit)" aktivieren
• Im Abschnitt Languages: Mit der Schaltfläche "Toggle all" alle vorausgewählten Sprachen deaktivieren
  und dann wahlweise "de - Deutsch (Sie)", "de-informal - Deutsch (Du)" oder weitere aktivieren.
  Diese Beschreibung geht von einer der deutschen Sprach-Varianten aus.

Mit der Schaltfläche "Start Download" (am Seitenende) wird die Download-Datei generiert und heruntergeladen.

In der Download-Datei ist automatisch die Variante DokuWiki on a Stick mit integriertem Web-Server vorbereitet.
Das erspart die Installation und ggf. aufwendige Anpassungen eines anderen Web-Servers.
Siehe hier: https://www.dokuwiki.org/de:install:dokuwiki_on_a_stick

Die heruntergeladene tgz-Datei wird z.B. mit dem Progarmm Exprass ZIP ¹⁾ extrahiert, wobei der Ziel-Ordner DokuWikiStick automatisch angelegt wird.

Mit run.cmd im Ordner DokuWikiStick wird der im DokuWiki enthaltene Webserver gestartet, der dann die Einstellseite von DokuWiki öffnet.

Im Feld oben rechts der Einstellseite wird eine Sprache ausgewählt, die ggf. zuvor auf der Download-Seite aktiviert wurde,

• z.B.: "de-informal" (ggf. wechselt die Sprache der Seite automatisch)

Die Angaben in den Feldern links auf der Seite werden u.a. für die Admin-Anmeldung benötigt: (Ist später für weitere Einstellungen erforderlich)

• Wiki-Name > z.B. "Wiki offline"
  
• Benutzername des Administrators > exakte Angabe erforderlich
  
• Voller Name > es genügt ein Buchstabe
  
• E-Mail > es genügt "@"
  
• Passwort > exakte Angabe mit Wiederholung im nächsten Feld erforderlich
  

• Achtung:
  Keine weiteren Eingaben und Änderungen auf dieser Seite vornehmen.
  Benutzername und Passwort für die Admin-Anmeldung merken.

Mit der Schaltfläche "Speichern" (am Seitenende) die Einstellungen sichern und dann den Browser und den Webserver beenden.

Für PiOS hier weiter

Die heruntergeladene Datei RocrailDokuWiki (x).zip extrahieren. ( Das kann je nach PC-Performance 1 bis 2 Stdn. dauern. )

Im installierten Ordner DokuWikiStick/dokuwiki/data/ müssen die Sub-Ordner media und pages gelöscht werden.
Aus dem Ordner RocrailDokuWiki (x)/dokuwiki/data/ werden dann die Sub-Ordner media und pages in den Ordner DokuWikiStick/dokuwiki/data/ verschoben.

• Hinweise:
  • Das hier gewählte "Löschen" und "Verschieben" anstelle von "Kopieren" und "Überschreiben" verkürzt die benötigte Zeit erheblich
    und es stellt sicher, dass keine Dateien und Ordner verbleiben, die im Rocrail-Wiki nicht bzw. nicht mehr enthalten sind.
  • Für späteres Aktualisieren der Wiki-Daten sind nur die Schritte dieses Abschnitt zu wiederholen.

Durch Aufruf von run.cmd im Ordner DokuWikiStick wird der Webserver gestartet, der jetzt die lokale Startseite des Rocrail-Wiki öffnet.

Für die korrekte Darstellung und Funktion der in vielen Wiki-Seiten enthaltenen HTML- u. PHP-Syntax, Tabellen-Formatierungen usw. müssen noch spezifische Plugins installiert werden.

Dazu ist die Admin-Anmeldung erforderlich.
Über den Link Admin wird auf die Seite Administration gewechselt.

Mit dem Link Erweiterungen verwalten wird auf die entsprechende Seite und dort auf die Registerkarte Suchen und installieren gewechselt.

Im Feld Suche Erweiterung: wird jeweils der Suchbegriff eines Plugins eingeben und die Suche mit <ENTER> gestartet.
Die Suche kann viele Ergebnisse liefern, aus denen durch Scrollen oder Seitensuche des Browsers das exakt richtige Plugin gewählt wird:

• Achtung: Oft gibt es noch andere, ähnlich bezeichnete Plugins, die in dieser Konfiguration nicht korrekt funktionieren.

Mit der jeweils rechts stehenden Schaltfläche "Installieren" wird das Plugin installiert.
Bei erfolgreicher Installation erscheint auf grünem Hintergrund die Meldung: "Das Plugin xxxx wurde erfolgreich installiert"
Anschliessend wird wieder auf die Seite Administration zurückgekehrt.

Ggf. wieder als Admin anmelden und über den Link Admin auf die Seite Administration wechseln.

Der Link Konfiguration öffnet die Seite Konfigurations-Manager.
Im Abschnitt "Basis" können bei Bedarf "Wiki Titel", "Name der Startseite" u. "Sprache" geändert werden.
Neben der voreingestellten Startseite start, könnten aus dem Rocrail-Wiki auch start-de oder german als Startseiten interessant sein.
Anschließend über das Inhaltsverzeichnis zu Plugin → Htmlok navigieren.
Dort werden die beiden Optionen "htmlok" u. "phpok" aktiviert.
Nach den Änderungen muss die Seite über die Schaltfläche "Speichern" (am Seiteende) gespeichert und verlassen werden.

Der Link Einstellungen fürs Template-Design öffnet die Seite für diese empfohlenen Änderungen:

• "Breite der ganzen Seite …" = 100%
  
• "Breite der Seitenleiste …" = 15%
  

Mit Schaltfläche "Änderungen speichern" werden die Einstellungen beendet.

Das Rocrail-Wiki steht damit offline zur Verfügung, wie es vom online-Betrieb bekannt ist.

• Hinweis: In vielen Wiki-Seiten sind Internet-Links enthalten, die nur bei bestehender online-Verbindung ins Internet funktionieren.
  

Externer Zugriff unter PiOS