Extension:BibManager/Admin manual/de

Die MediaWiki Erweiterung "BibManager" ermöglicht das Verwalten von bibliographischen Daten im Wiki. Diese Dokumentation beschreibt die Installation und Konfiguration der Erweiterung.

Installation und Konfiguration
Kopieren Sie den Ordner "BibManager" in das  Verzeichnis. Im Folgenden ist beschrieben welche Änderungen Sie an der  Ihrer MediaWiki-Installation vornehmen müssen.

Zunächst wird ein spezieller Namensraum für die Beschreibungsartikel angelegt. Die Zahl können Sie Ihrer Konfiguration gemäß anpassen.

define("NS_CITATION", 800); define("NS_CITATION_TALK", 801); $wgExtraNamespaces[NS_CITATION] = "Cit"; $wgExtraNamespaces[NS_CITATION_TALK] = "Cit_talk";

Anschließend werden die beiden Erweiterungen eingebunden.

require_once("$IP/extensions/BibManager/BibManager.php");

Der oben angelegte Namensraum muss am BibManager registriert werden. Sie können alternativ auch einen anderen, bereits bestehenden Namensraum verwenden und in dem Fall die ersten vier Zeilen weglassen.

$wgBibManagerCitationArticleNamespace = NS_CITATION;

Weitere optionale Konfigurationsvariablen sind (hier mit ihren Standardwerten angegeben): Zum Abstellen der (wenigen) JavaScripts

$wgBibManagerUseJS = false;

Für die zukünftige Weiterentwicklung besteht die Möglichkeit das Repository einzustellen in dem BibManager seine Daten speichert. Derzeit ist nur die Speicherung in einer Tabelle der MediaWiki Datenbank möglich. (Um ein neues Repository zu entwickeln muss man eine neue Klasse von der abstrakten Klasse  ableiten und die entsprechenden Methoden implementieren):

$wgBibManagerRepoClass = 'BibManagerLocalMWDatabaseRepo';

Um das Format in der Ausgabe zu verändern existiert ein Mapping zwischen Referenztyp und auszugebendem Format ("-" ist der Standard auf den zurückgefallen wird, wenn kein passender Referenztyp gefunden wurde):

$wgBibManagerCitationFormats = array (   '-'             => '%author%: %title%, %year%',    'article'       => '%author% (%year%): %title%. %journal%, %volume%, %pages%',    'book'          => '%author% (%year%): %title%. (%edition%). %publisher% , %address%, %pages%',    'booklet'       => '%title%',    'conference'    => '%author% (%year%): %title%. %booktitle%',    'inbook'        => '%author% (%year%): %title%. (%edition%). %publisher% , %address%, %pages%, %editor%, %chapter%',    'incollection'  => '%author% (%year%): %title%.  %booktitle%',    'inproceedings' => '%author% (%year%): %title%. %publisher% , %booktitle%',    'manual'        => '%title%',    'masterthesis'  => '%author% (%year%): %title%. %school%',    'misc'          => '%author%: %title%, %year%',    'phdthesis'     => '%author% (%year%): %title%. %school%',    'proceedings'   => '%title% (%year%)',    'techreport'    => '%author% (%year%): %title%. %institution%.', 'unpublished'  => '%author%: %title%. %note%.' );

Folgende Platzhalter sind für die Konfiguration zulässig:

Google Scholar ist eine Suchmaschine des Unternehmens Google Inc. und dient der allgemeinen Literaturrecherche wissenschaftlicher Dokumente. Um die in den Tooltips auftauchende Verlinkung zu Google Scholar zu konfigurieren kann die Variable  angepasst werden:

$wgBibManagerScholarLink = 'http://scholar.google.com/scholar?q=%title%';

Um die den Zugriff auf die BibManager-Spezialseiten einzustellen stehen foldende zu Rechte zur Verfügung:
 * : Regelt den Zugriff auf "Spezial:Bibliographieeintrag bearbeiten" und "Spezial:Bibliographieeinträge importieren".
 * : Regelt den Zugriff auf "Spezial:Bibliographieeintrag anlegen".
 * : Regelt den Zugriff auf "Spezial:Bibliographieeintrag löschen" und schränkt damit die Fähigkeit des Benutzers zum Löschen von Einträgen ein.

Hier ein Beispiel zum Setzen der Rechte: $wgGroupPermissions['*']['bibmanageredit']	= false; $wgGroupPermissions['author']['bibmanageredit']	= true; $wgGroupPermissions['editor']['bibmanageredit']	= true;

Die erste Klammer steht für die Benutzergruppe, die Zweite für das Recht.

Um die Installation abzuschließen führen Sie auf der Kommandozeile die update.php im   Verzeichnis aus:

php update.php

Dadurch werden die notwendigen Tabellen in der Datenbank erzeugt.

Import und Export des gesamten Repositories
Von der BibManager Erweiterung werden zwei Skripte zur Verfügung gestellt, mit denen man den Inhalt eines Repositories komplett exportieren und importieren kann.

Um den kompletten Inhalt des Repositories als BibTeX auszugeben führen Sie folgenden Befehl auf der Kommandozeile aus: php /extensions/BibManager/maintenance/BibManagerExportRepo.php --filename export.bibtex

Die Exportdatei wird dabei in dem Verzeichnis angelegt, von dem aus das Skript aufgerufen wird.

Eine so erzeugte Exportdatei lässt sich über das zweites Skript wieder importieren. Bereits bestehende Einträge werden dabei überschrieben. php /extensions/BibManager/maintenance/BibManagerImportRepo.php --filename export.bibtex