BibManager:Benutzerhandbuch

From Saltwiki

Die MediaWiki Erweiterung "BibManager" ermöglicht das Verwalten von bibliographischen Daten im Wiki. Diese Dokumentation beschreibt den Umgang mit der Erweiterung. Sie behandelt auch die "SaltWiki" Erweiterung, welche den "BibManager" für die Ansprüche des Hornemann Instituts modifiziert, sowie die "SaltWikiUpload" Erweiterung welche die Spezialseite "Hochladen" um Felder für die Eingabe von Metadaten erweitert.


BibManager und SaltWiki

Der folgende Abschnitt befasst sich mit der Bedienung der "BibManager" Erweiterung.


Spezialseiten

Unter Spezial:Spezialseiten finden Sie einen Abschnitt "BibManager", der Sie zu den verschiedenen Oberflächen bringt:

Eintrag auf Spezial:Spezialseiten. Deutshc Version.


Einträge anlegen

Auf der Spezialseite "Bibliographieeintrag anlegen" (Englisch "Add new entry") können Sie aus einer Liste von Referenztypen auswählen und werden anschließend auf ein Formular weitergeleitet, in dem Sie Angaben zu dem bibliographischen Eintrag machen können.

deutsche Version.


Einträge importieren

Alternativ zum Einfügen über ein Formular können auch Sie dem Link auf die Spezialseite "Bibliographien importieren" (Englisch: "Import BibTeX") folgen und dort eine dem BibTeX-Format entsprechende Zeichenkette eingeben. Fügen Sie in das Textfeld die zu importierende BibTeX Zeichenkette ein. Auf diese Weise können auch mehrere Einträge gleichzeitig angelegt werden.

deutsche Version

HINWEIS: Durch die "SaltWiki" Erweiterung wird das Format Autorenkürzel:Jahr für das Zitatkürzel vorgegeben!

Folgende Felder sind zulässig:

  • address
  • annote
  • author
  • booktitle
  • chapter
  • crossref
  • edition
  • editor
  • eprint
  • howpublished
  • institution
  • journal
  • key
  • month
  • note
  • number
  • organization
  • pages
  • publisher
  • school
  • series
  • title
  • type
  • url
  • volume
  • year

Durch die "SaltWiki" Erweiterung kommen zudem die Felder doi und fulltext hinzu.

Einträge verwalten

Die Spezialseite "Bibliographien anzeigen: Autoren" (Englisch "Overview authors") bietet eine alphabetisch geordnete Übersicht über alle Autoren. Ein Klick auf den Namen eines Autors ruft die Spezialseite "Bibliographien verwalten" (siehe unten) mit voreingestelltem Filter auf.

deutsche Version.

Auf der Spezialseite "Bibliographien verwalten" (Englisch "Overview") können Sie sich eine Liste aller im System vorhandenen Einträge ausgeben lassen. Sie können diese Liste auch nach bestimmten Kriterien filtern. Verwenden Sie hierzu das Formular am Anfang der Seite.

Wenn Sie die entsprechenden Berechtigungen besitzen können Sie an dieser Stelle über die Schaltflächen in der "Aktionen" Spalte Einträge auch bearbeiten oder löschen.

deutsche Version.

Außerdem haben Sie auf dieser Spezialseite die Möglichkeit einen oder mehrere Einträge in das BibTeX-Format zu exportieren und diese so in anderen Anwendungen zu nutzen.

deutsche Version.


Einträge bearbeiten

Ob Sie einen Eintrag bearbeiten können hängt von den Berechtigungen ab, die Ihrem Benutzerkonto zugewiesen sind. Die Bearbeitungsansicht stellt Ihnen ein an den Referenztyp angepasstes Formular zur Verfügung. Sie gelangen auf diese Oberfläche, wenn Sie bei einem bestehenden Eintrag auf den "bearbeiten"-Link (Stift-Symbol) klicken.

deutscheVersion.

Einträge löschen

Der Zugriff auf den "Löschen"-Dialog ist wie die Bearbeitungsansicht abhängig von Ihren Berechtigungen. Sie ermöglicht Ihnen die zu löschenden Daten nochmal zu betrachten und erwartet eine Bestätigung. Löschen können Sie einen Eintrag über das X-Symbol (siehe oben).

deutsche Version.


Arbeiten im Wikiartikel

