Interaktive Webbibliografien mit Zotero
Beispielinstallationen
Laborwebsite bei Penn State
Persönliche Website
Dokumentation
http://zot-bib-web.readthedocs.io/
Autor/Kontakt:
David [email protected] http://www.david-reitter.com
Merkmale
Dieses Tool generiert interaktive Web -Bibliographien, die auf einer oder mehreren Sammlungen in einem Zotero -Repository basieren. Sammlungen können von Personengruppen mithilfe von Zoteros Weboberfläche oder deren Desktop -Anwendungen verwaltet werden.
Bibliografien können per Sammlung, nach Veröffentlichungsjahr oder nach Veröffentlichungstyp (z. B. Journalartikeln zuerst) bestellt werden, können interaktiv durchsucht werden, können mit PDF -Dokumenten oder anderen URLs verknüpft werden, Aufzeichnungen für Bibtex, Endnote und Wikipedia haben und an HTML exportiert werden oder in eine WordPress -Datenbank geschoben werden können.
ZOT_BIB_WEB hängt nicht von einem Webserver von Drittanbietern ab. Die generierten Bibliografien laden schnell, da sie zusammen mit dem Rest Ihrer Website als statische Dateien gespeichert werden. Dies ist eine gute Quelle für Webcrawler, einschließlich Google Scholar und Citeseer.
Das Setup ist für alle, die eine eigene Website ausführen, einfach und weiß, wie man eine Befehlszeile (Shell) verwendet. Der einfachste Weg, es zu verwenden, besteht darin, Zot.py mit dem Schlüssel einer öffentlichen Zotero -Sammlung anzurufen. Es wird eine zotero-bib.html-Datei erstellen. Kopieren Sie dies zusammen mit dem Verzeichnis "Site" und "Dateien" (falls vorhanden) in Ihren Webserver.
Demo
Sehen Sie sich die HTML -Dateien im Demo -Ordner an, um einige Beispiele für Bibliografien zu erhalten. Ihre jeweiligen Einstellungsdateien und CSS -Style -Dateien sind enthalten.
Laufen:
./zot.py -Settings Demo/Settings3.py
es in Aktion zu sehen.
Lizenz und Spenden
- Verwenden und ändern Sie diese Software kostenlos.
- Es wird keine Garantie gewährt.
- Bitte senden Sie eine E-Mail an [email protected]. Ein Link zur Bibliographie auf Ihrer Website, wenn Sie sich für die Verwendung zot_bib_web entscheiden.
- Sie können diese Software kostenlos verwenden.
Anforderungen
Python 2.7 oder 3.6+
Pyzotero. So installieren Sie Pyzotero, eine Bibliothek für Python:
sudo pip install Pyzotero
oder:
sudo easy_install pyzotero
Eine Zotero -Sammlung mit Ihrer Bibliographie (als Benutzer oder als Gruppe)
Optional: DateUtils -Paket für Python (verbessert das Parsen von Datum, wenn vorhanden)
Aufstellen
Stellen Sie sicher, dass Zot.py ausführbar ist (CHMOD UG+X ZOT.PY)
Probieren Sie es aus. Tun Sie dies aus einer Unix-ähnlichen Befehlszeile:
./zot.py --group 160464 dtdtv2ep
Anschließend Zotero-bib.html in einem Browser anzeigen. Wenn das gut aussieht, fahren Sie mit den nächsten Konfigurationsschritten fort.
- Fügen Sie in einer neuen Datei namens Settings.py die Konfiguration hinzu, wie in der Dateieinstellungen_example.py dokumentiert. Gehen Sie auf zotero.org, um Ihren API -Geheimschlüssel und Ihre Benutzer- oder Bibliothek -IDs zu erhalten. Es ist einfach: Weitere Informationen finden Sie in der oberen Stelle der Einstellungen. Beispiel.py. Wenn Einstellungen eingerichtet ist, können Sie Zot.py ohne Argumente aufrufen.
Alternativ können Sie die primären Einstellungen in Argumenten für das Programm verwenden.
Bibliographie in Zotero
- Erstellen Sie mit Zotero eine Bibliographie und beachten Sie ihre ID (z. B. aus der URL in der Zotero -Weboberfläche). Beispiel:
MGID90AT . Diese ID benötigen Sie für die Variable "Toplevelfilter" in Settings.py. - Sie können Ihrer Bibliographie Untersammelungen hinzufügen.
- Wenn Sie nach Sammlungen bestellt werden, kann es hilfreich sein, ihnen eine Bestellung zu geben. Sie können Sammlungen benennen, beginnend mit einer Nummer: "10 Sozialpsychologie".
Hier ist ein Beispiel für eine Bibliographiestruktur:
Meine Veröffentlichungen [Mgid90at]
10 ausgewählte Werke
15 zur Vorbereitung / untersucht
20 Schiedsrichterwerke nach Thema
Semantik
Parsing
Dialog
Maschinelles Lernen
30 Thesen
40 Gespräche (ohne Papier)
Verwenden Sie dies als Beispiel die bereitgestellten Einstellungen.py.
Überblick über Konfigurationsoptionen
- Die Konfiguration erfolgt in einer Einstellungsdatei standardmäßig benannte Einstellungen.py.
- Rufen Sie ./zot.py-HELP, um eine Liste der Befehlszeilenoptionen anzuzeigen.
- Weitere Informationen zur Einstellungsdatei finden Sie in der Dokumentation oder lesen Sie die Einstellungen. Einige Optionen werden im Folgenden erörtert.
- Sie können unsere Bibliographie durch Untersammlung, nach Jahr oder nach Veröffentlichungstyp (z. B. Journalartikeln zuerst, dann Konferenzarbeiten) bestellen. Selbst innerhalb der Kategorien höherer Ebene können Sie Ihre bibliografischen Einträge nach Belieben sortieren. Verwenden Sie die Einstellungen "sort_criteria" und "show_top_section_headings".
- Sie können eine andere Formatierungskonvention auswählen. Standard ist das APA -Format.
- Oben können ein Suchfeld und eine Reihe von Verknüpfungen angezeigt werden: Zum Beispiel mehrere Jahre oder Gewinne von Jahren, Veröffentlichungstypen oder Unterkohegionen, die Themenbereiche anzeigen. Ein Besucher kann auf diese klicken, um die Bibliographie schnell zu filtern.
- Konfigurieren Sie die oben angezeigten Abkürzungen mit der Variablen show_shortcuts. "Sammlung", "Typ", "Jahr", "Veranstaltungsort", "Venue_short" und "Tags" sind zusätzlich zu feinkörnigen Wertenlisten, die Sie mit der Funktion ShortCut () erstellen können. Sie können die Liste der Werte oder Bereiche (jahrelang), ihre Bestellung und einige Filters angeben, um nur die häufigsten zu zeigen. Ein detailliertes Beispiel finden Sie unter Einstellungen. Beispiel.py.
- Es gibt mehrere weitere Optionen. Siehe erneut Einstellungen_example.py.
Bereitstellung auf einer Website
- Laden Sie den Site -Ordner oder seinen Inhalt an einen öffentlichen Ort auf Ihrem Webserver hoch. Standardmäßig /Seite /... ist die angenommene URL.
So generieren Sie HTML und fügen Sie es in eine Website ein:
- Führen Sie Zot.py einmal/auf Demand aus oder installieren Sie als Cron -Job oder -Dienst auf einem Server nicht mehr als einmal am Tag. Konfigurieren Sie es direkt in Zot.py oder in einer separaten Dateieinstellungen.py, um das Upgrade einfach zu erstellen.
- Fügen Sie die resultierende Datei Zotero-bib.html (oder wie konfiguriert) in Ihre Website ein, wie Sie es für fit sehen. Sie können auch einzelne Sammlungsdateien einbeziehen, die ebenfalls generiert werden. Sie können Zot.py konfigurieren, um ein vollständiges HTML -Dokument oder nur einen Teil davon zu generieren. ZOT_BIB_WEB generiert HTML5 -Inhalte.
- Stylen Sie Ihre Bibliographie mit CSS. Eine Beispielstildatei ist enthalten (siehe Site/ Verzeichnis).
WordPress -Unterstützung
Dieses Paket kann direkt auf eine WordPress -Site drücken. Ein separates Programm "Push.Py" ist dazu enthalten.
Folgen Sie folgenden Schritten:
- Richten Sie Zot.py ein, um eine Bibliographie zu generieren, die Sie mögen. Rufen Sie zot.py an-Full, um eine vollständige Zotero-bib.html-Datei für Debugging-Zwecke zu generieren. Konfigurieren Sie Einstellungen.py, um den vollständigen HTML -Code nicht zu generieren.
- Installieren Sie das WPAutop-Control-Plugin (oder ein ähnliches Plugin), um sicherzustellen, dass WP keine Absatzbrüche an verschiedenen Stellen in der Bibliographie einfügt. Mit diesem Plugin müssen Sie der im nächsten Schritt erstellten Seite ein "benutzerdefiniertes Feld" hinzufügen (wählen Sie "Bildschirmoptionen" oben in der Seitenansicht, aktivieren Sie benutzerdefinierte Felder. Suchen Sie dann ganz unten auf der Seite benutzerdefinierte Felder und fügen Sie ein "WPAUTOP" -Feld mit Wert "no" hinzu.
- Erstellen Sie eine WP -Seite oder einen Beitrag für die Bibliographie. Einfügen [ZOT_BIB_WEB Collection], wo Sie die Bibliographie einfügen möchten. Ersetzen Sie die Sammlung durch die ID der Sammlung. (Weitere Optionen: Siehe Push.py)
- Kopieren Sie den Stylesheet -Inhalt (in Site/) in Ihr WordPress -Thema (wählen Sie "Editor" oder "zusätzliche CSS").
- Konfigurieren Sie die Einstellungen.py, damit JQuery und andere Dateien auf dem Webserver verfügbar sind. Normalerweise wäre dies jQuery_path = "../wp-includes/js/jquery/jquery.js" clipboard.js und clippy.svg: Sie können auf eine öffentliche URL verweisen oder die Dateien selbst bedienen.
- Configure push.py (oben). Sie müssen einige einfache Details zu Ihrer WP -Installation kennen.
- Run Push.py regelmäßig oder auf Nachfrage. Es ruft Zot.py automatisch auf und aktualisiert dann die Seite in WP.
