Mediawiki

Mediawiki als CMS

Wir nutzen Mediawiki als CMS für unsere Dokumentation. Es gibt im SuperX-Modul Wissensbasis (KB) einen Konnektor für Mediawiki-Seiten, der die Daten einliest, in SuperX speichert und daraus eine Website im HTML-Format + PDF Datei exportiert.

Bluespice

Durch die Erweiterung "Bluespice" ist die Bearbeitung auch im Team mit Hochschulen möglich, Bluespice bietet einen Wysiwyg-Editor, der insbesondere bei Tabellen sehr nützlich ist. Eine allgemeine Doku dazu befindet sich hier:

https://de.wiki.bluespice.com/wiki/Inhalte_erstellen_und_ordnen

Installation von Bluespice

Zunächst muss man die nötigen Pakete installieren:

apt-get install -y apache2 libapache2-mod-php mariadb-server mariadb-client 
apt-get install  -y php php-mbstring php-xml php-mysql php-curl php-gd php-tidy php-intl php-zip npm nodejs imagemagick

Achtung

wenn mysql bereits installiert ist, gibt es Probleme. Am besten daher deinstallieren, und mariadbinstallieren.

Dann starten wir mysql:

systemctl start mariadb

Dann richtet man die DB ein:

mysql
CREATE USER wikiuser@localhost IDENTIFIED BY 'anfang12';
create database wikidb;
GRANT ALL ON wikidb.* TO 'wikiuser'@'127.0.0.1' IDENTIFIED BY 'anfang12';
GRANT CREATE VIEW ON *.* TO 'wikiuser'@'localhost' ;

Dann legt man als root unterhalb von /var/www/html einen Ordner an, z.B. "wiki", und dann vergibt die Rechte:

chown -R www-data:www-data /var/www/html/wiki

Aktivierung des Editors

• Doku: https://www.mediawiki.org/wiki/Extension:TinyMCE
• Herunterladen:

git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/TinyMCE.git

• Dann als tgz Archiv packen und entpacken in /var/www/html/wiki/extensions
• Dann Datei anlegen

/var/www/html/wiki/settings.d/030-TinyMCE.php

mit dem Inhalt

<?php
wfLoadExtension( 'TinyMCE' );

• Direkt danach kann man den Editor nutzen.

Weitere Konfiguration

Aufruf mit http://localhost/wiki/installcheck.php

• Dateigröße Bilder etc:

/etc/php/7.4/apache2/php.ini

upload_max_filesize = 50M
post_max_size = 32M
max_execution_time = 120
memory_limit = 256M

Nach Änderung

service apache2 reload

Besonderheiten für HTML-Export

Der visuelle Editor von Bluespice ist zwar ganz praktisch, aber nicht immer können wir den entstandenen Code im HTML-Export nutzen.

Grafiken

Dies passiert z.B. beim Hochladen von Grafiken. Der Bluespice Editor läft die Grafiken in einem Schritt hoch und speichert den Quellcode in der Wiki Seite. Das macht beim HTM-Export Probleme. Daher bitte Grafiken über den klassischen Mediawiki-Weg hochladen:

1. Zuerst die Grafik hochladen mit der Spezialseite https://superxhosting.de/wiki/index.php/Spezial:Hochladen
2. Dann die Grafik in den Quellcode einfügen mit dem Tag

[[Bild:Dateiname.svg|800px]]

Zum Anpassen des Layouts von Grafiken kann man ein paar Attribute verwenden, der Name ist selbsterklärend:

[[Bild:Makrobericht_erstellen_1.png|right|thumb|400px|Kopie erstellen]]

Templates

Wir nutzen ein paar Templates, die immer wieder benötigten Code erstellen.

Article

Das Template Article liefert eine zweispaltige Box, wo in der linken (kleineren) Spalte ein Icon vorgesehen ist, und in der breiteren rechten Spalte ein Text. Beispiel:

{{Article_img_left |imgsrc=superx-logo.svg | text=Wir helfen, das Berichtswesen und Controlling in den Hochschulen zu verbessern bzw. zu erleichtern. Universitäten und Fachhochschulen können kostenlos von der SuperX-Projekthomepage die Software SuperX beziehen, ein Data-Warehouse für Daten aus der Hochschulverwaltung.}}

Das sieht dann so aus:

Wir helfen, das Berichtswesen und Controlling in den Hochschulen zu verbessern bzw. zu erleichtern. Universitäten und Fachhochschulen können kostenlos von der SuperX-Projekthomepage die Software SuperX beziehen, ein Data-Warehouse für Daten aus der Hochschulverwaltung.

Sie können die Grafik auch mit einem Link versehen. Leerzeichen im Link-ziel müssen durch ein "_" ersetzt werden. Beispiel:

{{Article_img_left |imgsrc=APP.png| link=Memtext-Homepage-Redesigned#Modul_Bewerbungen|text=Modul Bewerbungen}}

Das sieht dann so aus:

Modul Bewerbungen

Gallery

Die Gallery bietet eine horizontale Reihe von kleinen Grafiken mit Untertitel. Die Graifken wiederum können Links auf Unterkapitel bieten. Beispiel

<gallery> Icon_superx.png|Original-Icon von SuperX (Uni Karlsruhe) megaphone.svg|Aktuelles|link=SuperX-Homepage#Aktuelles download.svg|Zum Download-Bereich|link=SuperX-Homepage#Downloadbereich sx_users.svg|Aktuelle Projektgruppe|link=SuperX-Homepage#Zum_SuperX-Projekt </gallery>

Dies sieht dann so aus:

• 

  Original-Icon von SuperX (Uni Karlsruhe)

• 

  Aktuelles

• 

  Zum Download-Bereich

• 

  Aktuelle Projektgruppe

Für ein Beispiel mit Links siehe die SuperX-Homepage direkt am Anfang: SuperX-Homepage

ImageLink

Das Template ImageLink liefert inline eine Grafik, die mit einem Link hinterlegt ist. Beispiel:

Quellcode: {{ImageLink |imgsrc=MT20_Anfang.png| link=Memtext-Homepage-Redesigned#Der_Anfang|width=200px}}

Dies sieht dann so aus:

ImagePara

Das Template ImagePara liefert eine Grafik in einem leeren Absatz, die mit einem Rahmen versehen sind. Die Grafik ist mit einem auf sich selbst hinterlegt, zum Vergrößern. Beispiel:

Quellcode: {{ImagePara |imgsrc=MT20_Anfang.png|width=200px|caption=Wir feiern 20 Jahre}}

Dies sieht dann so aus:

ImageTile

Das Template ImageTile liefert eine Grafik umrandet von einer Kachel, und einem kurzen Text darunter. Beides ist mit einem Link hinterlegt. Beispiel:

Quellcode: {{ImageTile |imgsrc=superx-logo.svg | link=Memtext-Homepage | caption=Zur Memtext Homepage}}

Dies sieht dann so aus:

Zur Memtext Homepage

Rechte

Generell kann jeder angemeldete Benutzer alle Seiten sehen. Wenn das nicht gewünscht ist wird im Kopf der Datei ein Element "pageacces" gesetzt, mit den jew. Gruppen, die die Seite sehen dürfen. Beispiel:

<bs:pageaccess groups="Bonn_UNI,Memtext" />

Weitere Links

Mediawiki Syntax

Mediawiki Seiten bearbeiten