Function generate_sidebar_json

scripts/generate_docs_index.py:453–612

Generate docs/.vitepress/sidebar.json with dynamic sidebar items. VitePress uses longest-prefix matching for sidebar: /zh/nmpa/ -> static sidebar in config.ts (overview pages) /zh/nmpa/guidance/ -> dynamic grouped sidebar (guidance sub-pages) /zh/nmpa/regulatio

(all_section_entries: Dict[str, List[dict]], repo_root: Path, dry_run: bool = False)

def generate_sidebar_json(all_section_entries: Dict[str, List[dict]], repo_root: Path, dry_run: bool = False) -> None:
    """
    Generate docs/.vitepress/sidebar.json with dynamic sidebar items.

    VitePress uses longest-prefix matching for sidebar:
      /zh/nmpa/           -> static sidebar in config.ts (overview pages)
      /zh/nmpa/guidance/  -> dynamic grouped sidebar (guidance sub-pages)
      /zh/nmpa/regulations/ -> dynamic sidebar (regulation sub-pages)
      /zh/insights/       -> dynamic sidebar (insights pages)
    """
    sidebar: Dict[str, list] = {}

    en_sidebar: Dict[str, list] = {}

    for section_key, entries in all_section_entries.items():
        items = []
        for entry in entries:
            slug = unquote(entry["slug"])
            items.append({
                "text": entry["title_zh"],
                "link": f"/zh/{section_key}/{slug}",
            })

        # Build English sidebar items for this section
        en_items = []
        en_entries = get_en_entries(entries, repo_root)
        for en_entry in en_entries:
            slug = unquote(en_entry["slug"])
            en_items.append({
                "text": en_entry["title_en"],
                "link": f"/en/{section_key}/{slug}",
            })

        if section_key == "nmpa/guidance":
            groups = group_nmpa_guidance(entries)
            sidebar_items = [
                {"text": "<- NMPA 概览", "link": "/zh/nmpa/"},
                {"text": "指导原则索引", "link": "/zh/nmpa/guidance"},
            ]
            for group_name, group_entries in groups.items():
                if not group_entries:
                    continue
                children = []
                for e in sorted(group_entries, key=lambda x: x["title_zh"]):
                    s = unquote(e["slug"])
                    children.append({"text": e["title_zh"], "link": f"/zh/nmpa/guidance/{s}"})
                sidebar_items.append({
                    "text": f"{group_name} ({len(group_entries)})",
                    "collapsed": True,
                    "items": children,
                })
            sidebar["/zh/nmpa/guidance/"] = sidebar_items

        elif section_key == "nmpa/regulations":
            sorted_items = sorted(items, key=lambda x: x["text"])
            sidebar["/zh/nmpa/regulations/"] = [
                {"text": "<- NMPA 概览", "link": "/zh/nmpa/"},
                {"text": "法规规章索引", "link": "/zh/nmpa/regulations"},