"""Scaffold a new demo page: www//index.html (+ style.css), its entry in CATEGORIES
(scripts/gen_nav.py), its card on the home page, then regenerate every page's nav.
Run from the repo root:
python3 scripts/new_demo.py --name 短名 --icon 🧩 \\
--title '页面标题' --subtitle '副标题（可含 HTML）' --help-html '操作提示' \\
--card-desc '首页卡片一句话' --tag '卡片标签' [--body body.html] [--css]
The crate (crates///), index.js and scripts/explain/.json are still
written by hand; after writing the explain JSON run `python3 scripts/gen_explain.py `.
"""
import argparse
import html
import importlib.util
import pathlib
import re
import subprocess
import sys
ROOT = pathlib.Path(__file__).resolve().parent.parent
def page_html(title, h1, subtitle, body, help_html, own_css):
"""The page skeleton every demo shares; nav and explain panel are filled in by generators."""
css = '\n ' if own_css else ''
body = body.rstrip('\n') or ' '
return f'''
{html.escape(title)} — Rust + WebAssembly
{css}
{html.escape(h1)}
{subtitle}
{body}
{help_html}
'''
def add_to_categories(source, category, slug, name):
"""Return gen_nav.py source with (slug, name) appended to the category's demo list."""
start = re.search(rf"^ \('{re.escape(category)}', ", source, re.M)
if not start:
raise ValueError(f'unknown category: {category}')
end = source.index(' ]),\n', start.end())
if f"('{slug}', " in source[start.start():end]:
raise ValueError(f'{slug} is already in {category}')
entry = f" ('{slug}', '{name}'),\n"
return source[:end] + entry + source[end:]
def add_card(home, category, label, description, slug, icon, title, desc, tag):
"""Return the home page with a card for the demo in its category's section
(creating the section after the previous existing category if needed)."""
if f'href="{slug}/"' in home:
raise ValueError(f'{slug} already has a card')
card = f'''