dokuwiki
Unterschiede
Hier werden die Unterschiede zwischen zwei Versionen angezeigt.
| Beide Seiten der vorigen RevisionVorhergehende ÜberarbeitungNächste Überarbeitung | Vorhergehende Überarbeitung | ||
| dokuwiki [2023-04-09 01:22:49] – [FreeBSD 13.1] manfred | dokuwiki [2023-04-09 01:54:59] (aktuell) – [FreeBSD 13.1] manfred | ||
|---|---|---|---|
| Zeile 1: | Zeile 1: | ||
| + | ====== Wiki-Syntax ====== | ||
| + | |||
| + | * [[wiki: | ||
| + | |||
| + | | ||
| + | **Fetter Text** | ||
| + | | ||
| + | //Kursiver Text// | ||
| + | | ||
| + | < | ||
| + | | ||
| + | __Unterstrichener Text__ | ||
| + | | ||
| + | '' | ||
| + | | ||
| + | < | ||
| + | | ||
| + | ====== Level 1 Überschrift ====== | ||
| + | | ||
| + | ===== Level 2 Überschrift ===== | ||
| + | | ||
| + | ==== Level 3 Überschrift ==== | ||
| + | | ||
| + | === Level 4 Überschrift === | ||
| + | | ||
| + | == Level 5 Überschrift == | ||
| + | | ||
| + | [[Interner Link]] | ||
| + | | ||
| + | [[http:// | ||
| + | | ||
| + | - Nummerierter Listenpunkt | ||
| + | | ||
| + | * Listenpunkt | ||
| + | | ||
| + | ---- - waagerechter Strich | ||
| + | | ||
| + | {{bild.png|}} | ||
| + | | ||
| + | {{bild.png? | ||
| + | | ||
| + | {{dokument.pdf|}} | ||
| + | | ||
| + | {{testprogramm.exe|}} | ||
| + | |||
| + | |||
| + | Bild- und PDF-Dateien müssen direkt in das Verzeichnis /// | ||
| + | |||
| + | Dabei ist unbedingt auf den Dateinamen zu achten! | ||
| + | Der Dateiname darf nur aus kleinen Buchstaben, Zahlen und dem Unterstrich in einfacher Form bestehen. Zwei Unterstriche hintereinander stellen auch einen Ungültigen Dateinamensbestandteil dar! | ||
| + | |||
| + | |||
| + | ===== DokuWiki konfigurieren ===== | ||
| + | |||
| + | * [[http:// | ||
| + | * **[[https:// | ||
| + | |||
| + | Wenn man das [[http:// | ||
| + | > wget http:// | ||
| + | > tar xzf dokuwiki-d9556fbc2c1c07a0baaf81c07d4165f6.tgz | ||
| + | > mv dokuwiki/* / | ||
| + | > cd / | ||
| + | > for A in bin conf data inc lib vendor ; do chmod 0750 ${A} ; done | ||
| + | > for A in conf data inc lib vendor ; do chown www:0 ${A} ; done | ||
| + | |||
| + | > ls -lha | ||
| + | drwxr-xr-x | ||
| + | drwxr-xr-x | ||
| + | -rw-r--r-- | ||
| + | -rw-r--r-- | ||
| + | -rw-r--r-- | ||
| + | -rw-r--r-- | ||
| + | drwxr-x--- | ||
| + | drwxr-x--- | ||
| + | drwxr-x--- | ||
| + | -rw-r--r-- | ||
| + | -rw-r--r-- | ||
| + | drwxr-x--- | ||
| + | -rw-r--r-- | ||
| + | -rw-r--r-- | ||
| + | drwxr-x--- | ||
| + | drwxr-x--- | ||
| + | |||
| + | |||
| + | ==== Den Index neu bauen ==== | ||
| + | |||
| + | * [[https:// | ||
| + | * **[[http:// | ||
| + | |||
| + | FreeBSD: | ||
| + | > echo 'cd / | ||
| + | |||
| + | Debial / Ubuntu: | ||
| + | > su -c 'cd / | ||
| + | |||
| + | |||
| + | ==== Die Breite der Wiki-Seite ändern ==== | ||
| + | |||
| + | * [[https:// | ||
| + | |||
| + | > vi lib/ | ||
| + | ... | ||
| + | __site_width__ | ||
| + | ... | ||
| + | |||
| + | |||
| + | ====== DokuWiki sichern ====== | ||
| + | |||
| + | |||
| + | ===== Ubuntu Linux ===== | ||
| + | |||
| + | tar cf dokuwiki_sik.tar / | ||
| + | |||
| + | |||
| + | ===== FreeDSB ===== | ||
| + | |||
| + | tar cf dokuwiki_sik.tar / | ||
| + | |||
| + | |||
| + | ====== DokuWiki installieren ====== | ||
| + | |||
| + | ===== Ubuntu ===== | ||
| + | |||
| + | Installation und Konfiguration durch das Paketmanagement | ||
| + | |||
| + | aptitude install dokuwiki | ||
| + | /wiki | ||
| + | |||
| + | [*] apache2 | ||
| + | [*] apache-ssl | ||
| + | |||
| + | lokale Konfigurationsdatei erstellen | ||
| + | |||
| + | cp / | ||
| + | |||
| + | auf deutsch einstellen | ||
| + | |||
| + | vi / | ||
| + | |||
| + | $conf[' | ||
| + | |||
| + | damit es nicht nur lokal geht | ||
| + | |||
| + | vi / | ||
| + | |||
| + | #allow from 127.0.0.1 | ||
| + | allow from all | ||
| + | |||
| + | chown www-data: | ||
| + | |||
| + | Konfiguration im Browser | ||
| + | |||
| + | https:// | ||
| + | |||
| + | For security reasons this script will only work with a new and | ||
| + | unmodified Dokuwiki installation. You should either re-extract the files | ||
| + | from the downloaded package or consult the complete Dokuwiki | ||
| + | installation instructions | ||
| + | | ||
| + | * unrecognised or modified dokuwiki.php | ||
| + | (hash=9100fa9a18424bd097b5ab972d66412d) | ||
| + | * / | ||
| + | * / | ||
| + | * / | ||
| + | |||
| + | |||
| + | ---------------------------------------------------------- | ||
| + | |||
| + | Aufruf im Browser | ||
| + | |||
| + | https:// | ||
| + | |||
| + | |||
| + | ===== FreeBSD 12.2 ===== | ||
| + | |||
| + | Erstmal muss der Apache mit //mod_ssl// installiert werden: | ||
| + | |||
| + | portinstall -prO www/ | ||
| + | .... | ||
| + | [X] SSL | ||
| + | .... | ||
| + | |||
| + | Dann das Wiki: | ||
| + | |||
| + | portinstall -prO www/ | ||
| + | |||
| + | Jetzt machen wir dass wiki noch per //https// klar: | ||
| + | |||
| + | vi / | ||
| + | |||
| + | Include etc/ | ||
| + | | ||
| + | # http:// | ||
| + | AddType application/ | ||
| + | AddType application/ | ||
| + | # | ||
| + | DirectoryIndex index.php index.html | ||
| + | # | ||
| + | # echo ' | ||
| + | # kldload accf_http | ||
| + | | ||
| + | Alias /wiki "/ | ||
| + | | ||
| + | < | ||
| + | #Options Indexes FollowSymLinks | ||
| + | #Options Indexes | ||
| + | | ||
| + | # | ||
| + | # AllowOverride controls what directives may be placed in .htaccess files. | ||
| + | # It can be " | ||
| + | # | ||
| + | # | ||
| + | AllowOverride None | ||
| + | | ||
| + | # | ||
| + | # Controls who can get stuff from this server. | ||
| + | # | ||
| + | Order allow,deny | ||
| + | Allow from all | ||
| + | </ | ||
| + | |||
| + | Jetzt noch den apache neu starten: | ||
| + | |||
| + | # / | ||
| + | Performing sanity check on apache22 configuration: | ||
| + | Syntax OK | ||
| + | Stopping apache22. | ||
| + | Waiting for PIDS: 1117. | ||
| + | Performing sanity check on apache22 configuration: | ||
| + | Syntax OK | ||
| + | Starting apache22. | ||
| + | |||
| + | So, und jetzt kann das Wiki eingerichtet werden: | ||
| + | |||
| + | https:// | ||
| + | |||
| + | Aufruf im Browser | ||
| + | |||
| + | https:// | ||
| + | |||
| + | Ferti! | ||
| + | |||
| + | |||
| + | ==== DokuWiki-Mehrfach-Installation - trotzdem einfaches Update ==== | ||
| + | |||
| + | Ich lege meine Wiki's unter ''/ | ||
| + | / | ||
| + | / | ||
| + | / | ||
| + | |||
| + | Für das Update, die neueste Version von hier runter laden: | ||
| + | * [[http:// | ||
| + | |||
| + | Im Wiki-Verzeichnissen liegen praktisch nur die Wiki- und Zugangs-Daten. | ||
| + | Die Quell-Daten, | ||
| + | > tar xzf dokuwiki-5422200921b877a379e34cc4e0fee22a.tgz -C /home/http/ | ||
| + | |||
| + | Wir legen das Quell-Verzeichnis mit der Versionsnummer im Namen an, damit wir bei späteren Update-Vorgängen, | ||
| + | Das ist sinnvoll, um z.B. bei Problemen auf eine bestimmte oder wenigstens auf die letzte funktionierende Version zurück schalten zu können. | ||
| + | Das //zurück schalten// erfolgt durch den // | ||
| + | > cd /home/http/ | ||
| + | > mv dokuwiki dokuwiki-5422200921b877a379e34cc4e0fee22a | ||
| + | > ln -s dokuwiki-5422200921b877a379e34cc4e0fee22a dokuwiki | ||
| + | > ls -lha / | ||
| + | lrwxr-xr-x | ||
| + | |||
| + | __Es ist auch möglich, dieses Referenz-Verzeichnis an einer anderen stelle im Dateisystem abzulegen. | ||
| + | Das hätte dann auch den Vorteil, dass man dieses reine Referenz-Wiki nicht gezielt im Browser aufrufen kann.__ | ||
| + | |||
| + | === DokuWiki-Mehrfach-Installation === | ||
| + | |||
| + | > ls -lha / | ||
| + | total 156 | ||
| + | drwxr-xr-x | ||
| + | drwxr-xr-x | ||
| + | -rw-rw-r-- | ||
| + | -rw-rw-r-- | ||
| + | -rw-rw-r-- | ||
| + | -rw-rw-r-- | ||
| + | drwxr-xr-x | ||
| + | drwxr-xr-x | ||
| + | drwxr-xr-x | ||
| + | -rw-rw-r-- | ||
| + | -rw-rw-r-- | ||
| + | drwxr-xr-x | ||
| + | -rw-rw-r-- | ||
| + | -rw-rw-r-- | ||
| + | drwxr-xr-x | ||
| + | drwxr-xr-x | ||
| + | |||
| + | um die volle Breite im Wiki nutzen zu können, muss dieser Wert auf " | ||
| + | > vi / | ||
| + | ... | ||
| + | __site_width__ | ||
| + | ... | ||
| + | |||
| + | die Basis für mein erstes Wiki initial anlegen: | ||
| + | > cp -a / | ||
| + | > cd / | ||
| + | > rm -fr bin inc lib vendor | ||
| + | > mkdir bin inc lib vendor | ||
| + | |||
| + | die Basis für mein zweites Wiki initial anlegen: | ||
| + | > cp -a / | ||
| + | > cd / | ||
| + | > rm -fr bin inc lib vendor | ||
| + | > mkdir bin inc lib vendor | ||
| + | |||
| + | die Basis für mein drittes Wiki initial anlegen: | ||
| + | > cp -a / | ||
| + | > cd / | ||
| + | > rm -fr bin inc lib vendor | ||
| + | > mkdir bin inc lib vendor | ||
| + | |||
| + | zum Schluß löschen wir noch die Installationsdatei aus dem Original-Verzeichnis, | ||
| + | Sonst ist das ja keine Referenz mehr: | ||
| + | > rm -f / | ||
| + | |||
| + | Die meisten Verzeichnisse aus den Live-Wiki' | ||
| + | Mit Sym-Links funktioniert es nicht, dann werden die Media-Daten in das Originalverzeichnis geschrieben. | ||
| + | |||
| + | die Bind-Mount' | ||
| + | < | ||
| + | ... | ||
| + | # | ||
| + | ### DokuWiki' | ||
| + | ### Mit Sym-Links funktioniert es nicht, | ||
| + | ### dann werden die Media-Daten in das Originalverzeichnis geschrieben. | ||
| + | |||
| + | / | ||
| + | / | ||
| + | / | ||
| + | / | ||
| + | |||
| + | / | ||
| + | / | ||
| + | / | ||
| + | / | ||
| + | |||
| + | / | ||
| + | / | ||
| + | / | ||
| + | / | ||
| + | |||
| + | # | ||
| + | ... | ||
| + | </ | ||
| + | |||
| + | jetzt die Bind-Mount-Verzeichnisse mounten: | ||
| + | > mount / | ||
| + | > mount / | ||
| + | > mount / | ||
| + | > mount / | ||
| + | > mount / | ||
| + | > mount / | ||
| + | > mount / | ||
| + | > mount / | ||
| + | > mount / | ||
| + | > mount / | ||
| + | > mount / | ||
| + | > mount / | ||
| + | |||
| + | Das passiert ab jetzt bei jedem boot-Vorgang automatisch. | ||
| + | |||
| + | |||
| + | === / | ||
| + | |||
| + | hier nur den wesentlichen Ausschnitt (weil hier Passwörter eingegeben werden, sollte man nur '' | ||
| + | < | ||
| + | ... | ||
| + | Listen *:443 | ||
| + | |||
| + | AddType application/ | ||
| + | AddType application/ | ||
| + | |||
| + | SSLRandomSeed startup | ||
| + | SSLRandomSeed connect | ||
| + | SSLPassPhraseDialog | ||
| + | SSLSessionCache | ||
| + | SSLSessionCacheTimeout 300 | ||
| + | |||
| + | < | ||
| + | DocumentRoot "/ | ||
| + | ServerName www.domain.de | ||
| + | ServerAdmin fritz@domain.de | ||
| + | ErrorLog "/ | ||
| + | TransferLog "/ | ||
| + | # | ||
| + | ### ---------------- | ||
| + | # | ||
| + | ### Konfiguration fuer mod_ssl | ||
| + | SSLEngine on | ||
| + | SSLHonorCipherOrder On | ||
| + | SSLProtocol -ALL +TLSv1.2 | ||
| + | SSLProxyProtocol -ALL +TLSv1.2 | ||
| + | SSLCipherSuite TLSv1.2 | ||
| + | SSLProxyCipherSuite TLSv1.2 | ||
| + | SSLCertificateFile "/ | ||
| + | SSLCertificateKeyFile "/ | ||
| + | SSLOptions +FakeBasicAuth +ExportCertData +StrictRequire +StdEnvVars | ||
| + | SSLVerifyClient optional | ||
| + | # | ||
| + | SSLVerifyDepth | ||
| + | SSLOptions +OptRenegotiate | ||
| + | # | ||
| + | TraceEnable Off | ||
| + | # | ||
| + | ### ---------------- | ||
| + | # | ||
| + | BrowserMatch " | ||
| + | CustomLog "/ | ||
| + | </ | ||
| + | ... | ||
| + | </ | ||
| + | |||
| + | Jetzt kann man die drei Wiki's im Browser aufrufen: | ||
| + | https:// | ||
| + | https:// | ||
| + | https:// | ||
| + | |||
| + | |||
| + | ===== FreeBSD 13.1 ===== | ||
| + | |||
| + | <hidden / | ||
| + | <file bash / | ||
| + | #!/bin/sh | ||
| + | |||
| + | ################################################################ | ||
| + | # | ||
| + | # Dieses Skript " | ||
| + | # indem es alle Rechte so setzt, wie sie sein müssen. | ||
| + | # | ||
| + | ################################################################ | ||
| + | |||
| + | VERSION=" | ||
| + | |||
| + | ################################################################ | ||
| + | |||
| + | if [ x == " | ||
| + | then | ||
| + | echo " | ||
| + | exit 1 | ||
| + | fi | ||
| + | |||
| + | DOKUWIKI_DIR=" | ||
| + | |||
| + | ################################################################ | ||
| + | ### Rechte vom neuen Verzeichnis setzen | ||
| + | |||
| + | chown 0:80 " | ||
| + | chown 0:0 " | ||
| + | chown -R 0:80 " | ||
| + | # | ||
| + | for A in bin conf inc vendor | ||
| + | do | ||
| + | chmod 0750 " | ||
| + | done | ||
| + | # | ||
| + | for B in bin conf inc | ||
| + | do | ||
| + | chown -R 80:0 " | ||
| + | done | ||
| + | # | ||
| + | for C in Form lang parser | ||
| + | do | ||
| + | chown -R 0:0 " | ||
| + | done | ||
| + | # | ||
| + | chown 0:0 " | ||
| + | chmod 0775 " | ||
| + | # | ||
| + | for D in plugins tpl | ||
| + | do | ||
| + | chown -R 80:80 " | ||
| + | done | ||
| + | # | ||
| + | chmod 0770 " | ||
| + | chown -R 80:80 " | ||
| + | chown -R 80:80 " | ||
| + | </ | ||
| + | </ | ||
| + | ---- | ||
| + | |||
| + | > / | ||
| + | |||
| + | |||
| + | ==== Dokuwiki Update ==== | ||
| + | |||
| + | <hidden / | ||
| + | <file bash / | ||
| + | #!/bin/sh | ||
| + | |||
| + | VERSION=" | ||
| + | VERSION=" | ||
| + | |||
| + | ################################################################################ | ||
| + | |||
| + | OLD_DIR=" | ||
| + | |||
| + | BACKUP_DIR="/ | ||
| + | |||
| + | HTTP_DIR="/ | ||
| + | WIKI_INSTANCES=" | ||
| + | |||
| + | if [ x == " | ||
| + | then | ||
| + | echo " | ||
| + | exit 1 | ||
| + | fi | ||
| + | |||
| + | DOKUWIKI_DIR=" | ||
| + | |||
| + | test -d " | ||
| + | |||
| + | for WIKI in ${WIKI_INSTANCES} | ||
| + | do | ||
| + | WIKI_DIR=" | ||
| + | cd " | ||
| + | |||
| + | if [ -d " | ||
| + | then | ||
| + | DATE=" | ||
| + | ARCHIVE=" | ||
| + | mv " | ||
| + | echo "Found existing data backup, moved to ${ARCHIVE}" | ||
| + | fi | ||
| + | |||
| + | mv " | ||
| + | tar -czf " | ||
| + | $(ls \ | ||
| + | conf/ | ||
| + | conf/ | ||
| + | conf/ | ||
| + | conf/ | ||
| + | conf/ | ||
| + | conf/ | ||
| + | conf/ | ||
| + | conf/ | ||
| + | 2> /dev/null) | ||
| + | rm -fr " | ||
| + | cp -a " | ||
| + | |||
| + | rm -fr " | ||
| + | mv " | ||
| + | tar -xzf " | ||
| + | |||
| + | ######################################################## | ||
| + | ### Rechte vom neuen Verzeichnis setzen | ||
| + | |||
| + | / | ||
| + | |||
| + | ######################################################## | ||
| + | done | ||
| + | |||
| + | cd " | ||
| + | </ | ||
| + | </ | ||
| + | ---- | ||
| + | |||
| + | Den Wiki-Pfad (bzw. die Pfade) in dem Skript so setzen, wie er bei mir richtig ist: | ||
| + | > vi / | ||
| + | ... | ||
| + | HTTP_DIR="/ | ||
| + | WIKI_INSTANCES=" | ||
| + | ... | ||
| + | |||
| + | In diesem Beispiel wären es drei Wikis mit den folgenden Pfaden: | ||
| + | / | ||
| + | / | ||
| + | / | ||
| + | |||
| + | Das neueste [[https:// | ||
| + | |||
| + | ...auspacken | ||
| + | > tar xzvf dokuwiki-a6b3119b5d16cfdee29a855275c5759f.tgz | ||
| + | > ls -lha | ||
| + | total 546 | ||
| + | drwxr-xr-x | ||
| + | drwxrwxrwt | ||
| + | drwxr-xr-x | ||
| + | |||
| + | Update durchführen: | ||
| + | > / | ||
| + | |||
