Function main

Scripts/generate_docs.py:207–243

()

# ──────────────────────────────────────────────────────────────────────────────

def main():
    parser = argparse.ArgumentParser(description='Generate URLab plugin documentation.')
    parser.add_argument('--serve', action='store_true', help='Run mkdocs serve after generating')
    parser.add_argument('--build', action='store_true', help='Run mkdocs build after generating')
    parser.add_argument('--skip-parse', action='store_true',
                        help='Skip parsing step and reuse existing _parsed_headers.json')
    args = parser.parse_args()

    print(f"URLab Docs Generator")
    print(f"Plugin root: {PLUGIN_ROOT}")

    # Step 1
    if args.skip_parse and os.path.exists(PARSED_JSON):
        print(f"\n─── Step 1: Skipped (using cached {os.path.relpath(PARSED_JSON, PLUGIN_ROOT)}) ───")
        with open(PARSED_JSON, 'r', encoding='utf-8') as f:
            data = json.load(f)
    else:
        data = step_parse()
        
    resolve_inheritance(data)

    # Step 2
    nav_yaml = step_emit(data)

    # Step 3
    step_update_nav(nav_yaml)

    print("\n✅  Documentation generated successfully!")
    print(f"    Site source: {DOCS_ROOT}")
    print(f"    To preview:  mkdocs serve  (run from {PLUGIN_ROOT})")
    print(f"    To publish:  mkdocs gh-deploy")

    # Step 4 (optional)
    if args.serve:
        step_mkdocs('serve')
    elif args.build:
        step_mkdocs('build')


if __name__ == '__main__':