- Kurzbeschreibung
- Finanzierung
- Empfohlenes Server Setup
- Voraussetzungen und Skills
- Installation der Platform (deploy)
- Entwicklung
- Benutzung/Usage
- Beteiligung/Contributing
- Credits
- Lizenz
Das Deutsche Auswandererhaus ist ein kulturhistorisches Museum zum Thema Migration in Bremerhaven. Im Rahmen des deutschlandweiten Förderprojekts »museum4punkt0« sollen neue Formen der digitalen Kommunikation, Partizipation, Bildung und Vermittlung in Museen entwickelt, umgesetzt und evaluiert werden. Das Projektteam des DAHs erarbeitete unter dem Titel »Junge Digitale Sammlung« JDS ein museumspädagogisches Workshop-Angebot für Schulklassen. Der Workshop setzt sich inhaltlich mit den Themenkomplexen Identität und Diversität auseinander, sowie mit der Bedeutung und Handhabung von Objekten im Museum. Teilnehmende Schüler:innen können dabei ihre Alltagsobjekte, die sowohl physisch als auch digital sein können, in 3D scannen oder fotografieren. Diese und weitere Daten zum Objekt werden in eine Datenbank eingegeben und später auf einer Plattform veröffentlicht. Durch die Workshops wird die JDS zu einer umfangreichen Sammlung anwachsen.
Dieses Repository entspricht einem komplexen Theme für Kirby CMS und beinhaltet alle relevanten Dateien (abgesehen vom Kirby CMS Kern).
Das Projekt "O2G - OBJ to GLTF/GLB" ist Teil von diesem Projekt. Die Windows/Mac-Anwendung konvertiert OBJ-Dateien (übliches Format für 3D Scanner) zu GLB oder komprimierten GLTF-Dateien für die Webnutzung. Das Repository finden Sie hier.
Diese Anwendung ist entstanden im Verbundprojekt museum4punkt0 – Digitale Strategien für das Museum der Zukunft, Teilprojekt Deutsches Auswandererhaus – Migrationsgeschichte digital erleben. Das Projekt museum4punkt0 wird gefördert durch die Beauftragte der Bundesregierung für Kultur und Medien aufgrund eines Beschlusses des Deutschen Bundestages.
Weitere Informationen: https://www.museum4punkt0.de
Das Projekt wurde ursprünglich auf folgendem Server installiert:
- Ubuntu 20.04 (Cloudron installiert)
- Apache 2.4.x
- PHP 8.1 mit Standard-Modulen (OPCache deaktivieren)
- vCPU 3 AMD (virtueller Server)
- 4GB RAM
- 80GB Festplatte
Die Größe der Festplatte hängt hauptsächlich von der Menge an Video-Dateien ab, die erwartet wird. 3D-Modelle und -Bilder verbrauchen vergleichsweise wenig Platz.
Die Installation (deployment) der Plattform ist relativ leicht durchzuführen und kann grundsätzlich ohne große technische Kenntnisse erfolgen.
Bevor Sie beginnen, stellen Sie sicher, dass Sie folgende Anforderungen erfüllt haben:
- Ein Server steht Ihnen zur Verfügung.
- Sie haben eine Version vom Kirby-Core Kirby heruntergeladen. Das ursprüngliche Projekt wurde mit Kirby 3.8.3 erstellt. Aus Kompatibilitätsgründen wird empfohlen, diese Version zu verwenden. Alle relevanten Plugins sind in diesem Repository inkludiert. Kirby ist ein Open-Source, lizenzbasiertes CMS-System.
- Sie verfügen über eine Kopie dieses Repositorys.
Hinweise: Für eine bessere Verwaltung der npm Packages wurde das Projekt ursprünglich mit der Software Prepros (Mac, Windows, Linux) und CodeKit (Mac only) entwickelt. Beide bieten eine grafische und bequeme Benutzeroberfläche, um Source-Code zu kompilieren, Packages zu verwalten und Browser zu auto-refreshen. Beide config-Dateien sind in diesem Repository inkludiert (Sie benötigen nur eine der beiden Softwares). Für die Server-Funktion wurde mit MAMP gearbeitet. Alternativ können Sie bspw. einen Webpack Workflow verfolgen, s. bitte kirby-webpack.
Es gelten die gleichen Voraussetzungen wie für die Installation (deployment). Dazu noch:
- Prepros oder CodeKit ist auf Ihrem Rechner installiert (optional können Sie das Webpack Workflow konfigurieren)
- npm ist auf Ihrem Rechner installiert (optional, falls sie Prepros/CodeKit nicht verwenden werden)
- Apache steht auf Ihrem Rechner zur Verfügung, um localhost starten zu können (z.B MAMP, XAMPP, Apache Installation, etc.)
Prepros oder CodeKit?: CodeKit ist eine Mac-only Software, die vergleichsweise performanter ist, aber lizenziert/gekauft werden muss. Prepros bietet eine kostenlose Version an und ist universell.
-
Kirby-Core-Ordner entzippen (s. bitte 4. Voraussetzungen und Skills) und in
kirbyumbenennen (ohne Suffixe). -
Kirby-Core in den Ordner
wwwverschieben. -
Den kompletten Ordner
wwwauf den Zielserver kopieren/hochladen. Wichtig dabei ist, dass der komplette Ordner inkl. versteckter Dateien, bspw. .htaccess, kopiert/hochgeladen wird. -
Anschließend im Browser die Domain oder IP-Adresse besuchen. Die Sammlung sollte erscheinen.
Das Admin-Backend von Kirby erreichen Sie unter /panel, z.B.:
https://meinedomain.de/panel
oder
http://localhost/meinprojekt/www/panel
Der erste Admin ist bereits angelegt. Benutzername und Passwort unbedingt nach dem ersten Einloggen ändern!
Benutzername:
Passwort:
adminadmin
Die Plattform entählt die Home-, Error und Login-Seiten sowie einen Test-Workshop. Test-Datensätze für die Dropdowns wurden auch angelegt.
Für die Weiterentwicklung und/oder Anpassung der verschiedenen Teile des Systems wird Personal mit guten Kenntnissen in PHP, JS und CSS und optimalerweise Kirby CMS empfohlen. Auch mittlere Kenntnisse in der Serveradministration sind empfehlenswert, da eine möglichst reibungslose Kommunikation mit den externen Social-Media Anbietern (embeds) je nach Server bestimmte Anpassungen benötigt.
Zum Starten:
-
Laden Sie eine Kopie dieses Repositorys herunter.
-
Die Plattform wie unter "Installation" installieren.
-
Starten Sie den lokalen Server.
-
In Prepros oder CodeKit das Projekt importieren. Da beide config-Dateien vorhanden sind, können Sie die Packages in dem ausgewählten Programm direkt installieren.
-
Alternativ können Sie die Packages mit dem Befehl
npm installwie üblich installieren. -
Pfad zum localhost-Ordner des Projekts in den Projekt-Einstellungen in Prepros oder CodeKit für die Auto-Refresh Funktion aktualisieren. Dieser sollte zu Ihrem
wwwOrdner zeigen. -
Das Kompilieren von Javascript und SCSS ist bereits in den config-Dateien eingerichtet (Output für kompilierten Dateien ist
www/assets). -
Der Code im Ordner
srckann jetzt bearbeitet werden.
Weitere technische Details und Hinweise finden Sie hier.
Für weitere Prepros-Einstellungen bitte die Prepros-Dokumentation lesen.
Für weitere CodeKit-Einstellungen bitte die CodeKit-Dokumentation lesen.
Die detaillierte Dokumentation finden Sie hier.
Wenn Sie etwas beitragen möchten, forken Sie bitte das Repository und verwenden Sie einen Feature-Fork. Pull Requests sind herzlich willkommen.
Diese Anwendung ist entstanden im Verbundprojekt museum4punkt0 – Digitale Strategien für das Museum der Zukunft, Teilprojekt Deutsches Auswandererhaus - Migrationsgeschichte digital erleben. Weitere Informationen: https://www.museum4punkt0.de.
Das Projekt museum4punkt0 wird gefördert durch die Beauftragte der Bundesregierung für Kultur und Medien aufgrund eines Beschlusses des Deutschen Bundestages.
Auftraggeber und inhaltliches Konzept: Deutsches Auswandererhaus Bremerhaven, Columbusstraße 65, 27568 Bremerhaven
Design: Andreas Heller Architects and Designers, Hamburg
Auftragnehmer Programmierung: 2av GmbH, Keltergasse 3, 89073 Ulm, Ansprechpartner: Jens Döring (Projektkoordination), Santiago Duque (Projektleitung und Entwicklung)
GNU GENERAL PUBLIC LICENSE Copyright © 2022/2023, Deutsches Auswandererhaus / Design: Andreas Heller Architects and Designers, Hamburg; Programmierung: 2av GmbH, Ulm. Please also see the LICENSE file provided within this repository.