Über das Projekt

Hintergrund und Ziele

Das Projekt Open HealthStat Edu entstand als CAS-Projekt zum Kompetenznachweis im Rahmen des CAS Hochschuldidaktik der Berner Fachhochschule des Lehrgangs 2024/2025. Das Projekt hatte als primäres Ziel, ein Konzept zu entwickeln um Lehr- und Lerninhalte als Open Educational Resources (OER) unter der OER Policy der BFH kollaborativ zu erarbeiten, zu pflegen und zu veröffentlichen. Die aktuelle Version hat zum Zweck eine mögliche Good Practice zu demonstrieren und fokussiert auf quantitative Methoden und Statistik die am Departement Gesundheit der Berner Fachhochschule in Lehre und Forschung Verwendung finden. Die Open HealthStat Edu Plattform zeigt mit dem heutigen Stand mögliche Lösungen für verschiedene Anwendungsfälle auf und soll eine Basis bilden um künftig Kurse aus den BSc und MSc Studiengängen sowie angewandtes Wissen zur Statistik im Bereich der Gesundheitsprofessionen frei verfügbar zu machen.

Die Open HealthStat Edu Plattform soll ebenfalls eine Lernumgebung für jene Personen darstellen, die zum Inhalt der Plattform beitragen oder den Quellcode für eine eigene Plattform weiterverwenden wollen.

Zielgruppen

Open HealthStat Edu hat verschiedene Zielgruppen. Einerseits sind dies Personen, welche die Inhalte der Plattform im Rahmen ihrer Ausbildung oder Weiterbildung nutzen (Consumers). Weiter sind es die in die Statistiklehre am Departement G involvierten Lehrpersonen, welche die Plattform in der Lehre nutzen und Inhalte beisteuern (Contributors). Zudem können es Personen sein, welche den Quellcode in eigenen Projekten/Plattformen weiterverwenden wollen oder zur Weiterentwicklung der Plattform Open HealthStat Edu beitragen (Developers).

Consumers

Die Consumers können Studierende der BFH aber auch Personen von ausserhalb der BFH sein, welche sich im Bereich Statistik für Gesundheitsprofessionen weiterbilden möchten. Für sie gelten die Vorkenntnisse welche als Eintrittskompetenzen für die entsprechenden Bachelor- und Masterstudiengänge vorausgesetzt werden. Die Consumers greifen auf die über die Plattform geteilten Inhalte wie eBooks, Screencasts und Vorlesungs- und Übungsunterlagen zu. Die Studierenden erwerben sich über die Inhalte und die in den Curricula der verschiedenen Studiengänge enthaltenen Lehrveranstaltungen die zur Erlangung ihrer Studienabschlüsse geforderten Kompetenzen in Statistik. An der BFH nicht immatrikulierte Personen, können sich im Selbststudium mit den Inhalten, eigenständig Wissen in Statistik aneignen.

Contributors

Die Contributors sind Personen, welche in der Statistiklehre am Departement Gesundheit in den Bachelor- und Masterstudiengängen tätig sind. Sie entwickeln, teilen und unterhalten die Inhalte von Open HealthStat Edu. Die Contributors können PhD-Studierende, wissenschaftliche Mitarbeitende oder Dozierende sein, welche ihr Fachwissen und ihre Kompetenzen zur Hochschullehre beisteuern. Als Voraussetzung für ihre Aufgaben müssen sie entsprechende Expertise im Gebiet der Statistik und Methodik-Didaktik mitbringen. Je nach ihrer Rolle in der Lehre, tragen die Personen mehr oder weniger Verantwortung für den Inhalt von Open HealthStat Edu. Contributors müssen über folgende Kompetenzen verfügen:

  • Anwenden von Versionskontrolle mit Git für die Kollaboration auf GitHub und dem BFH-internen Gitlab.
  • Anwenden von R und RStudio.
  • Anwendung von Quarto und der Markdown Auszeichnungssprache zum Generieren von dynamischem Inhalt in Unterrichtsunterlagen und Übungen.
  • Erstellen und Veröffentlichen von Lernvideos (Screencasts)

Developers

Die Developers sind Personen von innerhalb oder ausserhalb der BFH, welche den Quellcode der Plattform weiterverwenden und weiterentwickeln wollen. Developers, welche in der Statistiklehre am Departement Gesundheit in den Bachelor- und Masterstudiengängen tätig sind, entwickeln Open HealthStat Edu weiter. Im Vergleich mit den Contributors müssen die Developers über folgende Kompetenzen verfügen:

  • Erstellen von neuen GitHub Repositories mit GitHub Pages.
  • Grundverständnis für Continuous Integration.
  • Grundverständnis für die Funktionsweise und die Erstellung einer statischen Website (html und CSS).
  • Anwendung des Hugo Frameworks zur Generierung von statischen Websiten lokal auf einem Rechner und remote auf einem Server.

