FoswikiSetup

Foswiki-Wiki Software einrichten und konfigurieren.

Foswiki Grundinstallation

Grundlage: http://foswiki.org/System/InstallationGuide

...

Voraussetzungen

Pakete installieren, falls noch nicht installiert:

apt-get install apache2 perl grep rcs

Foswiki-Installation

Das tar.gz herunterladen und in /var/www/domain entpacken.

Optional einen symbolischen Link anlegen:

cd /var/www/domain/
tar xf Foswiki-2.1.6.tgz
ln -s Foswiki-2.1.6 foswiki

Perl-Abhängigkeiten installieren

apt-get install --no-install-recommends libalgorithm-diff-perl libarchive-tar-perl libauthen-sasl-perl libcgi-pm-perl libcgi-session-perl libcrypt-passwdmd5-perl libdigest-sha-perl libemail-address-perl libemail-mime-perl libencode-perl liberror-perl libfile-copy-recursive-perl libhtml-parser-perl libhtml-tree-perl libio-socket-ip-perl libio-socket-ssl-perl libjson-perl liblocale-maketext-perl liblocale-maketext-lexicon-perl liblocale-msgfmt-perl libwww-perl liblwp-protocol-https-perl liburi-perl libversion-perl

Quelle: https://foswiki.org/System/InstallationGuide#Specific_distribution_details

Für FastCGI: apt-get install libfcgi-perl

Ggf. mit dem Skript tools/dependencies die Abbhängigkeiten anzeigen lassen.

Fehler sehen so aus:

# perl tools/dependencies
Content-type: text/plain

**** ERROR ****
The following critical dependencies are missing from your installation:
 ... CGI: Can't locate CGI.pm in @INC 
 ... CGI::Session: Can't locate CGI/Session.pm in @INC 
 ... Crypt::PasswdMD5: Can't locate Crypt/PasswdMD5.pm in @INC 
 ... Error: Can't locate Error.pm in @INC 
 ... JSON: Can't locate JSON.pm in @INC 

Wenn die Standard-Abhängigkeiten installiert sind, meckert das Skript dennoch über fehlende Module, aber ohne die ** ERROR ** Meldung.

Webserver-Konfiguration

Module aktivieren

a2enmod rewrite

Bei der Nutzung von FastCGI passendes Modul installieren:

apt-get install libapache2-mod-fcgid

Konfigurationsdatei per Online-Config-Generator erstellen https://foswiki.org/Support.ApacheConfigGenerator ... in /etc/apache2/conf-available ablegen und aktivieren:

a2ensite turmzimmer1
systemctl reload apache2

E-Mail Benachrichtigungen aktivieren

Zur crontab hinzufügen:

*/5 *   * * *   www-data cd /var/www/stadtlandfrucht.de/foswiki/tools && perl -I../bin mailnotify

Foswiki-Konfiguration

Sprache einstellen

Unter System -> configure -> Internationalization -> Languages ...

... den Punkt "Interface Internationalisation" aktivieren, danach die gewünschte Sprache auswählen und oben rechts auf "save" klicken.

Danach kann die Sprache im Frontend mittels Dropdown-Menü oben rechts ausgewählt werden.

Plugins entfernen / deaktivieren

Ohne gewisse Plugins ist foswiki schöner, ordentlicher und ggf. auch schneller.

Doku: https://foswiki.org/System/Plugins

Plugins können entweder per configure-"Skript" entfernt oder mittels Konfigurationsanweisung deaktiviert werden:

   * Set DISABLEDPLUGINS = SmiliesPlugin

Diese Anweisung kann global in Main.SitePreferences oder für jedes einzelne Web in WebPreferences gesetzt werden.

SmiliesPlugin

Nervt einfach, weil es Inhalte in der Darstellung verfälscht.

Plugins installieren

Empfohlene Plugins.

TagMePlugin

Erlaubt das Taggen von Wiki-Seiten.

Erfordert: FilterPlugin, welches Text::Unidecode benötigt:

apt-get install libtext-unidecode-perl

Twisty-Plugin (manuell installieren)

cd /tmp/
wget https://foswiki.org/pub/Extensions/TwistyPlugin/TwistyPlugin.tgz
wget https://foswiki.org/pub/Extensions/TwistyPlugin/TwistyPlugin.md5
cat TwistyPlugin.md5
md5sum TwistyPlugin.tgz
mv -i TwistyPlugin.* /var/www/bitmuehle.de/foswiki
cd /var/www/bitmuehle.de
tar cfz backup-foswiki-2017-12-29.tar.gz Foswiki-2.1.3/
cd foswiki
tar xvf TwistyPlugin.tgz
chown -R www-data:www-data *

Siehe auch

• ApacheSetup