Zentraleinrichtung Campusmanagement

Wikifarm mit Dokuwiki

Kurzbeschreibung

Die ZECM Ihnen ein vorkonfiguriertes Wiki zur Verfügung, mit dem Sie sofort arbeiten können. Die Wiki-Software wird von der ZECM aktualisiert und gewartet, so dass Sie sich auf die Inhalte konzentrieren können.

Dienstekategorie

Zielgruppen

Status

Allgemeines

Der Wikidienst der ZECM bietet allen Einrichtungen und Forschenden der TU eine einfache Möglichkeit ein Wiki zu betreiben ohne einen eigenen Server betreuen oder die Wiki-Software auf dem aktuellen Stand halten zu müssen.

Beim Wiki handelt es sich um ein vereinfachtes Content-Management-System, das es ermöglicht, Erfahrungen und Wissen gemeinschaftlich zu sammeln und zu dokumentieren. Verschiedene Autoren erarbeiten gemeinsam Texte, die intuitiv und ohne Programmierkenntnisse erstellt, editiert und mit Fotos und anderen Medien ergänzt werden können.

Das Wiki ist fester Bestandteil des konventionellen Webauftritts, den Einrichtungen und Forschende der TU erhalten, ein separater Antrag ist nicht notwendig. Sie können sich jederzeit entschließen das Wiki-Feature zu nutzen oder wieder zu deaktivieren.

Zugang

Sie erreichen Ihr aktiviertes Wiki, indem Sie an die Webadresse Ihres konventionellen Webauftritts /wiki/ anhängen.

Zu beachten

  • Alle erstellten konventionellen Webauftritte werden automatisch mit einem Wiki ausgestattet.
  • Der Wiki-Dienst steht nicht für TYPO3-Auftritte der zentral betreuten TYPO3-Infrastruktur zur Verfügung.

Voraussetzungen

Voraussetzung zur Nutzung des Wiki-Dienstes ist ein konventioneller Webauftritt. Alle neu erstellten konventionellen Webauftritte werden automatisch mit einem Wiki ausgestattet.

Features

Anleitungen

Häufig gestellte Fragen

Wie wird das Wiki (de-)aktiviert?

Im Basispfad Ihres Webauftritts befinden sich verschiedene Order, beispielsweise htdocs und cgi-bin. Dort finden Sie auch den Ordner wiki. Direkt in diesem Ordner wird bei der Erstellung des Webauftritts eine leere Datei mit dem Namen DISABLED angelegt. Solange diese Datei existiert, wird beim Aufruf des Wikis lediglich eine weiße Seite angezeigt. Zur Aktivierung des Wikis müssen Sie diese Datei einfach löschen. Nun ist Ihr Wiki erreichbar.

Sollten Sie Ihr Wiki später wieder deaktivieren wollen, legen Sie einfach eine neue leere Datei mit dem Namen DISABLED im wiki-Ordner an.

Was sind die ersten Schritte?

Initial ist das Wiki so konfiguriert, dass anonyme Benutzer, die nicht im Wiki eingeloggt sind, Inhalte nur lesen können. Damit Sie Inhalte erstellen können, müssen Sie sich zunächst als Administrator am Wiki anmelden. Hierfür haben wir einen Benutzer und ein zufälliges Passwort erstellt. Wo Sie die Zugangsinformationen finden, steht in der Antragsbestätigung, die wir der im Antrag benannten verantwortlichen Person per E-Mail zugesandt haben. Sollten Sie Probleme haben sich anzumelden, können Sie sich gerne per E-Mail an das Webteam wenden.

Nachdem Sie sich als Administrator eingeloggt haben, können Sie weitere Benutzer anlegen. Gruppen können nicht explizit angelegt werden. Eine Gruppe wird automatisch erzeugt, wenn sie im Feld Gruppen eines Benutzers angegeben wird. Mitglieder der Gruppe user können initial Einträge bearbeiten und neu anlegen, jedoch keine Dateien hochladen. Sie ist somit für Redakteure vorgesehen.

Als Administrator oder mit einem der neu angelegten Benutzer können Sie nun Inhalte erstellen, die für alle sichtbar sind.

Wer kann die Wiki-Konfiguration anpassen?

