search

UB-Mannheim / zotkat

Erweiterung von Zotero für die Katalogisierung
GNU Affero General Public License v3.0
45 stars 20 forks source link
cataloguing code4lib libraries wikicite zotero

readme

🇺🇸 English version (click here) ## What is zotkat? Zotkat `[:tzo:tkat]` is an extension of Zotero for cataloguing in a broad sense and contains also some experimental approaches. ## How can I install an additional export translator from zotkat? 1. Install [Zotero](https://www.zotero.org/) 2. Go to the [Zotero Data Directory Location](https://www.zotero.org/support/preferences/advanced) (usually in your Firefox profile) and then to the subfolder `translators` 3. Copy the raw (!) text file of the additional export translator from zotkat 4. Restart Zotero and/or Firefox 5. Go to `Preferences...` > `Export` > `Default Output Options` and choose the new export translator there (if this list is empty or the option does not occur there then close the preferences dialog and open it again) ## Which translators exist? Currently, zotkat has the following additional Zotero Translators: * [`BIBFRAME.js`](https://raw.githubusercontent.com/UB-Mannheim/zotkat/master/BIBFRAME.js) : This is a import translator with the goal to save data in the BIBFRAME format into Zotero. Ideally this translator would be extended to an import/export translator. * [`MARC21XML.js`](https://raw.githubusercontent.com/UB-Mannheim/zotkat/master/MARC21XML.js) : This is an export translator with the goal to save data from Zotero in the MARCXML format. Ideally one would integrate this into the existing import translator for MARCXML, cf. [https://github.com/zotero/translators/issues/762](https://github.com/zotero/translators/issues/762). * [`PicaSWB.js`](https://raw.githubusercontent.com/UB-Mannheim/zotkat/master/PicaSWB.js) : This is a export translator with the goal data from Zotero to save in the Pica format as it is used in the SWB union cataloguing and then for example import it in the WinIBW client. See also this German article [LIBREAS #29](http://libreas.eu/ausgabe29/05kim/). * [`PicaGBV.js`](https://raw.githubusercontent.com/UB-Mannheim/zotkat/master/PicaGBV.js) : This is an export translaot with the goal to save data from Zotero in the Pica format as it is used in the GBV union cataloguing. the translator is adjusted for the use case to catalogue chapters from ebooks. * [`Wikidata QuickStatements.js`](https://raw.githubusercontent.com/UB-Mannheim/zotkat/master/Wikidata%20QuickStatements.js) : This is an export translator with the goal to save data from Zotero in the input format of the Quickstatement tools. * [`Zotero JSON.js`](https://raw.githubusercontent.com/UB-Mannheim/zotkat/master/Zotero%20JSON.js) : This export translator is mainly for testing purposes and outputs the entries as serialized JSON objects from Zotero. ## How can I report an error or correct it? Everyone can report errors here directly by opening an [issue](https://github.com/UB-Mannheim/zotkat/issues). Moreover, feature requests can be discussed there. Any changes of a translator can be suggested by a pull request directly on GitHub. A more detailed description (in German) can be found on this [wiki page](https://github.com/UB-Mannheim/zotkat/wiki). ## Licenses * All translators are licensed under [AGPL 3.0](https://github.com/UB-Mannheim/zotkat/blob/master/LICENSE) as it is usual for Zotero translators. * The bash script is simply CC0. * The README here is CC-BY and all original texts and pictures in the wiki can be reused as CC0/CC-BY.
🇩🇪 Deutsche Version ## Was ist zotkat? Zotkat ist eine Erweiterung von Zotero für die Katalogisierung und enthält auch experimentelle Ansätze. Allgemein soll Katalogisierung hier breit gefasst werden und auch weitere Arbeiten mit Metadaten umfassen. Beispielsweise kann die Zotero-Erweiterung beim Katalogisieren von Zeitschriftenaufsätzen in FID-Bibliotheken zum Einsatz kommen oder beim Umwandeln von Metadaten für einen Discovery-Index. ## Wie installiert man die zusätzlichen Translator von zotkat? 1. [Zotero](https://www.zotero.org/) installieren 2. Navigiere zum [Zotero-Speicherort](https://www.zotero.org/support/de/preferences/advanced#speicherort) (meist im Fireofx Profil Ordner) und dann zum Unterordner `translators` 3. Den entsprechende Translator Datei hier als Textdatei kopieren. Wichtig ist dass man die "raw" Version und somit die Textversion der Datei kopiert und nicht die HTML-Version. 4. Zotero und/oder Firefox neu starten 5. Unter `Einstellungen ...` > `Export` > `Standard Output Optionen` die neue Export-Möglichkeit auswählen (falls diese Liste leer ist oder die neue Option nicht aufgelistet ist, dann kann man versuchen das Einstellungsfenster zu schließen und erneut zu öffnen) ## Welche Dateien gibt es? Momentan bietet zotkat folgende zusätzliche Zotero Translator an: * [`BIBFRAME.js`](https://raw.githubusercontent.com/UB-Mannheim/zotkat/master/BIBFRAME.js) : Hierbei handelt es sich momentan um einen Import-Translator mit dem Ziel bibliographische Metadaten im BIBFRAME Format in Zotero zu speichern. Idealerweise würde man daraus einen Import/Export-Translator machen um beide Richtungen zu unterstützen. * [`MARC21XML.js`](https://raw.githubusercontent.com/UB-Mannheim/zotkat/master/MARC21XML.js) : Hierbei handelt es sich um einen Export-Translator mit dem Ziel aus Zotero auch Daten im MARCXML-Format zu speichern. Idealerweise würde man dies mit dem bereits bestehenden Import-MARCXML-Translator kombinieren vgl. auch [https://github.com/zotero/translators/issues/762](https://github.com/zotero/translators/issues/762). * [`PicaSWB.js`](https://raw.githubusercontent.com/UB-Mannheim/zotkat/master/PicaSWB.js) : Hierbei handelt es sich um einen Export-Translator mit dem Ziel aus Zotero die Daten ins Picaformat des SWBs zu transformieren und beispielsweise in den WinIBW-Client als Ausgangsbasis zu benutzen. Näheres dazu im [LIBREAS Artikel](http://libreas.eu/ausgabe29/05kim/). * [`PicaGBV.js`](https://raw.githubusercontent.com/UB-Mannheim/zotkat/master/PicaGBV.js) : Hierbei handelt es sich um einen Export-Translator mit dem Ziel bibliographische Daten aus Zotero ins Picaformat des GBV zu transformieren. Angepasst ist er für den Anwendungsfall: Aufsatzkatalogisierung von Buchkapiteln aus E-Books. * [`Wikidata QuickStatements.js`](https://raw.githubusercontent.com/UB-Mannheim/zotkat/master/Wikidata%20QuickStatements.js) : Hierbei handelt es sich um einen Export-Translator welcher Einträge aus Zotero in das Eingabeformat des Quickstatements-Tool transformiert. * [`Zotero JSON.js`](https://raw.githubusercontent.com/UB-Mannheim/zotkat/master/Zotero%20JSON.js) : Dieser Export Translator ist vorallem zum Testen und liefert serialisierte JSON Objekte von Zotero aus. ## Wie kann ich einen Fehler korrigieren oder melden? Alle können hier direkt Fehler melden und dazu einfach einen [Issue](https://github.com/UB-Mannheim/zotkat/issues) aufmachen. Ebenfalls können dabei weitere Funktionalitäten gewünscht werden. Anpassungen an die Translator können über Pull Request direkt in GitHub gemacht werden. Eine genauere Beschreibung befindet sich auf der [Wiki-Seite](https://github.com/UB-Mannheim/zotkat/wiki). ## Lizenzen * Alle Translators sind unter [AGPL 3.0](https://github.com/UB-Mannheim/zotkat/blob/master/LICENSE) lizenziert wie es üblicherweise für Zotero Translator auch der Fall ist. * Das Bash Skript ist einfach CC0. * Das README hier ist CC-BY und alle originären Texte und Bilder im Wikis können unter CC0/CC-BY weiter verwendet werden.
🇫🇷 Version française (cliquez ici) ## Qu'est-ce que zotkat ? Zotkat `[:tzo:tkat]` est une extension de Zotero pour le catalogage au sens large et contient des **éléments** pour travailler les métadonnées. Cette extension peut par exemple servir au catalgage dans les centres de documentation spécialisés et bibliothèques ou à la conversion des métadonnées pour leur ajout dans l'index d'un outil de découverte. ## Comment puis-je installer les exports additionnels de zotkat ? 1. Installez [Zotero](https://www.zotero.org/) 2. Ouvrez le [répertoire de données de Zotero](https://www.zotero.org/support/fr/preferences/advanced) et rendez-vous dans le sous-dossier `translators` (convertisseurs) 3. Copiez les fichiers javascript (pas la version HTML) des convertisseurs de zotkat 4. Redémarrez Zotero 5. Allez dans les `Préférences...` > `Exportation` > `Format par défaut` et choisissez le nouveau convertisseur à cet endroit-là (si la liste est vide ou si les nouvelles options n'apparaissent pas, fermez et rouvrez les préférences) ## Quel convertisseur existe ? Actuellement, zotkat comprend les convertisseurs suivants: * [`BIBFRAME.js`](https://raw.githubusercontent.com/UB-Mannheim/zotkat/master/BIBFRAME.js) : Il s'agit d'un convertisseur dont le but est d'enregistrer les données dans le format BIBFRAME dans Zotero. Idéalement, ce convertisseur devrait être étendu pour offrir des fonctions d'import et d'export. * [`MARC21XML.js`](https://raw.githubusercontent.com/UB-Mannheim/zotkat/master/MARC21XML.js) : Il s'agit d'un convertisseur d'export dont le but est d'enregistrer les données de Zotero au format MARCXML. Idéalement, cela devrait être intégrer dans le convertisseur existant pour MARCXML (cf. [https://github.com/zotero/translators/issues/762](https://github.com/zotero/translators/issues/762)). * [`PicaSWB.js`](https://raw.githubusercontent.com/UB-Mannheim/zotkat/master/PicaSWB.js) : Il s'agit d'un convertisseur d'export dont le but est d'enregistrer les données de Zotero au format Pica tel qu'il est utilisé dans le réseau des bibliothèques du sud-ouest de l'Allemagne (Südwestdeutschen Bibliotheksverbundes - SWB) et être p. ex. importer dans le client WinIBW. Voir aussi l'article paru dans [LIBREAS #29](http://libreas.eu/ausgabe29/05kim/) (en allemand). * [`PicaGBV.js`](https://raw.githubusercontent.com/UB-Mannheim/zotkat/master/PicaGBV.js) : Il s'agit d'un convertisseur d'export dont le but est d'enregistrer les données de Zotero au format Pica tel qu'il est utilisé dans le catalgue commun des bibliothèques allemandes (Gemeinsamer Bibliotheksverbund - GBV). Ce convertisseur est adapté pour le cas particulier du catalogage les chapitres d'ebooks. * [`Wikidata QuickStatements.js`](https://raw.githubusercontent.com/UB-Mannheim/zotkat/master/Wikidata%20QuickStatements.js) : Il s'agit d'un convertisseur d'export dont le but est d'enregistrer les données de Zotero au format nécessaire à l'outil d'import [Quickstatement](https://tools.wmflabs.org/wikidata-todo/quick_statements.php) de Wikidata. * [`Zotero JSON.js`](https://raw.githubusercontent.com/UB-Mannheim/zotkat/master/Zotero%20JSON.js) : Ce convertisseur est principalement présent pour faire des tests et sérialiser les exports sous forme d'objets JSON depuis Zotero. ## Comment signaler une erreur ou la corriger ? Tout le monde peut signaler des erreurs ici en ouvrant une *[issue](https://github.com/UB-Mannheim/zotkat/issues)*. Les demandes de fonctionnalités peuvent également être discutées ici. Toute modification d'un convertsieeur peut être proposée en faisant une *pull request* directement sur GitHub. Une description plus détaillée peut être trouvée sur le [wiki](https://github.com/UB-Mannheim/zotkat/wiki) (en allemand). ## Licences * Ces convertisseurs sont publiés sous licence [AGPL 3.0](https://github.com/UB-Mannheim/zotkat/blob/master/LICENSE) comme le sont tous les convertisseurs de Zotero. * Le script bashest simplement publié sous licence CC0. * Le présent fichier README est publié sous licence CC-BY et tous les textes et images originaux du wiki peuvent être réutilisés sous les termes des licences CC0/CC-BY.