Michael Czechowski
1b9b2f315a
223015b: - add WTF hex code explanation slide (89=137 decimal, PNG signature) - add ASCII lead slide with historical context - remove Hilbert-Studie reference from title 223015c termin 2: - add OSI layer 5 (session) and layer 6 (presentation) slides - add URL/domain anatomy slide - mark HTTP/S section as klausur - improve status codes formatting with client/server examples - add CRUD column to HTTP methods table infrastructure: - add dev-server.sh for multi-course development - update generate-index.sh with course-specific colors - add QR codes for slide URLs
225 lines
8.9 KiB
Makefile
225 lines
8.9 KiB
Makefile
# HdM Slides - Unified Makefile
|
|
# Supports multiple courses: 223015b (Dateiformate) and 223015c (Internettechnik)
|
|
|
|
.PHONY: help dev dev-b dev-c build build-b build-c pdf html clean install deploy qr optimize-images
|
|
|
|
# Course configuration
|
|
COURSES = 223015b 223015c
|
|
COURSE_DIR = courses
|
|
|
|
# Port configuration (index starts at BASE_PORT, courses increment from there)
|
|
BASE_PORT = 1310
|
|
INDEX_PORT = $(BASE_PORT)
|
|
|
|
# Course-specific settings
|
|
223015b_NAME = Dateiformate, Schnittstellen, Speichermedien
|
|
223015b_PORT = 1311
|
|
223015b_TERMINS = 2025-12-19-termin-0-intro 2025-12-19-termin-1-grundlagen-text-audio 2026-01-09-termin-2-bild-audio-video 2026-01-23-termin-3-speichermedien-schnittstellen 2026-01-30-termin-4-distribution-apis-zukunft 2026-xx-xx-termin-5-vertiefung-offene-fragen
|
|
223015b_DEPLOY_PATH = /home/tengo/html/hdm/223015b
|
|
|
|
223015c_NAME = Internettechnologien
|
|
223015c_PORT = 1312
|
|
223015c_TERMINS = 2025-12-20-termin-1-geschichte-grundlagen-html 2026-01-10-termin-2-netzwerke-protokolle-css 2026-01-24-termin-3-interaktivitaet-javascript
|
|
223015c_DEPLOY_PATH = /home/tengo/html/hdm/223015c
|
|
|
|
DEPLOY_HOST = tengo@tuttle.uberspace.de
|
|
|
|
# Default target
|
|
help:
|
|
@echo "HdM Slides - Unified Build System"
|
|
@echo ""
|
|
@echo "Courses:"
|
|
@echo " 223015b - Dateiformate, Schnittstellen, Speichermedien"
|
|
@echo " 223015c - Internettechnologien"
|
|
@echo ""
|
|
@echo "Development:"
|
|
@echo " make dev - Both servers + index (ports 1311, 1312, 1313)"
|
|
@echo " make dev-b - Dev server for 223015b (port 1312)"
|
|
@echo " make dev-c - Dev server for 223015c (port 1313)"
|
|
@echo ""
|
|
@echo "Build:"
|
|
@echo " make build - Build all courses"
|
|
@echo " make build-b - Build 223015b only"
|
|
@echo " make build-c - Build 223015c only"
|
|
@echo " make pdf - Export all to PDF"
|
|
@echo " make html - Export all to HTML"
|
|
@echo ""
|
|
@echo "Tools:"
|
|
@echo " make qr URL=... - Generate QR code for URL"
|
|
@echo " make optimize-images COURSE=223015b - Resize images"
|
|
@echo ""
|
|
@echo "Deploy:"
|
|
@echo " make deploy - Deploy all courses"
|
|
@echo " make deploy-b - Deploy 223015b only"
|
|
@echo " make deploy-c - Deploy 223015c only"
|
|
@echo ""
|
|
@echo "Other:"
|
|
@echo " make clean - Remove generated files"
|
|
@echo " make install - Install dependencies"
|
|
|
|
# Ensure build directories exist
|
|
build/.exists:
|
|
@mkdir -p build/223015b build/223015c
|
|
@touch $@
|
|
|
|
# Development servers
|
|
dev:
|
|
@./scripts/dev-server.sh
|
|
|
|
dev-kill:
|
|
@-pkill -f "python3 -m http.server" 2>/dev/null || true
|
|
@-pkill -f "marp-cli.*--server" 2>/dev/null || true
|
|
@sleep 0.5
|
|
|
|
dev-b:
|
|
@echo "Starting 223015b dev server on port $(223015b_PORT)..."
|
|
@echo "Open: http://localhost:$(223015b_PORT)"
|
|
PORT=$(223015b_PORT) npx @marp-team/marp-cli --server $(COURSE_DIR)/223015b/slides/
|
|
|
|
dev-c:
|
|
@echo "Starting 223015c dev server on port $(223015c_PORT)..."
|
|
@echo "Open: http://localhost:$(223015c_PORT)"
|
|
PORT=$(223015c_PORT) npx @marp-team/marp-cli --server $(COURSE_DIR)/223015c/slides/
|
|
|
|
# Build functions
|
|
define build_course
|
|
@echo "Building $(1)..."
|
|
@mkdir -p build/$(1)
|
|
@cp -r $(COURSE_DIR)/$(1)/slides/assets build/$(1)/ 2>/dev/null || true
|
|
@cp -r $(COURSE_DIR)/$(1)/slides/materials build/$(1)/ 2>/dev/null || true
|
|
@for f in $($(1)_TERMINS); do \
|
|
if [ -f "$(COURSE_DIR)/$(1)/slides/$$f.md" ]; then \
|
|
echo " Building $$f..."; \
|
|
npx @marp-team/marp-cli $(COURSE_DIR)/$(1)/slides/$$f.md -o build/$(1)/$$f.html; \
|
|
npx @marp-team/marp-cli $(COURSE_DIR)/$(1)/slides/$$f.md --pdf --allow-local-files -o build/$(1)/$$f.pdf; \
|
|
fi \
|
|
done
|
|
@./scripts/generate-index.sh $(1) build/$(1)
|
|
endef
|
|
|
|
build-b: build/.exists
|
|
$(call build_course,223015b)
|
|
|
|
build-c: build/.exists
|
|
$(call build_course,223015c)
|
|
|
|
build: build-b build-c
|
|
@echo "All courses built!"
|
|
|
|
# HTML only builds
|
|
define html_course
|
|
@echo "Building HTML for $(1)..."
|
|
@mkdir -p build/$(1)
|
|
@cp -r $(COURSE_DIR)/$(1)/slides/assets build/$(1)/ 2>/dev/null || true
|
|
@cp -r $(COURSE_DIR)/$(1)/slides/materials build/$(1)/ 2>/dev/null || true
|
|
@for f in $($(1)_TERMINS); do \
|
|
if [ -f "$(COURSE_DIR)/$(1)/slides/$$f.md" ]; then \
|
|
echo " $$f.html"; \
|
|
npx @marp-team/marp-cli $(COURSE_DIR)/$(1)/slides/$$f.md -o build/$(1)/$$f.html; \
|
|
fi \
|
|
done
|
|
@./scripts/generate-index.sh $(1) build/$(1)
|
|
endef
|
|
|
|
html-b: build/.exists
|
|
$(call html_course,223015b)
|
|
|
|
html-c: build/.exists
|
|
$(call html_course,223015c)
|
|
|
|
html: html-b html-c
|
|
|
|
# PDF only builds
|
|
define pdf_course
|
|
@echo "Building PDFs for $(1)..."
|
|
@mkdir -p build/$(1)
|
|
@for f in $($(1)_TERMINS); do \
|
|
if [ -f "$(COURSE_DIR)/$(1)/slides/$$f.md" ]; then \
|
|
echo " $$f.pdf"; \
|
|
npx @marp-team/marp-cli $(COURSE_DIR)/$(1)/slides/$$f.md --pdf --allow-local-files -o build/$(1)/$$f.pdf; \
|
|
fi \
|
|
done
|
|
endef
|
|
|
|
pdf-b: build/.exists
|
|
$(call pdf_course,223015b)
|
|
|
|
pdf-c: build/.exists
|
|
$(call pdf_course,223015c)
|
|
|
|
pdf: pdf-b pdf-c
|
|
|
|
# QR Code generation (uses nix-shell)
|
|
qr:
|
|
ifndef URL
|
|
@echo "Usage: make qr URL=https://example.com"
|
|
@echo " make qr URL=https://example.com OUTPUT=my-qr.png"
|
|
else
|
|
@nix-shell -p qrencode --run 'qrencode -o $(or $(OUTPUT),qr-code.png) -s 10 "$(URL)"'
|
|
@echo "Generated: $(or $(OUTPUT),qr-code.png)"
|
|
endif
|
|
|
|
# QR code for a slide deck URL
|
|
qr-slides:
|
|
ifndef COURSE
|
|
@echo "Usage: make qr-slides COURSE=223015b"
|
|
else
|
|
@nix-shell -p qrencode --run 'qrencode -o build/$(COURSE)/qr-$(COURSE).png -s 10 "https://librete.ch/hdm/$(COURSE)/"'
|
|
@echo "Generated: build/$(COURSE)/qr-$(COURSE).png"
|
|
endif
|
|
|
|
# Optimize images
|
|
optimize-images:
|
|
ifndef COURSE
|
|
@echo "Usage: make optimize-images COURSE=223015b"
|
|
else
|
|
@echo "Optimizing images for $(COURSE)..."
|
|
@mkdir -p $(COURSE_DIR)/$(COURSE)/slides/assets-original
|
|
@nix-shell -p imagemagick --run 'for img in $(COURSE_DIR)/$(COURSE)/slides/assets/*.png $(COURSE_DIR)/$(COURSE)/slides/assets/*.jpg 2>/dev/null; do \
|
|
[ -f "$$img" ] && cp "$$img" $(COURSE_DIR)/$(COURSE)/slides/assets-original/ && \
|
|
magick "$$img" -resize "1920x>" -quality 85 "$$img" && echo " Optimized: $$(basename $$img)"; \
|
|
done || true'
|
|
@echo "Done! Originals in assets-original/"
|
|
endif
|
|
|
|
# Root index for /hdm/
|
|
HDM_DEPLOY_PATH = /home/tengo/html/hdm
|
|
|
|
build-index: build/.exists
|
|
@echo "Building root index..."
|
|
@echo '<!DOCTYPE html><html lang="de"><head><meta charset="UTF-8"><meta name="viewport" content="width=device-width,initial-scale=1"><title>HdM Vorlesungen</title><style>*{box-sizing:border-box;margin:0;padding:0}body{font-family:-apple-system,BlinkMacSystemFont,"SF Pro Display","Segoe UI",Roboto,sans-serif;max-width:720px;margin:0 auto;padding:3rem 1.5rem;background:#fafafa;color:#1d1d1f;line-height:1.5}h1{font-size:2rem;font-weight:600;letter-spacing:-0.02em;margin-bottom:.5rem}.subtitle{color:#86868b;font-size:1rem}.courses{margin-top:2rem;display:flex;flex-direction:column;gap:.75rem}a.course{display:block;background:#fff;border-radius:12px;padding:1.5rem;text-decoration:none;color:inherit;box-shadow:0 1px 3px rgba(0,0,0,0.08);transition:all .2s ease;cursor:pointer}a.course:hover{transform:translateY(-2px);box-shadow:0 4px 12px rgba(0,0,0,0.12)}.course-label{font-size:.7rem;font-weight:600;text-transform:uppercase;letter-spacing:.05em}.course-b .course-label{color:#5da9e9}.course-c .course-label{color:#d63384}.course-title{font-size:1.15rem;font-weight:500;color:#1d1d1f;margin:.25rem 0}.course-info{font-size:.85rem;color:#86868b}footer{margin-top:2.5rem;padding-top:1.5rem;border-top:1px solid #e5e5e7;color:#86868b;font-size:.85rem}footer a{color:#1d1d1f;text-decoration:none}footer a:hover{text-decoration:underline}</style></head><body><h1>HdM Vorlesungen</h1><p class="subtitle">Wintersemester 2025/26 · Michael Czechowski</p><div class="courses"><a class="course course-b" href="223015b/"><span class="course-label">223015b</span><div class="course-title">Dateiformate, Schnittstellen, Speichermedien & Distributionswege</div><span class="course-info">6 Termine · Modul "Technik 1"</span></a><a class="course course-c" href="223015c/"><span class="course-label">223015c</span><div class="course-title">Grundlagen IT- und Internettechnik</div><span class="course-info">3 Termine · Modul "Technik 1"</span></a></div><footer><a href="mailto:mail@librete.ch">Kontakt</a></footer></body></html>' > build/index.html
|
|
|
|
# Deploy
|
|
define deploy_course
|
|
@echo "Deploying $(1)..."
|
|
scp build/$(1)/*.html $(DEPLOY_HOST):$($(1)_DEPLOY_PATH)/
|
|
scp build/$(1)/*.pdf $(DEPLOY_HOST):$($(1)_DEPLOY_PATH)/ 2>/dev/null || true
|
|
scp -r build/$(1)/assets/ $(DEPLOY_HOST):$($(1)_DEPLOY_PATH)/
|
|
scp -r build/$(1)/materials/ $(DEPLOY_HOST):$($(1)_DEPLOY_PATH)/ 2>/dev/null || true
|
|
@echo "$(1) deployed!"
|
|
endef
|
|
|
|
deploy-b: build-b
|
|
$(call deploy_course,223015b)
|
|
|
|
deploy-c: build-c
|
|
$(call deploy_course,223015c)
|
|
|
|
deploy-index: build-index
|
|
@echo "Deploying root index..."
|
|
scp build/index.html $(DEPLOY_HOST):$(HDM_DEPLOY_PATH)/
|
|
@echo "Root index deployed!"
|
|
|
|
deploy: build-index deploy-b deploy-c deploy-index
|
|
@echo "All courses deployed!"
|
|
|
|
# Clean
|
|
clean:
|
|
@echo "Cleaning generated files..."
|
|
rm -rf build/ .dev-index/ *.pdf *.html qr-code.png
|
|
|
|
# Install dependencies
|
|
install:
|
|
@echo "Installing dependencies..."
|
|
npm install
|