{esc(title)}

#!/usr/bin/env python3 """Generate readable ONEPAGER.html for each project package and an optional GALLERY.html index. Works with the project_package template created for RCA/Goldsmiths. Usage: source .venv_rca/bin/activate python tools/media_onepager.py --root ~/Desktop/RCA_MediaLibrary/innovation-design-engineering-ma-msc/2025 It will: - Find projects/*/01_text/project_profile.yaml - Render ONEPAGER.html at project root - Render 00_index/GALLERY.html at year root Safe: local file operations only. """ import argparse import html import os from pathlib import Path from urllib.parse import quote import yaml def read_text(p: Path) -> str: try: return p.read_text(encoding="utf-8") except Exception: return "" def relpath(from_dir: Path, to_path: Path) -> str: return os.path.relpath(to_path, start=from_dir) def esc(s: str) -> str: return html.escape(s or "") def list_images(originals_dir: Path): if not originals_dir.exists(): return [] imgs = sorted([p for p in originals_dir.iterdir() if p.is_file() and p.name.lower().startswith("img_")]) return imgs def yaml_load(p: Path) -> dict: try: return yaml.safe_load(p.read_text(encoding="utf-8")) or {} except Exception: return {} def pick(d: dict, path: str, default=""): cur = d for k in path.split("."): if not isinstance(cur, dict) or k not in cur: return default cur = cur[k] return cur if cur is not None else default def to_list(v): if v is None: return [] if isinstance(v, list): return v if isinstance(v, str) and v.strip(): return [v.strip()] return [] def render_onepager(project_dir: Path) -> dict: profile_path = project_dir / "01_text" / "project_profile.yaml" desc_path = project_dir / "01_text" / "project_description.md" links_path = project_dir / "01_text" / "links.md" source_url = read_text(project_dir / "00_admin" / "source_url.txt").strip() prof = yaml_load(profile_path) title = pick(prof, "identifiers.project_title", "") or project_dir.name subtitle = pick(prof, "identifiers.project_subtitle", "") program = pick(prof, "identifiers.program", "") year = str(pick(prof, "identifiers.grad_year", "")) school = pick(prof, "identifiers.school", "") authors = prof.get("authors") or [] author_names = [a.get("name", "") for a in authors if isinstance(a, dict) and a.get("name")] materials = to_list(pick(prof, "project.materials_tech", [])) themes = to_list(pick(prof, "project.themes", [])) kw_cn = to_list(pick(prof, "project.keywords_cn", [])) kw_en = to_list(pick(prof, "project.keywords_en", [])) contacts = prof.get("contacts") or {} contact_lines = [] for k in ["email", "phone", "instagram", "xhs", "website", "linkedin"]: v = contacts.get(k) if v: contact_lines.append((k, str(v))) originals_dir = project_dir / "02_images" / "originals" imgs = list_images(originals_dir) desc_md = read_text(desc_path) links_md = read_text(links_path) # Very simple MD->HTML: preserve as

 (readable, zero deps)
    def pre_block(label, txt):
        if not txt.strip():
            return ""
        return f"{esc(label)}
{esc(txt)}"

    img_html = []
    for p in imgs:
        rel = relpath(project_dir, p)
        img_html.append(
            f"{esc(p.name)}"
        )

    html_out = f"""




{esc(title)}



  {esc(title)}
  {esc(subtitle)}

  
    
      Basic
      School: {esc(school)}

         Program: {esc(program)}

         Year: {esc(year)}

         Author(s): {esc(', '.join(author_names))}
      Source: {f"{esc(source_url)}" if source_url else ""}
    
    
      Materials / Themes / Keywords
      
        {''.join([f"{esc(x)}" for x in materials])}
      
      
        {''.join([f"{esc(x)}" for x in themes])}
      
      
        {''.join([f"{esc(x)}" for x in (kw_cn+kw_en)])}
      
    
    
      Contacts
      
        {''.join([f"{esc(k)}: {esc(v)}
" for k,v in contact_lines]) or '(empty)'}
      
    
    
      Files
      
        Images: {len(imgs)}
        Description: {('yes' if desc_md.strip() else 'no')}
        Links: {('yes' if links_md.strip() else 'no')}
      
    
  

  Images
  {''.join(img_html) if img_html else '(no images downloaded yet)'}

  {pre_block('Description (Markdown extracted)', desc_md)}
  {pre_block('Links (Markdown)', links_md)}



"""

    out_path = project_dir / "ONEPAGER.html"
    out_path.write_text(html_out, encoding="utf-8")

    cover = imgs[0] if imgs else None

    return {
        "title": title,
        "author": ", ".join(author_names),
        "year": year,
        "program": program,
        "project_dir": str(project_dir),
        "onepager": str(out_path),
        "cover_rel": relpath(project_dir, cover) if cover else "",
        "source_url": source_url,
        "image_count": len(imgs),
    }


def render_gallery(year_root: Path, items: list):
    idx_dir = year_root / "00_index"
    ensure_dir(idx_dir)
    cards = []
    for it in items:
        proj_dir = Path(it["project_dir"])
        onepager = proj_dir / "ONEPAGER.html"
        rel_onepager = relpath(idx_dir, onepager)
        cover_rel = it.get("cover_rel")
        cover_from_idx = relpath(idx_dir, proj_dir / cover_rel) if cover_rel else ""
        img_tag = f"" if cover_rel else "(no cover)"
        cards.append(f"""
        
          {img_tag}
          
            {esc(it['title'])}
            {esc(it.get('author',''))}
            {esc(it.get('program',''))} · {esc(it.get('year',''))} · {it.get('image_count',0)} imgs
          
        
        """)

    html_out = f"""




Gallery



Gallery
{len(items)} projects

{''.join(cards)}



"""

    out_path = idx_dir / "GALLERY.html"
    out_path.write_text(html_out, encoding="utf-8")


def ensure_dir(p: Path) -> None:
    p.mkdir(parents=True, exist_ok=True)


def main():
    ap = argparse.ArgumentParser()
    ap.add_argument("--root", required=True, help="year root, e.g. .../2025")
    ap.add_argument("--no-gallery", action="store_true")
    args = ap.parse_args()

    year_root = Path(os.path.expanduser(args.root)).resolve()
    projects_dir = year_root / "projects"

    items = []
    if projects_dir.exists():
        for proj in sorted(projects_dir.iterdir()):
            if not proj.is_dir():
                continue
            prof = proj / "01_text" / "project_profile.yaml"
            if not prof.exists():
                continue
            try:
                it = render_onepager(proj)
                items.append(it)
            except Exception:
                continue

    if not args.no_gallery:
        render_gallery(year_root, items)


if __name__ == "__main__":
    main()