How To für Contributors

GitHub ist eine Plattform zur kollaborativen und offenen Softwareentwicklung und wird genutzt um den Inhalt dieser Website zu entwickeln und unterhalten. Contributors müssen über einen eigenen GitHub Account verfügen um Inhalte beitragen zu können und müssen von Eigentümer des GitHub-Projekts berechtigt werden. Interessierte Personen wenden sich dafür an den Initiator des Projekts, Patric Eichelberger von der Berner Fachhochschule.

Git

Inhalte können nur zum Projekt beigetragen werden, wenn diese mit dem Versionskontrollsystem Git verwaltet werden. Git ist ein Softwarepaket, welches lokal auf dem Rechner installiert werden muss und wird benutzt um Inhalte von einem Projekt auf GitHub zu holen, zu verändern und wieder zu publizieren. Zur Installation und zur Verwendung mit GitHub finden sich zahlreiche Anleitungen und Tutorials im Internet. Am einfachsten geht es wenn man sich einen Git-Client zu Hilfe nimmt. GitHub Desktop ist eine einfache und frei verfügbare Variante für Nutzer von Mac und Windows.

Markdown zur Erstellung von Inhalten

Die Inhalte dieser Website sind fast ausschliesslich mit der Auszeichnungssprache Markdwon geschrieben. Eine Markdown Datei ist eine Textdatei mit der Endung .md und kann mit einem einfachen Texteditor bearbeitet werden. Einen solchen stellt jedes Betriebssystem in der Basisausstattung zur Verfügung. Unter Windows ist das Beispielsweise Windows Notepad, unter Mac TextEdit. Wer viel mit einfachen Textdateien arbeitet, ist gut beraten mit einem Texteditor mit etwas umfangreicheren und erweiterbaren Funktionalitäten zu arbeiten. Empfehlenswert ist beispielsweise Visual Studio Code, welcher für Windows, Mac und Linux Betriebsysteme frei verfügbar ist. Visual Studio Code hat einen Git-Client integriert, was praktisch ist wenn man mit Git arbeitet. Um das Schreiben mit Markdown zu lernen gibt es im Internet zahlreiche Ressourcen. Markdown Guide ist eine gute Anlaufstelle.

Inhaltsstruktur

