create index pages for examples

Author: TrevorAustin

build.py

@@ -15,6 +15,76 @@
 )
 CANVAS_COURSE_PATTERN = re.compile(r"canvas\.uchicago\.edu/courses/\d+")
 
+EXAMPLES_EXCLUDE_DIRS = {"__pycache__", "images"}
+EXAMPLES_EXCLUDE_SUFFIXES = {".pyc"}
+
+
+def build_examples_indexes(examples_root: Path, env, base_url: str):
+    """Generate index.html pages for the examples tree.
+
+    Walks examples/ recursively. For any directory without an existing
+    index.html, renders one that lists its subdirectories and files.
+    The top-level page lists each week; deeper pages list their contents.
+    """
+    template = env.get_template("examples_index.html")
+
+    def is_hidden(p: Path) -> bool:
+        return any(part.startswith(".") for part in p.relative_to(examples_root).parts)
+
+    def is_excluded(p: Path) -> bool:
+        return any(part in EXAMPLES_EXCLUDE_DIRS for part in p.relative_to(examples_root).parts)
+
+    all_dirs = [examples_root, *sorted(p for p in examples_root.rglob("*") if p.is_dir())]
+    for dirpath in all_dirs:
+        if is_hidden(dirpath) or is_excluded(dirpath):
+            continue
+        if (dirpath / "index.html").exists():
+            continue
+
+        rel = dirpath.relative_to(examples_root)
+        url_prefix = f"{base_url}/examples"
+        if rel != Path("."):
+            url_prefix += "/" + "/".join(rel.parts)
+
+        entries = sorted(dirpath.iterdir(), key=lambda p: (not p.is_dir(), p.name.lower()))
+        dirs = [
+            {"name": p.name, "url": f"{url_prefix}/{p.name}/"}
+            for p in entries
+            if p.is_dir()
+            and p.name not in EXAMPLES_EXCLUDE_DIRS
+            and not p.name.startswith(".")
+        ]
+        files = [
+            {"name": p.name, "url": f"{url_prefix}/{p.name}"}
+            for p in entries
+            if p.is_file()
+            and p.name != "index.html"
+            and p.suffix not in EXAMPLES_EXCLUDE_SUFFIXES
+            and not p.name.startswith(".")
+        ]
+
+        if rel == Path("."):
+            title = "Examples"
+            crumbs = []
+            parent_url = ""
+        else:
+            title = "Examples — " + " / ".join(part.replace("_", " ") for part in rel.parts)
+            crumbs = [{"name": "Examples", "url": f"{base_url}/examples/"}]
+            accum = f"{base_url}/examples"
+            for part in rel.parts[:-1]:
+                accum += f"/{part}"
+                crumbs.append({"name": part, "url": f"{accum}/"})
+            crumbs.append({"name": rel.parts[-1], "url": ""})
+            parent_parts = rel.parts[:-1]
+            parent_url = f"{base_url}/examples/" + (
+                "/".join(parent_parts) + "/" if parent_parts else ""
+            )
+
+        html = template.render(
+            title=title, crumbs=crumbs, parent_url=parent_url, dirs=dirs, files=files
+        )
+        (dirpath / "index.html").write_text(html)
+
 
 def apply_config(text: str) -> str:
     """Replace quarter and Canvas course ID references with current config values."""
@@ -140,6 +210,9 @@ def build_site(output_dir: str = "_site", base_url: str = ""):
     homepage_html = env.get_template("index.html").render()
     (out / "index.html").write_text(homepage_html)
 
+    # Examples index pages (top-level + per-week + per-subdir)
+    build_examples_indexes(out / "examples", env, base_url)
+
 
 if __name__ == "__main__":
     parser = argparse.ArgumentParser(description="Build the static site.")

templates/examples_index.html

@@ -0,0 +1,33 @@
+{% extends "base.html" %}
+
+{% block title %}{{ title }} | Web Development{% endblock %}
+
+{% block content %}
+<div class="lecture-index">
+    <h1>{{ title }}</h1>
+    {% if crumbs %}
+    <p class="breadcrumbs">
+        {% for crumb in crumbs %}{% if not loop.last %}<a href="{{ crumb.url }}">{{ crumb.name }}</a> / {% else %}{{ crumb.name }}{% endif %}{% endfor %}
+    </p>
+    {% endif %}
+    {% if parent_url %}
+    <p><a href="{{ parent_url }}">← Up</a></p>
+    {% endif %}
+    {% if dirs %}
+    <h2>Directories</h2>
+    <ul>
+        {% for d in dirs %}
+        <li><a href="{{ d.url }}">{{ d.name }}/</a></li>
+        {% endfor %}
+    </ul>
+    {% endif %}
+    {% if files %}
+    <h2>Files</h2>
+    <ul>
+        {% for f in files %}
+        <li><a href="{{ f.url }}">{{ f.name }}</a></li>
+        {% endfor %}
+    </ul>
+    {% endif %}
+</div>
+{% endblock %}