Sind Sie im Wiki als Administrator eingeloggt, erscheint ein zusätzlicher Link "Admin" über den Sie auf die Administrationsseite gelangen. Dort können Sie mit einem Klick auf "Konfiguration" zur Konfigurationsseite gelangen. Hier können alle Einstellungen vorgenommen werden. Einige Felder sind rot hinterlegt und nicht änderbar. Dies betrifft Felder, die für die korrekte Funktion des Wikis nicht geändert werden dürfen.

Wie stelle ich den Wiki-Login auf LDAP um?

Wenn sich Ihre Nutzer*innen mit dem TUB-Account anmelden sollen, müssen Sie das Wiki auf LDAP-Authentisierung umstellen.

ACHTUNG: Bitte lesen Sie unbedingt vorab die folgenden Hinweise!

1) Bei der LDAP-Authentisierung wird das Passwort im Klartext übertragen. Es ist daher zwingend erforderlich, dass der Zugriff ausschließlich via HTTPS erfolgt.

2) Durch die LDAP-Authentifizierung können sich ALLE Personen mit einem TUB-Account am Wiki anmelden. Damit nicht alle angemeldeten Personen Lese- und Schreib-Rechte besitzen, müssen Sie die Zugriffsrechte für die generische Gruppe USERS entfernen. Dann kann man sich zwar anmelden, hat aber keine Rechte, die Inhalte zu lesen oder zu schreiben. Die gewünschten Zugriffsrechte können Sie vergeben, indem Sie Rechte für einzelne TUB-Accounts oder LDAP-Gruppen vergeben. Für jede Einrichtung gibt es eine voreingerichtete Gruppe <OrgName der Einrichtung>_member und ggf. weitere Teamgruppen.

3) Wenn Sie auf LDAP-Authentisierung umgestellt haben, können Sie keine eigenen Benutzer*innen im Wiki mehr anlegen. Alle Benutzer*innen müssen über einen TUB-Account verfügen.

Die Konfiguration passen Sie direkt in der Datei local.php an, da nicht alle Felder im Admin-Webinterface verfügbar sind. Diese liegt unter wiki/conf/local.php, wobei der Ordner wiki parallel zum Ordner htdocs Ihres Webauftritts liegt. Ergänzen Sie einfach die folgenden Angaben:

$conf['authtype'] = 'authldap';
$conf['plugin']['authldap']['server'] = 'ldap.tu-berlin.de';
$conf['plugin']['authldap']['usertree'] = 'ou=user,dc=tu-berlin,dc=de';
$conf['plugin']['authldap']['userfilter'] = '(&(objectClass=posixAccount)(uid=%{user}))';
$conf['plugin']['authldap']['version'] = 3;
$conf['plugin']['authldap']['mapping']['grps']  = array('memberof' => '/CN=(.+?),/i');
$conf['plugin']['authldap']['attributes'] = array('dn', 'gidnumber', 'mail', 'cn', 'memberOf');

// NUR ZU DEBUG-ZWECKEN
// wenn '1' werden Debugausgaben bzgl. der LDAP-Anmeldung ausgegeben
$conf['plugin']['authldap']['debug'] = '0';

// wenn true, werden auf jeder Seite alle Gruppen des aktuellen Nutzers ausgegeben.
// Diese Gruppennamen können 1zu1 (Groß- und Kleinschreibung beachten!)
// für die Zugriffsrechte verwendet werden
$conf['userinfo_debug'] = 'false';

Kann ich auch etwas anderes als DokuWiki verwenden?

Die ZECM bietet im Rahmen des Wiki-Dienstes ausschließlich DokuWiki an. In Ihrem konventionellen Webauftritt können Sie jedoch selbst ein beliebiges Wiki installieren. In diesem Fall sind Sie aber auch selbst für die Wartung und Pflege der Anwendung verantwortlich. Achtung: Der Pfad /wiki/ ist fest auf das von der ZECM bereitgestellte DokuWiki eingestellt. Wenn Sie über /wiki/ ein eigenes Wiki erreichen möchten, muss dies zuvor durch die ZECM geändert werden. Wenden Sie sich hierfür per E-Mail an das Web-Team.

Kann ich mehr als ein Wiki haben?