Die Struktur der Website geht aus der Struktur und den Inhalten (.md Dateien) des Verzeichnisses content im GitHub Projekt hervor.

      • _index.md
            • _index.md
          • Der Inhalt dieser Seite (About) findet sich zum Beispiel in content/about/_index.md. Mehr Informationen zum Aufbau der Website befinden sich unten in How To für Developers.

            Einbettung von PDFs

            PDFs können folgendermassen eingebunden werden:

            {{< pdf "/downloads/bsc/PHY_LE1_DeskrStat.pdf" >}}

            Das einzubindende Dokument PHY_LE1_DeskrStat.pdf ist im Beispiel im Unterverzeichnis static/downloads/bsc abgelegt.

            ℹ️
            Das Verzeichnis static ist nicht mit anzugeben, da dies das Standardverzeichnis in der Website Root ist, von wo aus nach Dokumenten gesucht wird.

            Einbettung von Youtube Videos

            {{< youtube 9j_OYIy0bUk >}}

            Der Wert 9j_OYIy0bUk entspricht der Youtube Video ID, welche in der URL des Videos auf Youtube enthalten ist und das Video refernziert (hier : https://www.youtube.com/watch?v=9j_OYIy0bUk).

            Einbindung von Ressourcen

            Wenn für Übungen zum Beispiel Daten-Dateien zur Verfügung gestellt werden, können diese wie folgt als Download eingebettet werden:

            <a href="/open-healthstat-edu/downloads/bsc/MMs.csv" download>MMs.csv</a>

            MMs.csv

            Im gezeigten Beispiel ist die komma-separierte Textdatei MMs.csv im Unterverzeichnis static/downloads/bsc abgelegt.

            ℹ️
            Das Verzeichnis static ist nicht mit anzugeben, da dies das Standardverzeichnis in der Website Root ist, von wo aus nach Dokumenten gesucht wird.
            ⚠️
            Die Subdomain open-healthstat-edu muss hier momentan noch mit angegeben werden, wenn mit dem HTML <a> Tag Downloadlinks gesetzt werden.

            Einbindung von Übungen mit Quarto

            Quarto ist ein Open-Source System zur Veröffentlichung von wissenschaftlichen und technischen Inhalten. Mit Quarto können beispielsweise dynamische Berichte mit Hilfe der Statistik-Programmiersprache R und Markdown erstellt und von einer Quelle in verschiedene Ausgabeformate gerendert werden (z.B. in eine Webseite oder in ein PDF- oder MS Word Dokument). Quarto muss lokal installiert werden, wofür sich verschiedene Tutorials direkt auf der Quarto Website anbieten. Ein Beispiel für einen Quarto-Inhalt befindet sich auf dieser Website unter BSc > Übungen Overall. Die Quelldatei hierfür ist die Quarto Datei index.qmd

              • _index.md
                  • index.qmd
                  • _index.md
                • Die gerenderte Ausgabe durch Quarto von index.qmd ist eine Webseite, welche statischen und durch R dynamisch generierten Inhalt (z.B. Grafiken) enthält. Weitere Informationen zm Einbinden von Quarto Output befinden sich unten in How To für Developers.

                  How To für Developers

                  Hugo Framework

                  Die Webseite nutzt das Hugo Frameworks zur Generierung von statischen Webseiten. Die Inhalte werden in Markdown Dateien definiert und die Struktur der Dateiablage bestimmt massgeblich den Aufbau der Website. Hugo ist insgesamt sehr mächtig und kann von einfachen bis zu komplexen Websiteprojekten eingesetzt werden. Als Einstieg für die Arbeit mit Hugo gibt es eine gutes Quickstart Tutorial. Voraussetzung ist, dass ein Installation von Hugo auf dem Rechner vorhanden ist. Ebenso eine Installation von Git (siehe auch oben How To für Contributors).

                  Layout und Erscheinungsbild der Website

                  Das Hugo Framework ist über Themes sehr vielfältig auf verschieden Anwendungsfälle anpassbar. Diese Website nutzt das Theme Hextra. Hextra stellt beispielsweise die Shortcodes zur Einbettung von PDFs oder Youtube Videos bereit. Oder auch die Card Komponenten auf der Homepage von Open HealthStat Edu. Die Handhabung ist auf der Hextra Website recht gut dokumentiert. Geht man in die Details findet man Dinge die wiederum in der offiziellen Dokumentation fehlen. Da lohnt es sich einen Blick in den Quellcode der Beispiels Website von Hextra. Möchte man spezifische Anpassungen am Layout machen, müsste man sich mit Tailwind CSS und der umfangreichen Hugo Dokumentation beschäftigen.

                  Lokales Serving der Hugo Site

                  Klonen des GitHub Repositories:

                  git clone git@github.com:pateibe/open-healthstat-edu.git

                  Soll die Hugo Site lokal betrachtet werden muss vorgängig Hugo auf dem Rechner installiert sein. Ist das der Fall geht das mit:

                  hugo server
                  ⚠️
                  Markdown Dokumente, welche im Header draft = true enthalten (vgl. https://gohugo.io/getting-started/quick-start/#add-content) werden nicht publiziert und damit auch nicht angezeigt.

                  Sollen Entwürfe mit angezeigt werden muss dem Server die -D Option mitgegeben werden:

                  hugo server -D

                  Hugo Site auf GitHub Pages

                  Das Projekt ist so konfiguriert, dass die Hugo Website über GitHub Actions automatisch neu generiert und publiziert wird. Wie das für ein neues Projekt auf GitHub gemacht wird ist auf der Hugo Website ausführlich dokumentiert. Dies müsste jedoch nur gemacht werden, wenn das vorliegende Projekt zu eigenen Zwecken ein einem anderen Repository weiter verwendet würde.

                  Einbindung von Quarto Dokumenten

                  Quarto kann offiziell in Verbindung mit Hugo verwendet werden (https://quarto.org/docs/output-formats/hugo.html) wenn im Dokument Header das Format hugo-md gesetzt wird. Der Ablauf ist dann der, dass zuerst die Quarto Dokumente gerendert (aus .qmd werden .md Dateien für Hugo generiert) und anschliessend die Hugo Site generiert wird. Die Erfahrung hat gezeigt, dass dies nur mit Abstrichen funktioniert. Der grosse Nachteil ist, dass Hugo (und das Hugo Theme) das Rendering von Quarto “übergehen”. Es ist also nicht möglich zum Beispiel ein Quarto Buch Projekt innerhalb Hugo “schön” zu rendern. Die bessere Option hier ist also, Dokumente wo man explizit das Rendering von Quarto braucht, auf einem separaten Repository zu publizieren. So ist es beispielsweise mit dem Demobuch gelöst, welches über eine GitHub Action aus dem GitHub Repository generiert wird, sobald die Inhalte auf das Repository gepusht werden.

                  Lizenz

                  CC-BY-SA

                  This work is licensed under a Creative Commons Attribution-ShareAlike 4.0 International License

                  OER Plattform Statistik für Gesundheitsprofessionen

                  Patric Eichelberger, Nathanael Lutz, Lukas Stammler, André Meichtry

                  BFH Gesundheit, 5. Mai 2025, lizenziert unter CC BY-SA 4.0 International

                  Credits

                  • Header logo “education” by Vinchi Chyla from Noun Project (CC BY 3.0)
                  Zuletzt aktualisiert am