How oscuro-phoenix/math-for-fun works
Project type and purpose
• This is a static‐site project built with Jekyll (a Ruby-based static site generator). Its sole purpose is to collect and render Markdown “math problem” posts into a browseable website.
File structure
• Top‐level files:
• Gemfile / Gemfile.lock – declare Jekyll and plugin dependencies
• _config.yml – Jekyll configuration (site metadata, plugin settings)
• index.html, about.md, tags.html, 404.html – site entry points and standalone pages
• Directories under Jekyll conventions:
• _posts – Markdown problem posts (content source)
• _drafts – unpublished content
• _layouts – HTML layout templates (e.g., default.html, post.html)
• _includes – reusable HTML partials (header, footer, nav)
• assets – media files (videos)
• css – SCSS source, compiled to site CSS
• notebooks – Jupyter notebooks and Python scripts (auxiliary content)
• Misc:
• google*.html – verification files
• tags.html – auto‐generated tag listing
README for additional insights
• Confirms this is “Math-For-Fun,” a simple website to track math problems.
• References a theme “Parchment” inspired by another Jekyll theme.
Elements
• Clear rectangular nodes for:
• “Markdown Posts & Pages”
• “_layouts & _includes”
• “assets/css & notebooks”
• “Jekyll Build Engine”
• “_site (Generated Output)”
• “Hosting (GitHub Pages)”
• “Browser / End User”
• From content, templates, assets into “Jekyll Build Engine”
• From build engine to “_site”
• From “_site” to “Hosting”
• From “Hosting” to “Browser”
• Content (blue)
• Templates & includes (green)
• Build engine & toolchain (orange)
• Deployment & hosting (purple)
• End user (gray)