Refactor docs HTML sections to use VitePress with complete manual documentation

[Copilot]

This PR refactors the documentation HTML sections to use VitePress, making the codebase significantly more maintainable and providing a better developer experience with comprehensive manual documentation.

Problem

The existing documentation used static HTML files (index.html, blog.html, browser-compat-data.html) which were difficult to maintain:

• Hard to update: Required manual HTML editing for content changes
• No consistency: Each page had its own styling and layout implementation
• Poor developer experience: No hot reload, search, or modern tooling
• Maintenance overhead: Shared components (navbar, footer) duplicated across files
• Missing Documentation section: VitePress was configured for .md files but manual docs were in .mdx format, breaking navigation

Solution

Implemented a complete VitePress-based documentation system that:

🎯 Converts HTML to Markdown

• index.html → index.md with VitePress home layout
• blog.html → blog.md with structured blog post listings
• browser-compat-data.html → api/browser-compat-data.md with comprehensive compatibility tables

📖 Creates Complete Manual Documentation

• Introduction: JSAR overview, key features, and use cases
• Quick Start: Device support, setup instructions, and first steps
• Basic Concepts: Spaces, input systems, and spatial HTML concepts
• Features: Scripting, 3D development, multimedia, and debugging
• Runtime: Dependencies, APIs, and architecture details
• Delivery: Publishing methods and distribution channels
• Developer Tools: VS Code extension, debugging, and preview tools
• Tutorials: Hello World examples, networking, and advanced topics
• References: API documentation, WebXR guides, and specifications

🎨 Preserves Existing Design

• Custom VitePress theme maintains JSAR branding and color scheme
• Responsive design with mobile-optimized navigation
• Hero section with compelling CTAs and feature showcase
• Professional styling for compatibility matrices and technical content

🛠 Improves Developer Experience

• Hot reload during development with npm run docs:dev
• Built-in search functionality
• Automatic navigation generation from file structure
• Edit links and last updated timestamps
• Proper SEO meta tags and structured content

📦 Updates Build Pipeline

• New npm scripts: docs:dev, docs:build, docs:preview
• Updated tools/build_website.sh to use VitePress
• Build output to docs/.vitepress/dist/ with proper gitignore

Key Features

Modern Documentation Site:

• Clean, professional homepage with technology stack overview
• Blog section with technical insights and community updates
• Comprehensive API reference with browser compatibility matrices
• Complete manual documentation with hierarchical navigation

Maintainability Improvements:

• Markdown-based content that's easy to edit
• Centralized configuration in .vitepress/config.mjs
• Reusable components and consistent styling
• Integration with existing MDX files through .md equivalents

Performance Optimizations:

• Static site generation for fast loading
• Optimized assets and lazy loading
• Progressive web app capabilities

Testing

All pages render correctly and maintain functionality:

• ✅ Homepage with hero section and feature cards
• ✅ Blog listings with proper post formatting
• ✅ API reference with detailed compatibility tables
• ✅ Complete manual documentation with working navigation
• ✅ Developer tools and debugging guides
• ✅ Mobile responsive design
• ✅ Build pipeline producing optimized static site

The refactor successfully modernizes the documentation infrastructure while providing comprehensive manual documentation and improving the overall user and developer experience.

---

💡 You can make Copilot smarter by setting up custom instructions, customizing its development environment and configuring Model Context Protocol (MCP) servers. Learn more Copilot coding agent tips in the docs.

[yorkie]

缺少 Documentation 的部分

[Copilot]

缺少 Documentation 的部分

Added the missing Documentation section. The issue was that VitePress was configured to use .md files but the manual documentation was in .mdx format. Created comprehensive .md versions of all manual documentation files including Introduction, Quick Start, Basic Concepts, Features, Runtime, Delivery, Developer Tools, Tutorials, and References sections. The Documentation navigation now works properly. (c5b7f2b)