3.7. Publikation auf Zenodo#
Zenodo[1] bietet eine Integration mit GitHub an, über die eine Publikation eines bestimmten Zustandes (commit) eine GitHub-Repositoriums möglich ist.
Fig. 3.3 Zugriff auf die GitHub-Integration
ist im Profil-Menü oben rechts hinterlegt.#
Für die Integration muss eine Person mit genügend Rechten im GitHub-Repositorium eine Verbindung zwischen ihrem Zenodo-Account und ihrem GitHub-Account herstellen. Öffnen Sie dazu das Menü rechts oben über den Pfeil neben Ihrem Account-Namen und wählen Sie dort GitHub aus (siehe Fig. 3.3). Folgen Sie den Anweisungen zum Verknüpfen der Accounts.
Sind die Accounts verknüpft, so sehen Sie eine Anleitung, wie ein Repositorium nach Zenodo importiert werden kann. Auf die Schritte wird hier nochmals eingegangen:
Vorbereitung des Repositoriums
Aktivierung der Integration für ein bestimmtes Repositorium
Erstellung eines Releases in GitHub
Überprüfung der Metadaten in Zenodo
3.7.1. Vorbereitung des Repositoriums#
Zenodo hat verschiedene Möglichkeiten, Metadaten aus dem Repositorium zu extrahieren und für den Eintrag auf Zenodo zu nutzen. In QUADRIGA nutzen wir die Datei CITATION.cff[2], welche es erlaubt die Metadaten im Repositorium zu definieren. Diese Datei wird auch von GitHub und anderen Werkzeugen genutzt, um Zitationsempfehlungen anzubieten.
CITATION.cff dieses Buches
1# yaml-language-server: $schema=https://citation-file-format.github.io/1.2.0/schema.json
2cff-version: 1.2.0
3version: 0.56.4
4title: 'QUADRIGA OERs: erstellen und gestalten mit Jupyter Book. QUADRIGA Open Educational
5 Resources: Template'
6abstract: Dieses Buch ist einerseits ein Template für die Erstellung von OERs nach
7 den Empfehlungen von QUADRIGA (https://quadriga-dk.de) und andererseits eine OER
8 für die Entwicklung von OERs entsprechend der QUADRIGA Empfehlungen.
9type: software
10message: Please cite this software using the metadata from `preferred-citation` in
11 `CITATION.cff`.
12authors: &id001
13- given-names: Hannes
14 family-names: Schnaitter
15 orcid: https://orcid.org/0000-0002-1602-6032
16 affiliation: Humboldt-Universität zu Berlin, Institut für Bibliotheks- und Informationswissenschaft
17- given-names: Evgenia
18 family-names: Samoilova
19 orcid: https://orcid.org/0000-0003-3858-901X
20 affiliation: Universität Potsdam
21- given-names: Lamia
22 family-names: Islam
23 affiliation: Universität Potsdam
24identifiers:
25- type: doi
26 value: 10.5281/zenodo.14970672
27 description: Zenodo
28repository-code: https://github.com/quadriga-dk/Book_Template
29url: https://quadriga-dk.github.io/Book_Template/
30keywords:
31- open educational resource
32license: CC-BY-SA-4.0
33references:
34- title: Jupyter Book
35 type: software
36 authors:
37 - name: The Jupyter Book Community
38 website: https://github.com/jupyter-book/jupyter-book/graphs/contributors
39preferred-citation:
40 year: '2025'
41 version: 0.56.4
42 authors: *id001
43 title: 'QUADRIGA OERs: erstellen und gestalten mit Jupyter Book. QUADRIGA Open Educational
44 Resources: Template'
45 type: book
46 doi: 10.5281/zenodo.14970672
47 url: https://quadriga-dk.github.io/Book_Template/
48 repository-code: https://github.com/quadriga-dk/Book_Template
49 license: CC-BY-SA-4.0
50 languages:
51 - deu
52 copyright: CC-BY-SA-4.0
53 keywords:
54 - Open Educational Resource
3.7.2. Aktivierung der Integration für ein bestimmtes Repositorium#
Fig. 3.4 Deaktiverter und aktivierter Schalter für
den Import neuer Releases in Zenodo.#
Für jedes Repositorium, für das Sie genügend Rechte haben, können Sie entscheiden, ob Sie neue Releases nach Zenodo importieren wollen (siehe Fig. 3.4 unten) oder nicht (siehe Fig. 3.4 oben).
Nutzen Sie diese Funktion, wenn Sie bspw. temporär neue Releases nicht in Zenodo übernehmen wollen.
3.7.3. Erstellung eines Releases in GitHub#
Fig. 3.5 Anzeige des aktuellsten Releases
auf der Hauptseite eines
Repositoriums.#
Releases in GitHub werden über einen tag spezifiziert. Diesen Tag können Sie entweder per git tag[3] festlegen, oder Sie legen beim Erstellen des Releases einen Tag an.
GitHub-Releases-Unterseite#
Klicken Sie entweder auf der Hauptseite des Repositoriums rechts auf Releases (siehe Fig. 3.5) oder oben neben der Auswahl der Branches auf Tags. Stellen Sie auf der nächsten Seite sicher, dass Releases ausgewählt ist.
Auf der Releases-Seite werden ggf. existierende Releases angezeigt, welche Sie auch durchsuchen können. Über die Schaltfläche Draft a new release können Sie einen neuen Release erstellen (siehe Fig. 3.6).
Fig. 3.6 Menüleiste der Releases-Seite mit der Schaltfläche zur Erstellung eines neuen Releases#
Beachten Sie bei der Erstellung eines neuen Releases die Hinweise in Fig. 3.7. Unter “Choose a tag” kann ein bestehender Tag ausgewählt oder eine neuer erstellt werden (siehe Warnung unten). Tags, die eine Version repräsentieren, sollten einem Standard folgen. Wir empfehlen für QUADRIGA den Standard Semantic Versioning 2.0.0[4].
Wichtig
Bevor Sie diese Option zur Erstellung eines Tags nutzen, stellen Sie bitte sicher, dass in der Metadaten-Datei (metadata.yml) die Felder book-version und date-of-last-change korrekt sind. In book-version sollte die Version stehen, welche Sie später im Release angeben (ohne das v also book-version: 0.1.2, wenn Sie beim Release v0.1.2 als Tag nutzen). Im date-of-last-change sollte das aktuelle Datum stehen.
Erstellen Sie ggf. einen neuen Commit mit diesen Änderungen und beginnen Sie dann den Prozess der Erstellung eines Releases erneut.
Ein Git Tag kann nicht mit einer Zahl beginnen. Typischerweise beginnen Versionstags mit einem v. Daher empfehlen wir folgendes Format:
v0.1.2
Dann können Sie Veröffentlichungsinformationen (release notes) generieren lassen. Diese müssen ggf. angepasst werden. Der Titel des Releases ist oft eine Wiederholung des Tags, sie können jedoch auch einen sprechenden Namen vergeben. Zu den release notes gehört auch eine Beschreibung der Veränderungen zur letzten veröffentlichten Version.
Ein Release kann als neuester Release markiert werden oder als eine Vorveröffentlichung. Sie können Zwischenstände der Release-Informationen als Entwurf speichern oder den Release veröffentlichen. Veröffentlichen Sie einen Release wird dieser von Zenodo importiert, solange die Importfunktion für das Repositorium aktiviert ist (s.o.). Der Import kann einige Zeit in Anspruch nehmen.
Fig. 3.7 Seite zur Erstellung eines neuen Releases.#
3.7.4. Überprüfung der Metadaten in Zenodo#
Nach einem Release sollten die von Zenodo importierten Informationen überprüft werden. Ggf. müssen Sie in Zenodo und/oder in der Datei CITATION.cff angepasst werden. Änderungen in CITATION.cff werden mit dem nächsten Release-Import übernommen.
Zenodo stellt auch eine sogenannte Badge zur Verfügung. In den Einstellungen der GitHub-Integration wird diese neben dem Repositorium angezeigt. Klicken Sie auf diese, so öffnet sich eine Ansicht, aus der Sie bspw. Markdown-Code kopieren und Ihre README.md einfügen können.