HpbWiki:InstallationKonfiguration

Aus Hampas Wiki

Wechseln zu: Navigation, Suche

Inhaltsverzeichnis

Voraussetzungen

Als Systemvoraussetzungen für die, von mir eingesetzte, Version 1.9.3 wir folgendes verlangt.

Required software:
* Web server with PHP 5.x or higher.
* A MySQL server, 4.0.14 or higher OR a Postgres server, 8.1 or higher


Installation

Once the wiki is set up, you should remove the config directory, or at least make it not world-writable (though it will refuse to config again if the wiki is set up).

Installation (english)

Konfiguration

In diesem Abschnitt trage ich Informationen über die Konfiguration des MediaWikis zusammen, die ich auch grösstenteils in diese Wiki eingebaut habe.

Konfiguration

Die Konfigurations-Datei LocalSettings.php

Variablen innerhalb LocalSettings.php

Datei-Upload

Der Datei-Upload ist aus Sicherheitsgründen standardmässig deaktiviert. Um ihn zu aktivieren, setze

$wgEnableUploads = true;

MediaWiki hat eine Liste von bevorzugten Dateitypen und eine Blackliste von Endungen, die grundsätzlich nicht erlaubt sind.

Die Datei für die Liste findet Ihr unter dem MediaWiki Verzeichnis \includes\DefaultSettings.php

$wgCheckFileExtensions = true;
$wgFileExtensions = array( 'png', 'gif', 'jpg', 'jpeg' );
$wgFileBlacklist = array(
       'html', 'htm',
       'php', 'phtml', 'php3', 'php4', 'phps',
       'shtml', 'jhtml', 'pl', 'py',
       'exe', 'scr', 'dll', 'msi', 'vbs', 'bat', 'com', 'pif', 'cmd', 'vxd', 'cpl' );

Automatisch Thumbnails generieren (wahlweise mit ImageMagick oder den in PHP eingebauten Funktionen):

$wgUseImageResize = true;

Probleme mit dem Upload von MS-Excel Dateien

Versucht man eine Excel-Tabelle hochzuladen erscheint folgende Fehlermeldung.

Die Datei ist beschädigt oder hat einen falschen Namen. Bitte überprüfen Sie die Datei und laden Sie sie erneut hoch.

Dabei handelt es sich anscheinend um ein Problem mit dem MIME-Type. Als Workaround habe ich folgenden Vorschlag gefunden.

In die Datei /wiki/includes/mime.types den Eintrag /application/msword doc mit xls ergänzen. (/application/msword doc xls)

Gefunden habe ich diesen Hinweis hier: [1]

Navigationsmenü anpassen

The contents of the navigation bar can be edited using the MediaWiki:Sidebar message page. To access this page, enter "MediaWiki:Sidebar" into the "search" box and click Go.

As of MediaWiki 1.9.0, the default page will not appear to exist; this is normal. Click "edit" to alter the message.

The format of this message is as follows:

* navigation
** mainpage|mainpage
** Special:Recentchanges|Recent changes
** forums-url|Forums
** http://www.mediawiki.org|MediaWiki home

This snippet demonstrates the various formats available for use.


Zugriffsberechtigungen

Um die Zugriffsrechte für dieses Wiki ein bisschen restriktiver zu gestalten, helfen die folgenden Einstellung in der Datei LocalSettings.php

$wgGroupPermissions['*'    ]['createaccount']   = false;
$wgGroupPermissions['sysop']['createaccount']   = true;
$wgGroupPermissions['*'    ]['read']            = true;
$wgGroupPermissions['*'    ]['edit']            = false;  #Nur noch angemeldeten Benutzern das Bearbeiten erlauben
$wgGroupPermissions['sysop']['edit']            = true;

Weite Infos zu $wgGroupPermissions

Suche über weiter Namensräume ausdehnen

Mit der folgenden Einstellung, ebenfalls in der Datei LocalSettings.php wird die Suche über die angegebenen Namensräume ausgedehnt.