Für die Arbeit im Fließtext stellt Ihnen die "BibManager" Erweiterung verschiedene sogenannte "Tags" zur Verfügung. Diese werden im Folgenden beschrieben.


<bib />

Um eine Zitation zu platzieren muss das Tag mit dem id Attribut in den Fließtext eingefügt werden. (z.B. <bib id="lin:1973"/>).

deutsche Version.

Eine Zitation wird im Ansichtsmodus eines Artikels in eckigen Klammern ausgegeben und bietet beim darüberfahren mit der Maus detailliertere Informationen. Existiert ein Zitatschlüssel dabei noch nicht im Repository wird ein Link auf die "Bibliographieeintrag anlegen" Spezialseite erzeugt.

deutsche Version.


<biblist />

Dieses Tag listet alle in dem Artikel vorkommenden Zitationen (<bib />) auf, gibt die entsprechend formatierten Daten aus (siehe oben) und ermöglicht den schnellen Zugriff auf die Bearbeitungsansicht und Google Scholar. Ist ein Volltext-Link verfügbar wird auch dieser angezeigt.

Es besitzt keine Attribute.


<bibprint />

Dieses Tag ermöglicht es Abfragen an das Repository zu stellen. Das verwendete Attribut heißt filter und erwartet Werte in folgendem Format: feldname:wert|oderwert,feldname2:wert2

Es können mehrere Felder mit einem logischen "und" verbunden werden, indem man sie mit Kommas voneinander trennt. Feldname und Wert des Feldes sind über einen ":" voneinander getrennt. Möchte man bestimmte Werte eines Feldes mit einem logischen "oder" verknüpfen kann man das "|" Symbol als Trennzeichen verwenden. Mit % ist auch Links- und Rechtstrunkierung bei den Werten möglich. Die möglichen Feldnamen sind weiter oben beschrieben.

Beispiele:

Zitate die im Feld year entweder den Wert 2011 oder 1989 haben. => feldname:wert|oderwert

<bibprint filter="year:2011|1989" />


Zitate von Autoren deren Name die Zeichenkette "Steiger" enthält => feldname:wert

<bibprint filter=“author:%Steiger%“ />


Zitate von Autoren deren Name die Zeichenkette "Arnold" enthält und die aus dem Jahr "2011" oder "1989" stammen => feldname:wert|oderwert,feldname2:wert2

<bibprint filter=“year:2011|1989,author:%Arnold%“ />


Zusätzlich kann über das <bibprint /> Tag durch die Verwendung des citation Attributs eine vollständige Ausgabe eines bestimmten Zitates erwirkt werden.

<bibprint citation="Arnold.etal:1989" /> oder <bibprint citation="Arnold:1994" />


deutsche Version.

deutsche Version.

SaltWikiUpload

Bedienung

Die "SaltWikiUpload" Erweiterung verändert den Hochladen-Dialog von MediaWiki. Über spezielle Formularfelder können Sie bereits beim hochladen einer Datei bestimmte Metadaten angegeben.

Zu den allgemeinen Metadaten gehören

Beschreibung
Eine kurze Beschreibung der Datei und deren Inhalts.
Quelle
Die Quelle der Datei muss eindeutig nachvollziehbar sein.
Datum
Das Datum hilft die Aktualität der beinhalteten Daten einzuschätzen.
Autor(en)
Hier können die Autoren der Datei angegeben werden. Mehrere Autoren werden über Kommas voneinander getrennt. Die angegebenen Werte werden auch zur Kategorisierung der Datei verwendet.
Berechtigung
Es ist wichtig zu erfassen welche Nutzungsrechte für die Datei verfügbar sind. Bitte hinterlegen Sie auch wer diese Rechte hält und wie man diese Person kontaktieren kann.
Schlagwörter / Kategorien
Über die hier angegebene Werte erfolgt eine Kategorisierung im MediaWiki-Kategoriesystem. Auch hier werden mehrere Werte durch Kommas voneinander getrennt.
Typ
An dieser Stelle können Sie den die Art des Inhalts der Datei auswählen. Die Auswahl wird auch als Kategorie an die Dateibschreibungsseite übermittelt.

Je nach gewähltem Typ können Sie in den darunter eingeblendeten Formularfeldern weitere Daten angeben.

deutsche Version.


Auf der Dateibeschreibungsseite werden die angegebenen Informationen dann automatisch über MediaWiki Vorlagen eingebunden.

Englische Version. Englische Version.