Im Auslieferungszustand ist nur ein Wiki vorkonfiguriert, sie können allerdings zusätzliche betreiben. Dazu müssen Sie keine weiteren konventionellen Webauftritt beantragen. Schicken Sie einfach eine E-Mail an das Web-Team der ZECM mit einer kurzen Angabe, wieviele Wikis Sie benötigen, wie sie heißen sollen und unter welchem Webauftritt sie angelegt werden sollen.

Kann ich eigene Plugins verwenden?

Die ZECM verwaltet alle Wiki-Plugins. Wenn Sie ein bestimmtes Plugin benötigen, schicken Sie bitte eine E-Mail an das Web-Team mit genauen Angaben und einer Bezugsquelle (URL). Die ZECM prüft, ob es sich ohne Seiteneffekte in die Umgebung einbinden lässt oder sonstige Anpassungen nötig sind. Bitte haben Sie Verständnis dafür, dass dies einige Zeit in Anspruch nehmen kann und ggf zu einem negativen Ergebnis führen kann.

Kann ich eigene Templates verwenden?

Nein, eigene Templates werden leider für Farminstallationen von DokuWiki nicht unterstützt. D.h. dass die Templates für die gesamte Farm zentral von der ZECM verwaltet werden. Die Wikis der Farm können sich dann aus dem Pool der vorhandenen Templates eines aussuchen und den Style dann unter den Admin-Einstellungen des Wikis anpassen. 

Kümmert sich die ZECM um das Update des Wikis?

Ja! In Ihrem Home-Bereich liegen lediglich ihre individuellen Konfigurationsdaten sowie ihre Artikel und hochgeladenen Dateien. Die "Kernkomponenten" von Dokuwiki werden durch die ZECM aktuell gehalten. Dabei orientieren wir uns nicht an der jeweils aktuellsten Entwicklerversion, sondern an den als stabil gekennzeichneten Versionen. Bitte haben Sie Verständnis dafür, dass wir nach Erscheinen einer neuen Version zunächst einige Tests durchführen müssen, bevor wir sie einspielen. Somit kann es einige Zeit dauern, bis Ihnen die neue Version zu Verfügung steht. Neue Versionen, die keine Sicherheitslücken oder relevante Fehler beheben und keine neuen benötigten Funktionen mitbringen, werden unter Umständen übersprungen. Sollten sicherheitskritische Fehler entdeckt werden, spielen wir diese natürlich schnellstmöglich ein.

Gibt es ein Backup der Wikidaten?

Dokuwiki führt automatisch Buch über alle Änderungen an Ihren Wikiartikeln. Über den Link "Ältere Versionen" können Änderungen an einem Artikel nachvollzogen und ggf. rückgängig gemacht werden. Wird ein Artikel gelöscht, kann er von einem/r Administrator*in wiederhergestellt werden. Dafür muss auf der Administrationsseite der Punkt "Seiten wiederherstellen" aufgerufen werden. Die Daten Ihres Wikis, also alle Artikel sowie die hochgeladenen Dateien, liegen im Home-Bereich Ihrer Einrichtung. die ZECM sichert standardmäßig den gesamten Bereich. Dabei wird die Backup-Klasse Typ 1 angewandt, bei der innerhalb von 7 Tagen maximal drei Versionen einer Datei vorgehalten werden. Gelöschte Dateien werden nach 30 Tagen aus dem Backup entfernt. Wenn sie eine Datei oder einen Ordner wiederherstellen wollen, wenden Sie sich an die ZECM. Informationen hierzu finden Sie auf dieser Seite. Zusätzlich liegen im Ordner .snapshot, der sich in ihrem Hauptverzeichnis befindet, ihre kompletten Daten in der Version vom Vortag, auch die Web-/Wikidaten. Diese können Sie einfach selbst wieder zurück an die Originalstelle kopieren. Oft reicht diese Möglichkeit schon aus und ein Weg über die ZECM ist somit nicht mehr notwendig.

Unser Standort

Kontakt

Raum E-N 024
Adresse Einsteinufer 17
10587 Berlin
HotlineMo-Fr 09-16 Uhr
IT-Service-DeskMo-Fr 10-16 Uhr
IT-Service-Desk-RaumE-N 024