====== Installation und Konfiguration dieses Wikis ======

===== Voraussetzungen =====

  * Software: Debian 11, Apache2, modphp
  * Ein DNS Catchall für *.cybercowboy.de existiert

===== Installation Apache vhost =====

www-Verzeichnis herstellen:

<code bash>
sudo mkdir /var/www/finest-plastics
sudo chown kst:www-data /var/www/finest-plastics
sudo chmod 775 /var/www/finest-plastics
</code>

Apache2 vhost Konfigurationsdatei in /etc/apache2/sites-available/:

<file apache finest-plastics.cybercowboy.de-ssl.conf>
<IfModule mod_ssl.c>

  <VirtualHost *:443>
    ServerName finest-plastics.cybercowboy.de
    ServerAdmin tecneeq@tecneeq.de
    DocumentRoot /var/www/finest-plastics
    ErrorLog ${APACHE_LOG_DIR}/finest-plastics-error.log
    CustomLog ${APACHE_LOG_DIR}/finest-plastics-access.log combined

    SSLEngine on
    SSLProtocol all -SSLv3 -TLSv1 -TLSv1.1
    SSLCipherSuite "HIGH+EECDH:HIGH+EDH:!aNULL:!MD5:!3DES:!CAMELLIA:!AES128"
    #SSLRandomSeed startup file:/dev/urandom  1024
    #SSLRandomSeed connect builtin
    SSLCertificateFile /etc/letsencrypt/live/cybercowboy.de/fullchain.pem
    SSLCertificateKeyFile /etc/letsencrypt/live/cybercowboy.de/privkey.pem
    Header always set Strict-Transport-Security "max-age=31536000; includeSubDomains"

    <Directory ~ "/var/www/finest-plastics/(bin/|conf/|data/|inc/)">
      <IfModule mod_authz_core.c>
        AllowOverride All
        Require all denied
      </IfModule>
      <IfModule !mod_authz_core.c>
        Order allow,deny
        Deny from all
      </IfModule>
    </Directory>

    <FilesMatch "\.(cgi|shtml|phtml|php)$">
      SSLOptions +StdEnvVars
    </FilesMatch>

  </VirtualHost>

</IfModule>

# vim: syntax=apache ts=4 sw=4 sts=4 sr noet
</file>

Erhöhen des php-Uploadlimits auf 15MB:

<code>
echo 'upload_max_filesize = 15M
post_max_size = 15M' > /etc/php/7.4/apache2/conf.d/10-upload_filesize.ini
</code>

Aktivieren des vhost und reloaden der Apache Konfiguration:

<code bash>
sudo a2ensite finest-plastics.cybercowboy.de-ssl.conf
sudo systemctl reload apache2
</code>

===== Installation Dokuwiki =====

Als User kst:

<code bash>
cd /var/www/finest-plastics
wget https://raw.githubusercontent.com/splitbrain/dokuwiki-downloader/master/dokuwiki-downloader.php
</code>

Den Installer im Browser aufrufen, installieren, dann Dokuwiki konfigurieren:\\
https://finest-plastics.cybercowboy.de/dokuwiki-downloader.php

Die Datei dokuwiki-downloader.php löscht sich selbst.

===== Konfiguration Dokuwiki =====

==== Backups ====

Backupscript in $HOME/bin/ ablegen:

<code bash finest-plastics-backup.sh>
#!/bin/bash

mkdir -p /var/www/finest-plastics/backups $HOME/backups/finest-plastics-snaps

# public backup
tar -C /var/www -czf "/var/www/finest-plastics/backups/finest-plastics.tgz" finest-plastics/data/media finest-plastics/data/pages

# private backup
source="/var/www/finest-plastics/"
target="$HOME/backups/finest-plastics-snaps/"
today="$(date +%Y.%m.%d-%H:%M:%S)"
rsync -avR --delete --exclude="backups/*" --exclude="data/cache/*" --exclude="data/media_attic/*" --exclude="data/attic/*" "${source}"  "${target}${today}/" --link-dest="${target}-last/"
ln -nsf "${target}${today}" "${target}-last"
</code>

Backupscript ausführbar machen:

<code bash>
chmod +x $HOME/bin/finest-plastics-backup.sh
</code>

Cronjob als kst anlegen:

<code cron crontab>
14 2 * * * $HOME/bin/finest-plastics-backup.sh
</code>

==== Installierte Plugins und Themes ====

Plugins:

  * "**History Cleanup Plugin**" von Dominik Eckelmann. This plugin deletes consecutive history entrys that were made by the same user user within 1 hour.
  * "**comment**" von Gina Häußge, Michael Klier. Add comments/notes to your wiki source that won't be shown on the page.
  * "**dropfiles plugin**" von Michael Große. Allows to upload files by drang'n'drop into the editarea of a page.
  * "**Dw2Pdf plugin**" von Andreas Gohr and Luigi Micco. DokuWiki to PDF converter.
  * "**EditTable plugin**" von Andreas Gohr. Provide a custom editor for tables.
  * "**Faster Dokuwiki Plugin**" von Eli Fenton. Speed up DokuWiki with AJAX page loads, and inline previews and sectionedit.
  * "**Markdown Page Plugin**" von Mizunashi Mana. Write your own Markdown page.
  * "**Move plugin**" von Michael Hamann, Gary Owen, Arno Puschmann, Christoph Jähnigen. Move and rename pages and media files whilst maintaining the links.
  * "**orphanswanted plugin**" von Doug Edmunds, Cyrille37, Federico Ariel Castagnini, Andy Webber, Matthias Schulte. Display Orphans, Wanteds and Valid link tables.
  * "**Searchindex Manager**" von Andreas Gohr. Allows to rebuild the fulltext search index.
  * "**smtp plugin**" von Andreas Gohr. Send mails via a configured SMTP server.
  * "**ToDo**" von Leo Eibler, Christian Marg, Markus Gschwendt. Create a checkbox based todo list with optional user assignment (by using <todo>This is a ToDo</todo>). In combination with dokuwiki searchpattern plugin it is a lightweight task list management system.
  * "**upgrade Plugin**" von Andreas Gohr. Update your DokuWiki with a few clicks from the admin interface.

Themes:

  * Bootstrap3

==== Sonstige Konfiguration ====

Wie TPS-Wiki