# DD Zu durchsuchende Namensraeume hinzugefuegt
$wgNamespacesToBeSearchedDefault = array(
NS_MEDIA            => true,
NS_SPECIAL          => true,
NS_MAIN             => true,
NS_TALK             => true,
NS_USER             => true,
NS_USER_TALK        => true,
NS_WIKIPEDIA        => true,
NS_WIKIPEDIA_TALK   => true,
NS_IMAGE            => true,
NS_IMAGE_TALK       => true,
NS_MEDIAWIKI        => true,
NS_MEDIAWIKI_TALK   => true,
NS_TEMPLATE         => true,
NS_TEMPLATE_TALK    => true,
NS_HELP             => true,
NS_HELP_TALK        => true,
NS_CATEGORY         => true,
NS_CATEGORY_TALK    => true
);
$wgSearchType="SearchMySQL4"; #Dieser Parameter muss ich noch genauer Abklären.


Realisieren einer "breadcrumb"-Navigation

Folgenden Eintrag in die Datei LocalSettings.php machen:

# Enable subpages in the main namespace:
# breadcrumb-Navigation is available
$wgNamespacesWithSubpages[0] = true;

Um nun eine sogenannte "Brotkrümel"-Navigation zu erhalten müssen die Dokumentnamen folgendem Muster folgen:

Stufe Seitenname
Name der Seite 1 NameSeite1
Name der Seite 2 (Unterseite) NameSeite1/NameSeite2
Name der Seite 3 (Unter-Unterseite) NameSeite1/NameSeite2/NameSeite3


Weitere Namensäume

Erstellen

http://www.mediawiki.org/wiki/Manual:Using_custom_namespaces

Subpages innerhalb des Namesraums freischalten

http://www.mediawiki.org/wiki/Manual:$wgNamespacesWithSubpages

In Default-Suche einbinden

http://www.mediawiki.org/wiki/Manual:$wgNamespacesToBeSearchedDefault

Nicht vergessen, den bestehenden Benutzern in der Default-Suche die neuen Namespaces zuzuweisen.(Wird in obenstehendem Link erklärt. Stichwort: userOptions.php


Disable Section-Edit

Es besteht default-mässig die Möglichkeit jeden Abschnitt für sich alleine zu bearbeiten, indem man auf den Link [bearbeiten] am rechten Rand jeder Abschittsüberschrift klickt. Dies macht besonders bei langen Seiten Sinn.

Es gibt nun zwei Möglichkeiten diese Funktion abzuschalten.

1. Jeder Benutzer kann unter Einstellungen / Bearbeiten das Häckchen bei "Links zum Bearbeiten einzelner Absätze anzeigen" entfernen. Dadurch wird die Funktion nur für diesen Benutzer systemweit abgeschaltet.

oder

2. Der Ersteller der Seite plaziert irgendwo auf der Seite den Tag '''__NOEDITSECTION__'''. So wird explizit für diese Seite die Funktion deaktiviert.

Ich habe bis jetzt noch keine Möglichkeit gefunden diese Funktion über eine globale Einstellung komplett zu deaktiviern.


Update (Danke Dirk)

Grundsätzliches Vorgehen

  1. downzeit ankündigen
  2. apache runterfahren
  3. backup verzeichnis
  4. backup datenbank
  5. kopie neue dateien
  6. datenbankskript
  7. apache starten

Schritt 1: Aktuelle Version fesstellen

Überprpfen, welche Version auf dem System installiert ist. Dazu gibt man auf der linken Seite im Feld Suche folgendes ein und drückt die Eingabetaste

Special:Version

Schritt 2: Aktuelle Version downloaden

Und zwar hier: [2]

Schritt 3: Backup der bestehenden Wiki-Installation

Man(n) weiss ja nie. ;o)

Backup der Wiki-Installation (filemässig)

tar cf backup.tar wikiverzeichnis

Backup der Wiki-MySql Datenbank

mysqldump datenbank -u user -p > dump.sql

Schritt 4: Update durchführen

Wie das geht sieht man hier: [3]

Wichtig! Unbedingt das Paket php5-cli installieren. Ansonsten kann das Update-Script nicht mit php update.php durchgeführt werden.

Schritt 5: Rechte auf Verzeichnisse und Dateien neu setzen.

Sämtliche Verzeichnisse und Dateien werden an die Gruppe sowie den Bentzer www-data übergeben.

sudo chown -R www-data:www-data /srv/www/techwiki/*

Nützliche Infos

Mehr als ein Wiki auf dem selben Server: [4]

Interna

Templates (Vorlagen)

Meine Werkzeuge