How ctechfilmuniversity/lecture_ss23_procedural_generation_and_simulation works
Project type and purpose
• This is a static-site repository for a university course (“Procedural Generation and Simulation”). It holds lecture materials (slides, scripts, session notes) under docs/ and student assignment deliverables under assignments/. It publishes via GitHub Pages (see _config.yml in docs/).
File structure
• Top-level:
• README.md & errata.md – high-level pointers
• assignments/ – per-student folders, each containing subfolders for individual assignment deliveries (HTML, CSS, JS, shaders, media, Cargo/Rust demos, etc.)
• docs/ – Jekyll source:
– 01_sessions/, 02_scripts/, 03_slides/ – markdown, HTML, images grouped by lecture
– _config.yml, index.md – site configuration and entry point
• There are no backend services or dynamic code—this is purely a content repo plus static-site generator.
README for additional insights
• The README URL points to the published site: a Jekyll-powered GitHub Pages site that renders all markdown, HTML, images, code snippets, and student projects.
Elements
• “git push” from Content Repo → Jekyll Generator
• “build” from Jekyll Generator → GitHub Pages
• “serve” from GitHub Pages → Browser Clients
• Source files (Markdown, assets)
• Build process (Jekyll)
• Hosting service
• Runtime environment (web browser)
• Optionally, annotate external dependencies (e.g., remark.js CDN).
Be very detailed
• That assets (images, videos, shaders) flow directly into the static site.
• Development vs. production paths if necessary (e.g., local jekyll serve for preview).