Dockerdemo Hugo

Anbei ein Beispiel, wie eine Docker Umgebung für die Entwicklung mit dem Hugo Static Page Generator genutzt werden kann.

Vorteile

• auf den lokalen Systemen muss kein Hugo, kein Go und weitere Abhängigkeiten installiert sein
• definierte Umgebung für alle Developer
• definierte Umgebung für den späteren Betrieb
• bei großen Projekten wird lokaler Festspeicher nur temoprär gebraucht

Nachteile

• höhere Abstraktion und damit Intransparenz der Umgebung
• Entwicklungstools wie gulp, npm etc. werden trotzdem lokal benötigt

Getting Started

Prerequisites

Damit der ganze Spaß läuft, müssen auf der Maschine folgende Komponenten vorhanden sein:

• NodeJS
• npm
• Docker

Repo clonen

git clone [email protected]:th-koeln/mi-bachelor-webdevelopment-docker.git
cd mi-bachelor-webdevelopment-docker

ggf. NPM installieren

npm install

Docker Container bauen

npm run dh-build

Docker Container starten

npm run dh-serve

Docker Container löschen

npm run dh-remove

Development

Gulp

Taskrunner im Watchmode laufen lassen via npm run gulp

Verzeichnisstruktur

/site
  /archetypes ..... nicht relevant
  /content ........ Inhalte als Markdown Files und Media Assets
  /docs ........... ausgespielte Inhalte
  /resources ...... generierte Media Derivate
  /src/* .......... Quellverzeichnis für SASS, JS, etc. die noch kompiliert werden sollen
  /static/* ....... Quellverzeichnis für alles, was nicht kompiliert werden soll
  /themes/cda ..... Templates und SASS Files für das Lucas Cranach Digital Archive
    /_default ..... Default Templates
    /partials ..... Partials(Templateschnippsel)
      /m/* ........ Moleküle
      /system/* ... übergreifende Layout Schnippsel
      /functions/*  funktionale Layout Schnippsel
    /patternlab/* . Templates zur Darstellung der PatternLib
    /shortcodes/* . Templates die in Markdown Files eingesetzt werden können