[{"data":1,"prerenderedAt":63},["Reactive",2],{"blog-post-markdown-documentation-site-generators-complete-guide":3},{"slug":4,"title":5,"description":6,"excerpt":7,"date":8,"category":9,"author":10,"keywords":11,"readingMinutes":12,"html":13,"headings":14,"tools":37,"related":38},"markdown-documentation-site-generators-complete-guide","Markdown Documentation Site Generators: Complete Guide for Modern Documentation Workflows and Static Site Generation","Master advanced Markdown documentation site generators including Jekyll, Hugo, MkDocs, and Docusaurus. Learn site generation workflows, theme customization, plugin systems, and deployment strategies for professional documentation platforms.","Advanced Markdown documentation site generators enable sophisticated content management workflows that transform simple Markdown files into comprehensive documentation platforms with professional…","2025-12-02","Tutorial","Matthew Rathbone","markdown documentation generators, jekyll markdown, hugo markdown, mkdocs, docusaurus markdown, static site generators, documentation workflows, markdown site themes, documentation deployment",27,"\u003Cp>Advanced Markdown documentation site generators enable sophisticated content management workflows that transform simple Markdown files into comprehensive documentation platforms with professional themes, interactive features, and powerful deployment capabilities. By mastering modern site generation tools, content management systems, and deployment pipelines, technical teams can build scalable documentation ecosystems that serve diverse audiences while maintaining editorial simplicity and version control integration.\u003C/p>\n\u003Ch2 id=\"why-master-markdown-documentation-site-generators\">Why Master Markdown Documentation Site Generators?\u003C/h2>\n\u003Cp>Professional documentation site generators provide essential benefits for content-driven organizations:\u003C/p>\n\u003Cul>\n\u003Cli>\u003Cstrong>Rapid Development\u003C/strong>: Transform Markdown content into fully-featured websites with minimal configuration\u003C/li>\n\u003Cli>\u003Cstrong>Theme Flexibility\u003C/strong>: Access extensive theme ecosystems with customizable designs and responsive layouts\u003C/li>\n\u003Cli>\u003Cstrong>Plugin Ecosystems\u003C/strong>: Extend functionality through comprehensive plugin systems and custom integrations\u003C/li>\n\u003Cli>\u003Cstrong>Deployment Integration\u003C/strong>: Seamless integration with modern deployment platforms and CI/CD workflows\u003C/li>\n\u003Cli>\u003Cstrong>Performance Optimization\u003C/strong>: Generate fast, SEO-optimized static sites with excellent loading performance\u003C/li>\n\u003C/ul>\n\u003Ch2 id=\"foundation-generator-comparison\">Foundation Generator Comparison\u003C/h2>\n\u003Ch3 id=\"popular-documentation-site-generators\">Popular Documentation Site Generators\u003C/h3>\n\u003Cp>Understanding the strengths and use cases of major Markdown site generators:\u003C/p>\n\u003Cpre>\u003Ccode class=\"hljs language-yaml\">\u003Cspan class=\"hljs-comment\"># Site Generator Comparison Matrix\u003C/span>\n\u003Cspan class=\"hljs-attr\">generators:\u003C/span>\n  \u003Cspan class=\"hljs-attr\">jekyll:\u003C/span>\n    \u003Cspan class=\"hljs-attr\">language:\u003C/span> \u003Cspan class=\"hljs-string\">Ruby\u003C/span>\n    \u003Cspan class=\"hljs-attr\">strengths:\u003C/span>\n      \u003Cspan class=\"hljs-bullet\">-\u003C/span> \u003Cspan class=\"hljs-string\">GitHub\u003C/span> \u003Cspan class=\"hljs-string\">Pages\u003C/span> \u003Cspan class=\"hljs-string\">native\u003C/span> \u003Cspan class=\"hljs-string\">support\u003C/span>\n      \u003Cspan class=\"hljs-bullet\">-\u003C/span> \u003Cspan class=\"hljs-string\">Mature\u003C/span> \u003Cspan class=\"hljs-string\">plugin\u003C/span> \u003Cspan class=\"hljs-string\">ecosystem\u003C/span>\n      \u003Cspan class=\"hljs-bullet\">-\u003C/span> \u003Cspan class=\"hljs-string\">Liquid\u003C/span> \u003Cspan class=\"hljs-string\">templating\u003C/span> \u003Cspan class=\"hljs-string\">system\u003C/span>\n      \u003Cspan class=\"hljs-bullet\">-\u003C/span> \u003Cspan class=\"hljs-string\">Strong\u003C/span> \u003Cspan class=\"hljs-string\">blogging\u003C/span> \u003Cspan class=\"hljs-string\">features\u003C/span>\n    \u003Cspan class=\"hljs-attr\">use_cases:\u003C/span>\n      \u003Cspan class=\"hljs-bullet\">-\u003C/span> \u003Cspan class=\"hljs-string\">GitHub-hosted\u003C/span> \u003Cspan class=\"hljs-string\">documentation\u003C/span>\n      \u003Cspan class=\"hljs-bullet\">-\u003C/span> \u003Cspan class=\"hljs-string\">Blog-style\u003C/span> \u003Cspan class=\"hljs-string\">documentation\u003C/span>\n      \u003Cspan class=\"hljs-bullet\">-\u003C/span> \u003Cspan class=\"hljs-string\">Academic\u003C/span> \u003Cspan class=\"hljs-string\">websites\u003C/span>\n      \u003Cspan class=\"hljs-bullet\">-\u003C/span> \u003Cspan class=\"hljs-string\">Small\u003C/span> \u003Cspan class=\"hljs-string\">to\u003C/span> \u003Cspan class=\"hljs-string\">medium\u003C/span> \u003Cspan class=\"hljs-string\">projects\u003C/span>\n    \u003Cspan class=\"hljs-attr\">learning_curve:\u003C/span> \u003Cspan class=\"hljs-string\">Medium\u003C/span>\n    \u003Cspan class=\"hljs-attr\">build_speed:\u003C/span> \u003Cspan class=\"hljs-string\">Medium\u003C/span>\n    \n  \u003Cspan class=\"hljs-attr\">hugo:\u003C/span>\n    \u003Cspan class=\"hljs-attr\">language:\u003C/span> \u003Cspan class=\"hljs-string\">Go\u003C/span>\n    \u003Cspan class=\"hljs-attr\">strengths:\u003C/span>\n      \u003Cspan class=\"hljs-bullet\">-\u003C/span> \u003Cspan class=\"hljs-string\">Extremely\u003C/span> \u003Cspan class=\"hljs-string\">fast\u003C/span> \u003Cspan class=\"hljs-string\">build\u003C/span> \u003Cspan class=\"hljs-string\">times\u003C/span>\n      \u003Cspan class=\"hljs-bullet\">-\u003C/span> \u003Cspan class=\"hljs-string\">Powerful\u003C/span> \u003Cspan class=\"hljs-string\">templating\u003C/span> \u003Cspan class=\"hljs-string\">system\u003C/span>\n      \u003Cspan class=\"hljs-bullet\">-\u003C/span> \u003Cspan class=\"hljs-string\">Built-in\u003C/span> \u003Cspan class=\"hljs-string\">optimization\u003C/span> \u003Cspan class=\"hljs-string\">features\u003C/span>\n      \u003Cspan class=\"hljs-bullet\">-\u003C/span> \u003Cspan class=\"hljs-string\">Extensive\u003C/span> \u003Cspan class=\"hljs-string\">theme\u003C/span> \u003Cspan class=\"hljs-string\">gallery\u003C/span>\n    \u003Cspan class=\"hljs-attr\">use_cases:\u003C/span>\n      \u003Cspan class=\"hljs-bullet\">-\u003C/span> \u003Cspan class=\"hljs-string\">Large\u003C/span> \u003Cspan class=\"hljs-string\">documentation\u003C/span> \u003Cspan class=\"hljs-string\">sites\u003C/span>\n      \u003Cspan class=\"hljs-bullet\">-\u003C/span> \u003Cspan class=\"hljs-string\">Corporate\u003C/span> \u003Cspan class=\"hljs-string\">websites\u003C/span>\n      \u003Cspan class=\"hljs-bullet\">-\u003C/span> \u003Cspan class=\"hljs-string\">Multi-language\u003C/span> \u003Cspan class=\"hljs-string\">content\u003C/span>\n      \u003Cspan class=\"hljs-bullet\">-\u003C/span> \u003Cspan class=\"hljs-string\">Performance-critical\u003C/span> \u003Cspan class=\"hljs-string\">sites\u003C/span>\n    \u003Cspan class=\"hljs-attr\">learning_curve:\u003C/span> \u003Cspan class=\"hljs-string\">Medium-High\u003C/span>\n    \u003Cspan class=\"hljs-attr\">build_speed:\u003C/span> \u003Cspan class=\"hljs-string\">Very\u003C/span> \u003Cspan class=\"hljs-string\">Fast\u003C/span>\n    \n  \u003Cspan class=\"hljs-attr\">mkdocs:\u003C/span>\n    \u003Cspan class=\"hljs-attr\">language:\u003C/span> \u003Cspan class=\"hljs-string\">Python\u003C/span>\n    \u003Cspan class=\"hljs-attr\">strengths:\u003C/span>\n      \u003Cspan class=\"hljs-bullet\">-\u003C/span> \u003Cspan class=\"hljs-string\">Simple\u003C/span> \u003Cspan class=\"hljs-string\">configuration\u003C/span>\n      \u003Cspan class=\"hljs-bullet\">-\u003C/span> \u003Cspan class=\"hljs-string\">Documentation-focused\u003C/span> \u003Cspan class=\"hljs-string\">design\u003C/span>\n      \u003Cspan class=\"hljs-bullet\">-\u003C/span> \u003Cspan class=\"hljs-string\">Material\u003C/span> \u003Cspan class=\"hljs-string\">Design\u003C/span> \u003Cspan class=\"hljs-string\">theme\u003C/span>\n      \u003Cspan class=\"hljs-bullet\">-\u003C/span> \u003Cspan class=\"hljs-string\">Search\u003C/span> \u003Cspan class=\"hljs-string\">integration\u003C/span>\n    \u003Cspan class=\"hljs-attr\">use_cases:\u003C/span>\n      \u003Cspan class=\"hljs-bullet\">-\u003C/span> \u003Cspan class=\"hljs-string\">Technical\u003C/span> \u003Cspan class=\"hljs-string\">documentation\u003C/span>\n      \u003Cspan class=\"hljs-bullet\">-\u003C/span> \u003Cspan class=\"hljs-string\">API\u003C/span> \u003Cspan class=\"hljs-string\">documentation\u003C/span>\n      \u003Cspan class=\"hljs-bullet\">-\u003C/span> \u003Cspan class=\"hljs-string\">Software\u003C/span> \u003Cspan class=\"hljs-string\">project\u003C/span> \u003Cspan class=\"hljs-string\">docs\u003C/span>\n      \u003Cspan class=\"hljs-bullet\">-\u003C/span> \u003Cspan class=\"hljs-string\">Developer-focused\u003C/span> \u003Cspan class=\"hljs-string\">content\u003C/span>\n    \u003Cspan class=\"hljs-attr\">learning_curve:\u003C/span> \u003Cspan class=\"hljs-string\">Low\u003C/span>\n    \u003Cspan class=\"hljs-attr\">build_speed:\u003C/span> \u003Cspan class=\"hljs-string\">Fast\u003C/span>\n    \n  \u003Cspan class=\"hljs-attr\">docusaurus:\u003C/span>\n    \u003Cspan class=\"hljs-attr\">language:\u003C/span> \u003Cspan class=\"hljs-string\">JavaScript\u003C/span>\n    \u003Cspan class=\"hljs-attr\">strengths:\u003C/span>\n      \u003Cspan class=\"hljs-bullet\">-\u003C/span> \u003Cspan class=\"hljs-string\">React-based\u003C/span> \u003Cspan class=\"hljs-string\">architecture\u003C/span>\n      \u003Cspan class=\"hljs-bullet\">-\u003C/span> \u003Cspan class=\"hljs-string\">Versioned\u003C/span> \u003Cspan class=\"hljs-string\">documentation\u003C/span>\n      \u003Cspan class=\"hljs-bullet\">-\u003C/span> \u003Cspan class=\"hljs-string\">Internationalization\u003C/span> \u003Cspan class=\"hljs-string\">support\u003C/span>\n      \u003Cspan class=\"hljs-bullet\">-\u003C/span> \u003Cspan class=\"hljs-string\">Modern\u003C/span> \u003Cspan class=\"hljs-string\">development\u003C/span> \u003Cspan class=\"hljs-string\">workflow\u003C/span>\n    \u003Cspan class=\"hljs-attr\">use_cases:\u003C/span>\n      \u003Cspan class=\"hljs-bullet\">-\u003C/span> \u003Cspan class=\"hljs-string\">Open\u003C/span> \u003Cspan class=\"hljs-string\">source\u003C/span> \u003Cspan class=\"hljs-string\">projects\u003C/span>\n      \u003Cspan class=\"hljs-bullet\">-\u003C/span> \u003Cspan class=\"hljs-string\">API\u003C/span> \u003Cspan class=\"hljs-string\">documentation\u003C/span>\n      \u003Cspan class=\"hljs-bullet\">-\u003C/span> \u003Cspan class=\"hljs-string\">Multi-version\u003C/span> \u003Cspan class=\"hljs-string\">docs\u003C/span>\n      \u003Cspan class=\"hljs-bullet\">-\u003C/span> \u003Cspan class=\"hljs-string\">React-based\u003C/span> \u003Cspan class=\"hljs-string\">customization\u003C/span>\n    \u003Cspan class=\"hljs-attr\">learning_curve:\u003C/span> \u003Cspan class=\"hljs-string\">Medium\u003C/span>\n    \u003Cspan class=\"hljs-attr\">build_speed:\u003C/span> \u003Cspan class=\"hljs-string\">Fast\u003C/span>\n    \n  \u003Cspan class=\"hljs-attr\">gitbook:\u003C/span>\n    \u003Cspan class=\"hljs-attr\">language:\u003C/span> \u003Cspan class=\"hljs-string\">JavaScript\u003C/span>\n    \u003Cspan class=\"hljs-attr\">strengths:\u003C/span>\n      \u003Cspan class=\"hljs-bullet\">-\u003C/span> \u003Cspan class=\"hljs-string\">User-friendly\u003C/span> \u003Cspan class=\"hljs-string\">interface\u003C/span>\n      \u003Cspan class=\"hljs-bullet\">-\u003C/span> \u003Cspan class=\"hljs-string\">Collaborative\u003C/span> \u003Cspan class=\"hljs-string\">editing\u003C/span>\n      \u003Cspan class=\"hljs-bullet\">-\u003C/span> \u003Cspan class=\"hljs-string\">Built-in\u003C/span> \u003Cspan class=\"hljs-string\">analytics\u003C/span>\n      \u003Cspan class=\"hljs-bullet\">-\u003C/span> \u003Cspan class=\"hljs-string\">Publishing\u003C/span> \u003Cspan class=\"hljs-string\">workflows\u003C/span>\n    \u003Cspan class=\"hljs-attr\">use_cases:\u003C/span>\n      \u003Cspan class=\"hljs-bullet\">-\u003C/span> \u003Cspan class=\"hljs-string\">Team\u003C/span> \u003Cspan class=\"hljs-string\">documentation\u003C/span>\n      \u003Cspan class=\"hljs-bullet\">-\u003C/span> \u003Cspan class=\"hljs-string\">Knowledge\u003C/span> \u003Cspan class=\"hljs-string\">bases\u003C/span>\n      \u003Cspan class=\"hljs-bullet\">-\u003C/span> \u003Cspan class=\"hljs-string\">User\u003C/span> \u003Cspan class=\"hljs-string\">manuals\u003C/span>\n      \u003Cspan class=\"hljs-bullet\">-\u003C/span> \u003Cspan class=\"hljs-string\">Non-technical\u003C/span> \u003Cspan class=\"hljs-string\">users\u003C/span>\n    \u003Cspan class=\"hljs-attr\">learning_curve:\u003C/span> \u003Cspan class=\"hljs-string\">Low\u003C/span>\n    \u003Cspan class=\"hljs-attr\">build_speed:\u003C/span> \u003Cspan class=\"hljs-string\">Medium\u003C/span>\n    \n  \u003Cspan class=\"hljs-attr\">gatsby:\u003C/span>\n    \u003Cspan class=\"hljs-attr\">language:\u003C/span> \u003Cspan class=\"hljs-string\">JavaScript\u003C/span>\n    \u003Cspan class=\"hljs-attr\">strengths:\u003C/span>\n      \u003Cspan class=\"hljs-bullet\">-\u003C/span> \u003Cspan class=\"hljs-string\">GraphQL\u003C/span> \u003Cspan class=\"hljs-string\">data\u003C/span> \u003Cspan class=\"hljs-string\">layer\u003C/span>\n      \u003Cspan class=\"hljs-bullet\">-\u003C/span> \u003Cspan class=\"hljs-string\">React\u003C/span> \u003Cspan class=\"hljs-string\">component\u003C/span> \u003Cspan class=\"hljs-string\">system\u003C/span>\n      \u003Cspan class=\"hljs-bullet\">-\u003C/span> \u003Cspan class=\"hljs-string\">Performance\u003C/span> \u003Cspan class=\"hljs-string\">optimization\u003C/span>\n      \u003Cspan class=\"hljs-bullet\">-\u003C/span> \u003Cspan class=\"hljs-string\">Rich\u003C/span> \u003Cspan class=\"hljs-string\">plugin\u003C/span> \u003Cspan class=\"hljs-string\">ecosystem\u003C/span>\n    \u003Cspan class=\"hljs-attr\">use_cases:\u003C/span>\n      \u003Cspan class=\"hljs-bullet\">-\u003C/span> \u003Cspan class=\"hljs-string\">Complex\u003C/span> \u003Cspan class=\"hljs-string\">documentation\u003C/span> \u003Cspan class=\"hljs-string\">sites\u003C/span>\n      \u003Cspan class=\"hljs-bullet\">-\u003C/span> \u003Cspan class=\"hljs-string\">Data-driven\u003C/span> \u003Cspan class=\"hljs-string\">content\u003C/span>\n      \u003Cspan class=\"hljs-bullet\">-\u003C/span> \u003Cspan class=\"hljs-string\">Custom\u003C/span> \u003Cspan class=\"hljs-string\">functionality\u003C/span>\n      \u003Cspan class=\"hljs-bullet\">-\u003C/span> \u003Cspan class=\"hljs-string\">Advanced\u003C/span> \u003Cspan class=\"hljs-string\">interactivity\u003C/span>\n    \u003Cspan class=\"hljs-attr\">learning_curve:\u003C/span> \u003Cspan class=\"hljs-string\">High\u003C/span>\n    \u003Cspan class=\"hljs-attr\">build_speed:\u003C/span> \u003Cspan class=\"hljs-string\">Medium\u003C/span>\n\u003C/code>\u003C/pre>\u003Ch3 id=\"comprehensive-generator-implementation\">Comprehensive Generator Implementation\u003C/h3>\n\u003Cp>Advanced site generator setup and optimization system:\u003C/p>\n\u003Cpre>\u003Ccode class=\"hljs language-javascript\">\u003Cspan class=\"hljs-comment\">// site-generator-manager.js - Multi-generator management system\u003C/span>\n\u003Cspan class=\"hljs-keyword\">const\u003C/span> fs = \u003Cspan class=\"hljs-built_in\">require\u003C/span>(\u003Cspan class=\"hljs-string\">'fs'\u003C/span>).\u003Cspan class=\"hljs-property\">promises\u003C/span>;\n\u003Cspan class=\"hljs-keyword\">const\u003C/span> path = \u003Cspan class=\"hljs-built_in\">require\u003C/span>(\u003Cspan class=\"hljs-string\">'path'\u003C/span>);\n\u003Cspan class=\"hljs-keyword\">const\u003C/span> yaml = \u003Cspan class=\"hljs-built_in\">require\u003C/span>(\u003Cspan class=\"hljs-string\">'js-yaml'\u003C/span>);\n\u003Cspan class=\"hljs-keyword\">const\u003C/span> { execSync } = \u003Cspan class=\"hljs-built_in\">require\u003C/span>(\u003Cspan class=\"hljs-string\">'child_process'\u003C/span>);\n\n\u003Cspan class=\"hljs-keyword\">class\u003C/span> \u003Cspan class=\"hljs-title class_\">DocumentationSiteManager\u003C/span> {\n    \u003Cspan class=\"hljs-title function_\">constructor\u003C/span>(\u003Cspan class=\"hljs-params\">options = {}\u003C/span>) {\n        \u003Cspan class=\"hljs-variable language_\">this\u003C/span>.\u003Cspan class=\"hljs-property\">projectRoot\u003C/span> = options.\u003Cspan class=\"hljs-property\">projectRoot\u003C/span> || process.\u003Cspan class=\"hljs-title function_\">cwd\u003C/span>();\n        \u003Cspan class=\"hljs-variable language_\">this\u003C/span>.\u003Cspan class=\"hljs-property\">generators\u003C/span> = {\n            \u003Cspan class=\"hljs-attr\">jekyll\u003C/span>: \u003Cspan class=\"hljs-keyword\">new\u003C/span> \u003Cspan class=\"hljs-title class_\">JekyllGenerator\u003C/span>(\u003Cspan class=\"hljs-variable language_\">this\u003C/span>),\n            \u003Cspan class=\"hljs-attr\">hugo\u003C/span>: \u003Cspan class=\"hljs-keyword\">new\u003C/span> \u003Cspan class=\"hljs-title class_\">HugoGenerator\u003C/span>(\u003Cspan class=\"hljs-variable language_\">this\u003C/span>),\n            \u003Cspan class=\"hljs-attr\">mkdocs\u003C/span>: \u003Cspan class=\"hljs-keyword\">new\u003C/span> \u003Cspan class=\"hljs-title class_\">MkDocsGenerator\u003C/span>(\u003Cspan class=\"hljs-variable language_\">this\u003C/span>),\n            \u003Cspan class=\"hljs-attr\">docusaurus\u003C/span>: \u003Cspan class=\"hljs-keyword\">new\u003C/span> \u003Cspan class=\"hljs-title class_\">DocusaurusGenerator\u003C/span>(\u003Cspan class=\"hljs-variable language_\">this\u003C/span>)\n        };\n        \n        \u003Cspan class=\"hljs-variable language_\">this\u003C/span>.\u003Cspan class=\"hljs-property\">config\u003C/span> = {\n            \u003Cspan class=\"hljs-attr\">generator\u003C/span>: options.\u003Cspan class=\"hljs-property\">generator\u003C/span> || \u003Cspan class=\"hljs-string\">'jekyll'\u003C/span>,\n            \u003Cspan class=\"hljs-attr\">theme\u003C/span>: options.\u003Cspan class=\"hljs-property\">theme\u003C/span>,\n            \u003Cspan class=\"hljs-attr\">plugins\u003C/span>: options.\u003Cspan class=\"hljs-property\">plugins\u003C/span> || [],\n            \u003Cspan class=\"hljs-attr\">deployment\u003C/span>: options.\u003Cspan class=\"hljs-property\">deployment\u003C/span> || {},\n            \u003Cspan class=\"hljs-attr\">optimization\u003C/span>: options.\u003Cspan class=\"hljs-property\">optimization\u003C/span> || {}\n        };\n        \n        \u003Cspan class=\"hljs-variable language_\">this\u003C/span>.\u003Cspan class=\"hljs-property\">contentDirectory\u003C/span> = options.\u003Cspan class=\"hljs-property\">contentDirectory\u003C/span> || \u003Cspan class=\"hljs-string\">'content'\u003C/span>;\n        \u003Cspan class=\"hljs-variable language_\">this\u003C/span>.\u003Cspan class=\"hljs-property\">outputDirectory\u003C/span> = options.\u003Cspan class=\"hljs-property\">outputDirectory\u003C/span> || \u003Cspan class=\"hljs-string\">'dist'\u003C/span>;\n    }\n    \n    \u003Cspan class=\"hljs-keyword\">async\u003C/span> \u003Cspan class=\"hljs-title function_\">initializeProject\u003C/span>(\u003Cspan class=\"hljs-params\">generatorType, projectConfig = {}\u003C/span>) {\n        \u003Cspan class=\"hljs-variable language_\">console\u003C/span>.\u003Cspan class=\"hljs-title function_\">log\u003C/span>(\u003Cspan class=\"hljs-string\">`Initializing \u003Cspan class=\"hljs-subst\">${generatorType}\u003C/span> documentation site...`\u003C/span>);\n        \n        \u003Cspan class=\"hljs-keyword\">const\u003C/span> generator = \u003Cspan class=\"hljs-variable language_\">this\u003C/span>.\u003Cspan class=\"hljs-property\">generators\u003C/span>[generatorType];\n        \u003Cspan class=\"hljs-keyword\">if\u003C/span> (!generator) {\n            \u003Cspan class=\"hljs-keyword\">throw\u003C/span> \u003Cspan class=\"hljs-keyword\">new\u003C/span> \u003Cspan class=\"hljs-title class_\">Error\u003C/span>(\u003Cspan class=\"hljs-string\">`Unsupported generator: \u003Cspan class=\"hljs-subst\">${generatorType}\u003C/span>`\u003C/span>);\n        }\n        \n        \u003Cspan class=\"hljs-comment\">// Create project structure\u003C/span>\n        \u003Cspan class=\"hljs-keyword\">await\u003C/span> \u003Cspan class=\"hljs-variable language_\">this\u003C/span>.\u003Cspan class=\"hljs-title function_\">createProjectStructure\u003C/span>(generatorType, projectConfig);\n        \n        \u003Cspan class=\"hljs-comment\">// Initialize generator-specific configuration\u003C/span>\n        \u003Cspan class=\"hljs-keyword\">await\u003C/span> generator.\u003Cspan class=\"hljs-title function_\">initialize\u003C/span>(projectConfig);\n        \n        \u003Cspan class=\"hljs-comment\">// Set up theme and plugins\u003C/span>\n        \u003Cspan class=\"hljs-keyword\">if\u003C/span> (projectConfig.\u003Cspan class=\"hljs-property\">theme\u003C/span>) {\n            \u003Cspan class=\"hljs-keyword\">await\u003C/span> generator.\u003Cspan class=\"hljs-title function_\">installTheme\u003C/span>(projectConfig.\u003Cspan class=\"hljs-property\">theme\u003C/span>);\n        }\n        \n        \u003Cspan class=\"hljs-keyword\">if\u003C/span> (projectConfig.\u003Cspan class=\"hljs-property\">plugins\u003C/span> && projectConfig.\u003Cspan class=\"hljs-property\">plugins\u003C/span>.\u003Cspan class=\"hljs-property\">length\u003C/span> > \u003Cspan class=\"hljs-number\">0\u003C/span>) {\n            \u003Cspan class=\"hljs-keyword\">await\u003C/span> generator.\u003Cspan class=\"hljs-title function_\">installPlugins\u003C/span>(projectConfig.\u003Cspan class=\"hljs-property\">plugins\u003C/span>);\n        }\n        \n        \u003Cspan class=\"hljs-comment\">// Create sample content\u003C/span>\n        \u003Cspan class=\"hljs-keyword\">await\u003C/span> \u003Cspan class=\"hljs-variable language_\">this\u003C/span>.\u003Cspan class=\"hljs-title function_\">createSampleContent\u003C/span>(generatorType);\n        \n        \u003Cspan class=\"hljs-variable language_\">console\u003C/span>.\u003Cspan class=\"hljs-title function_\">log\u003C/span>(\u003Cspan class=\"hljs-string\">`\u003Cspan class=\"hljs-subst\">${generatorType}\u003C/span> project initialized successfully`\u003C/span>);\n        \u003Cspan class=\"hljs-keyword\">return\u003C/span> generator;\n    }\n    \n    \u003Cspan class=\"hljs-keyword\">async\u003C/span> \u003Cspan class=\"hljs-title function_\">createProjectStructure\u003C/span>(\u003Cspan class=\"hljs-params\">generatorType, config\u003C/span>) {\n        \u003Cspan class=\"hljs-keyword\">const\u003C/span> structures = {\n            \u003Cspan class=\"hljs-attr\">jekyll\u003C/span>: {\n                \u003Cspan class=\"hljs-attr\">directories\u003C/span>: [\n                    \u003Cspan class=\"hljs-string\">'_posts'\u003C/span>,\n                    \u003Cspan class=\"hljs-string\">'_pages'\u003C/span>, \n                    \u003Cspan class=\"hljs-string\">'_layouts'\u003C/span>,\n                    \u003Cspan class=\"hljs-string\">'_includes'\u003C/span>,\n                    \u003Cspan class=\"hljs-string\">'_sass'\u003C/span>,\n                    \u003Cspan class=\"hljs-string\">'assets/css'\u003C/span>,\n                    \u003Cspan class=\"hljs-string\">'assets/js'\u003C/span>,\n                    \u003Cspan class=\"hljs-string\">'assets/images'\u003C/span>\n                ],\n                \u003Cspan class=\"hljs-attr\">files\u003C/span>: {\n                    \u003Cspan class=\"hljs-string\">'_config.yml'\u003C/span>: \u003Cspan class=\"hljs-variable language_\">this\u003C/span>.\u003Cspan class=\"hljs-title function_\">generateJekyllConfig\u003C/span>(config),\n                    \u003Cspan class=\"hljs-string\">'Gemfile'\u003C/span>: \u003Cspan class=\"hljs-variable language_\">this\u003C/span>.\u003Cspan class=\"hljs-title function_\">generateJekyllGemfile\u003C/span>(config),\n                    \u003Cspan class=\"hljs-string\">'index.md'\u003C/span>: \u003Cspan class=\"hljs-variable language_\">this\u003C/span>.\u003Cspan class=\"hljs-title function_\">generateIndexPage\u003C/span>(config),\n                    \u003Cspan class=\"hljs-string\">'.gitignore'\u003C/span>: \u003Cspan class=\"hljs-variable language_\">this\u003C/span>.\u003Cspan class=\"hljs-title function_\">generateGitignore\u003C/span>(\u003Cspan class=\"hljs-string\">'jekyll'\u003C/span>)\n                }\n            },\n            \n            \u003Cspan class=\"hljs-attr\">hugo\u003C/span>: {\n                \u003Cspan class=\"hljs-attr\">directories\u003C/span>: [\n                    \u003Cspan class=\"hljs-string\">'content/posts'\u003C/span>,\n                    \u003Cspan class=\"hljs-string\">'content/docs'\u003C/span>,\n                    \u003Cspan class=\"hljs-string\">'layouts'\u003C/span>,\n                    \u003Cspan class=\"hljs-string\">'static/css'\u003C/span>,\n                    \u003Cspan class=\"hljs-string\">'static/js'\u003C/span>,\n                    \u003Cspan class=\"hljs-string\">'static/images'\u003C/span>,\n                    \u003Cspan class=\"hljs-string\">'data'\u003C/span>,\n                    \u003Cspan class=\"hljs-string\">'archetypes'\u003C/span>\n                ],\n                \u003Cspan class=\"hljs-attr\">files\u003C/span>: {\n                    \u003Cspan class=\"hljs-string\">'config.yaml'\u003C/span>: \u003Cspan class=\"hljs-variable language_\">this\u003C/span>.\u003Cspan class=\"hljs-title function_\">generateHugoConfig\u003C/span>(config),\n                    \u003Cspan class=\"hljs-string\">'content/_index.md'\u003C/span>: \u003Cspan class=\"hljs-variable language_\">this\u003C/span>.\u003Cspan class=\"hljs-title function_\">generateIndexPage\u003C/span>(config),\n                    \u003Cspan class=\"hljs-string\">'archetypes/default.md'\u003C/span>: \u003Cspan class=\"hljs-variable language_\">this\u003C/span>.\u003Cspan class=\"hljs-title function_\">generateHugoArchetype\u003C/span>(),\n                    \u003Cspan class=\"hljs-string\">'.gitignore'\u003C/span>: \u003Cspan class=\"hljs-variable language_\">this\u003C/span>.\u003Cspan class=\"hljs-title function_\">generateGitignore\u003C/span>(\u003Cspan class=\"hljs-string\">'hugo'\u003C/span>)\n                }\n            },\n            \n            \u003Cspan class=\"hljs-attr\">mkdocs\u003C/span>: {\n                \u003Cspan class=\"hljs-attr\">directories\u003C/span>: [\n                    \u003Cspan class=\"hljs-string\">'docs'\u003C/span>,\n                    \u003Cspan class=\"hljs-string\">'docs/assets'\u003C/span>,\n                    \u003Cspan class=\"hljs-string\">'docs/stylesheets'\u003C/span>,\n                    \u003Cspan class=\"hljs-string\">'docs/javascripts'\u003C/span>\n                ],\n                \u003Cspan class=\"hljs-attr\">files\u003C/span>: {\n                    \u003Cspan class=\"hljs-string\">'mkdocs.yml'\u003C/span>: \u003Cspan class=\"hljs-variable language_\">this\u003C/span>.\u003Cspan class=\"hljs-title function_\">generateMkDocsConfig\u003C/span>(config),\n                    \u003Cspan class=\"hljs-string\">'docs/index.md'\u003C/span>: \u003Cspan class=\"hljs-variable language_\">this\u003C/span>.\u003Cspan class=\"hljs-title function_\">generateIndexPage\u003C/span>(config),\n                    \u003Cspan class=\"hljs-string\">'requirements.txt'\u003C/span>: \u003Cspan class=\"hljs-variable language_\">this\u003C/span>.\u003Cspan class=\"hljs-title function_\">generateMkDocsRequirements\u003C/span>(config),\n                    \u003Cspan class=\"hljs-string\">'.gitignore'\u003C/span>: \u003Cspan class=\"hljs-variable language_\">this\u003C/span>.\u003Cspan class=\"hljs-title function_\">generateGitignore\u003C/span>(\u003Cspan class=\"hljs-string\">'mkdocs'\u003C/span>)\n                }\n            },\n            \n            \u003Cspan class=\"hljs-attr\">docusaurus\u003C/span>: {\n                \u003Cspan class=\"hljs-attr\">directories\u003C/span>: [\n                    \u003Cspan class=\"hljs-string\">'docs'\u003C/span>,\n                    \u003Cspan class=\"hljs-string\">'blog'\u003C/span>,\n                    \u003Cspan class=\"hljs-string\">'src/components'\u003C/span>,\n                    \u003Cspan class=\"hljs-string\">'src/pages'\u003C/span>,\n                    \u003Cspan class=\"hljs-string\">'static/img'\u003C/span>\n                ],\n                \u003Cspan class=\"hljs-attr\">files\u003C/span>: {\n                    \u003Cspan class=\"hljs-string\">'docusaurus.config.js'\u003C/span>: \u003Cspan class=\"hljs-variable language_\">this\u003C/span>.\u003Cspan class=\"hljs-title function_\">generateDocusaurusConfig\u003C/span>(config),\n                    \u003Cspan class=\"hljs-string\">'package.json'\u003C/span>: \u003Cspan class=\"hljs-variable language_\">this\u003C/span>.\u003Cspan class=\"hljs-title function_\">generateDocusaurusPackageJson\u003C/span>(config),\n                    \u003Cspan class=\"hljs-string\">'docs/intro.md'\u003C/span>: \u003Cspan class=\"hljs-variable language_\">this\u003C/span>.\u003Cspan class=\"hljs-title function_\">generateIndexPage\u003C/span>(config),\n                    \u003Cspan class=\"hljs-string\">'.gitignore'\u003C/span>: \u003Cspan class=\"hljs-variable language_\">this\u003C/span>.\u003Cspan class=\"hljs-title function_\">generateGitignore\u003C/span>(\u003Cspan class=\"hljs-string\">'docusaurus'\u003C/span>)\n                }\n            }\n        };\n        \n        \u003Cspan class=\"hljs-keyword\">const\u003C/span> structure = structures[generatorType];\n        \u003Cspan class=\"hljs-keyword\">if\u003C/span> (!structure) {\n            \u003Cspan class=\"hljs-keyword\">throw\u003C/span> \u003Cspan class=\"hljs-keyword\">new\u003C/span> \u003Cspan class=\"hljs-title class_\">Error\u003C/span>(\u003Cspan class=\"hljs-string\">`No structure defined for \u003Cspan class=\"hljs-subst\">${generatorType}\u003C/span>`\u003C/span>);\n        }\n        \n        \u003Cspan class=\"hljs-comment\">// Create directories\u003C/span>\n        \u003Cspan class=\"hljs-keyword\">for\u003C/span> (\u003Cspan class=\"hljs-keyword\">const\u003C/span> dir \u003Cspan class=\"hljs-keyword\">of\u003C/span> structure.\u003Cspan class=\"hljs-property\">directories\u003C/span>) {\n            \u003Cspan class=\"hljs-keyword\">const\u003C/span> dirPath = path.\u003Cspan class=\"hljs-title function_\">join\u003C/span>(\u003Cspan class=\"hljs-variable language_\">this\u003C/span>.\u003Cspan class=\"hljs-property\">projectRoot\u003C/span>, dir);\n            \u003Cspan class=\"hljs-keyword\">await\u003C/span> fs.\u003Cspan class=\"hljs-title function_\">mkdir\u003C/span>(dirPath, { \u003Cspan class=\"hljs-attr\">recursive\u003C/span>: \u003Cspan class=\"hljs-literal\">true\u003C/span> });\n        }\n        \n        \u003Cspan class=\"hljs-comment\">// Create files\u003C/span>\n        \u003Cspan class=\"hljs-keyword\">for\u003C/span> (\u003Cspan class=\"hljs-keyword\">const\u003C/span> [fileName, content] \u003Cspan class=\"hljs-keyword\">of\u003C/span> \u003Cspan class=\"hljs-title class_\">Object\u003C/span>.\u003Cspan class=\"hljs-title function_\">entries\u003C/span>(structure.\u003Cspan class=\"hljs-property\">files\u003C/span>)) {\n            \u003Cspan class=\"hljs-keyword\">const\u003C/span> filePath = path.\u003Cspan class=\"hljs-title function_\">join\u003C/span>(\u003Cspan class=\"hljs-variable language_\">this\u003C/span>.\u003Cspan class=\"hljs-property\">projectRoot\u003C/span>, fileName);\n            \u003Cspan class=\"hljs-keyword\">await\u003C/span> fs.\u003Cspan class=\"hljs-title function_\">writeFile\u003C/span>(filePath, content);\n        }\n    }\n    \n    \u003Cspan class=\"hljs-title function_\">generateJekyllConfig\u003C/span>(\u003Cspan class=\"hljs-params\">config\u003C/span>) {\n        \u003Cspan class=\"hljs-keyword\">const\u003C/span> jekyllConfig = {\n            \u003Cspan class=\"hljs-attr\">title\u003C/span>: config.\u003Cspan class=\"hljs-property\">title\u003C/span> || \u003Cspan class=\"hljs-string\">'Documentation Site'\u003C/span>,\n            \u003Cspan class=\"hljs-attr\">description\u003C/span>: config.\u003Cspan class=\"hljs-property\">description\u003C/span> || \u003Cspan class=\"hljs-string\">'A comprehensive documentation site built with Jekyll'\u003C/span>,\n            \u003Cspan class=\"hljs-attr\">baseurl\u003C/span>: config.\u003Cspan class=\"hljs-property\">baseurl\u003C/span> || \u003Cspan class=\"hljs-string\">''\u003C/span>,\n            \u003Cspan class=\"hljs-attr\">url\u003C/span>: config.\u003Cspan class=\"hljs-property\">url\u003C/span> || \u003Cspan class=\"hljs-string\">'https://example.com'\u003C/span>,\n            \n            \u003Cspan class=\"hljs-comment\">// Build settings\u003C/span>\n            \u003Cspan class=\"hljs-attr\">markdown\u003C/span>: \u003Cspan class=\"hljs-string\">'kramdown'\u003C/span>,\n            \u003Cspan class=\"hljs-attr\">highlighter\u003C/span>: \u003Cspan class=\"hljs-string\">'rouge'\u003C/span>,\n            \u003Cspan class=\"hljs-attr\">theme\u003C/span>: config.\u003Cspan class=\"hljs-property\">theme\u003C/span> || \u003Cspan class=\"hljs-string\">'minima'\u003C/span>,\n            \n            \u003Cspan class=\"hljs-comment\">// Collections\u003C/span>\n            \u003Cspan class=\"hljs-attr\">collections\u003C/span>: {\n                \u003Cspan class=\"hljs-attr\">docs\u003C/span>: {\n                    \u003Cspan class=\"hljs-attr\">output\u003C/span>: \u003Cspan class=\"hljs-literal\">true\u003C/span>,\n                    \u003Cspan class=\"hljs-attr\">permalink\u003C/span>: \u003Cspan class=\"hljs-string\">'/:collection/:name/'\u003C/span>\n                }\n            },\n            \n            \u003Cspan class=\"hljs-comment\">// Plugins\u003C/span>\n            \u003Cspan class=\"hljs-attr\">plugins\u003C/span>: [\n                \u003Cspan class=\"hljs-string\">'jekyll-feed'\u003C/span>,\n                \u003Cspan class=\"hljs-string\">'jekyll-sitemap'\u003C/span>,\n                \u003Cspan class=\"hljs-string\">'jekyll-seo-tag'\u003C/span>,\n                ...(config.\u003Cspan class=\"hljs-property\">plugins\u003C/span> || [])\n            ],\n            \n            \u003Cspan class=\"hljs-comment\">// Kramdown settings\u003C/span>\n            \u003Cspan class=\"hljs-attr\">kramdown\u003C/span>: {\n                \u003Cspan class=\"hljs-attr\">input\u003C/span>: \u003Cspan class=\"hljs-string\">'GFM'\u003C/span>,\n                \u003Cspan class=\"hljs-attr\">hard_wrap\u003C/span>: \u003Cspan class=\"hljs-literal\">false\u003C/span>,\n                \u003Cspan class=\"hljs-attr\">syntax_highlighter\u003C/span>: \u003Cspan class=\"hljs-string\">'rouge'\u003C/span>,\n                \u003Cspan class=\"hljs-attr\">syntax_highlighter_opts\u003C/span>: {\n                    \u003Cspan class=\"hljs-attr\">css_class\u003C/span>: \u003Cspan class=\"hljs-string\">'highlight'\u003C/span>,\n                    \u003Cspan class=\"hljs-attr\">span\u003C/span>: {\n                        \u003Cspan class=\"hljs-attr\">line_numbers\u003C/span>: \u003Cspan class=\"hljs-literal\">false\u003C/span>\n                    },\n                    \u003Cspan class=\"hljs-attr\">block\u003C/span>: {\n                        \u003Cspan class=\"hljs-attr\">line_numbers\u003C/span>: \u003Cspan class=\"hljs-literal\">true\u003C/span>\n                    }\n                }\n            },\n            \n            \u003Cspan class=\"hljs-comment\">// Exclude from processing\u003C/span>\n            \u003Cspan class=\"hljs-attr\">exclude\u003C/span>: [\n                \u003Cspan class=\"hljs-string\">'Gemfile'\u003C/span>,\n                \u003Cspan class=\"hljs-string\">'Gemfile.lock'\u003C/span>,\n                \u003Cspan class=\"hljs-string\">'node_modules'\u003C/span>,\n                \u003Cspan class=\"hljs-string\">'vendor'\u003C/span>,\n                \u003Cspan class=\"hljs-string\">'README.md'\u003C/span>\n            ]\n        };\n        \n        \u003Cspan class=\"hljs-keyword\">return\u003C/span> yaml.\u003Cspan class=\"hljs-title function_\">dump\u003C/span>(jekyllConfig);\n    }\n    \n    \u003Cspan class=\"hljs-title function_\">generateHugoConfig\u003C/span>(\u003Cspan class=\"hljs-params\">config\u003C/span>) {\n        \u003Cspan class=\"hljs-keyword\">const\u003C/span> hugoConfig = {\n            \u003Cspan class=\"hljs-attr\">title\u003C/span>: config.\u003Cspan class=\"hljs-property\">title\u003C/span> || \u003Cspan class=\"hljs-string\">'Documentation Site'\u003C/span>,\n            \u003Cspan class=\"hljs-attr\">description\u003C/span>: config.\u003Cspan class=\"hljs-property\">description\u003C/span> || \u003Cspan class=\"hljs-string\">'A comprehensive documentation site built with Hugo'\u003C/span>,\n            \u003Cspan class=\"hljs-attr\">baseURL\u003C/span>: config.\u003Cspan class=\"hljs-property\">baseurl\u003C/span> || \u003Cspan class=\"hljs-string\">'https://example.com'\u003C/span>,\n            \u003Cspan class=\"hljs-attr\">languageCode\u003C/span>: config.\u003Cspan class=\"hljs-property\">language\u003C/span> || \u003Cspan class=\"hljs-string\">'en-us'\u003C/span>,\n            \n            \u003Cspan class=\"hljs-comment\">// Theme\u003C/span>\n            \u003Cspan class=\"hljs-attr\">theme\u003C/span>: config.\u003Cspan class=\"hljs-property\">theme\u003C/span> || \u003Cspan class=\"hljs-string\">'docsy'\u003C/span>,\n            \n            \u003Cspan class=\"hljs-comment\">// Markup\u003C/span>\n            \u003Cspan class=\"hljs-attr\">markup\u003C/span>: {\n                \u003Cspan class=\"hljs-attr\">goldmark\u003C/span>: {\n                    \u003Cspan class=\"hljs-attr\">renderer\u003C/span>: {\n                        \u003Cspan class=\"hljs-attr\">unsafe\u003C/span>: \u003Cspan class=\"hljs-literal\">true\u003C/span>\n                    }\n                },\n                \u003Cspan class=\"hljs-attr\">highlight\u003C/span>: {\n                    \u003Cspan class=\"hljs-attr\">style\u003C/span>: \u003Cspan class=\"hljs-string\">'github'\u003C/span>,\n                    \u003Cspan class=\"hljs-attr\">lineNos\u003C/span>: \u003Cspan class=\"hljs-literal\">true\u003C/span>,\n                    \u003Cspan class=\"hljs-attr\">codeFences\u003C/span>: \u003Cspan class=\"hljs-literal\">true\u003C/span>\n                }\n            },\n            \n            \u003Cspan class=\"hljs-comment\">// Parameters\u003C/span>\n            \u003Cspan class=\"hljs-attr\">params\u003C/span>: {\n                \u003Cspan class=\"hljs-attr\">version\u003C/span>: config.\u003Cspan class=\"hljs-property\">version\u003C/span> || \u003Cspan class=\"hljs-string\">'1.0.0'\u003C/span>,\n                \u003Cspan class=\"hljs-attr\">github_repo\u003C/span>: config.\u003Cspan class=\"hljs-property\">github_repo\u003C/span> || \u003Cspan class=\"hljs-string\">''\u003C/span>,\n                \u003Cspan class=\"hljs-attr\">edit_page\u003C/span>: \u003Cspan class=\"hljs-literal\">true\u003C/span>,\n                \u003Cspan class=\"hljs-attr\">search\u003C/span>: {\n                    \u003Cspan class=\"hljs-attr\">enabled\u003C/span>: \u003Cspan class=\"hljs-literal\">true\u003C/span>\n                }\n            },\n            \n            \u003Cspan class=\"hljs-comment\">// Menu\u003C/span>\n            \u003Cspan class=\"hljs-attr\">menu\u003C/span>: {\n                \u003Cspan class=\"hljs-attr\">main\u003C/span>: [\n                    {\n                        \u003Cspan class=\"hljs-attr\">name\u003C/span>: \u003Cspan class=\"hljs-string\">'Documentation'\u003C/span>,\n                        \u003Cspan class=\"hljs-attr\">url\u003C/span>: \u003Cspan class=\"hljs-string\">'/docs/'\u003C/span>,\n                        \u003Cspan class=\"hljs-attr\">weight\u003C/span>: \u003Cspan class=\"hljs-number\">10\u003C/span>\n                    },\n                    {\n                        \u003Cspan class=\"hljs-attr\">name\u003C/span>: \u003Cspan class=\"hljs-string\">'Blog'\u003C/span>,\n                        \u003Cspan class=\"hljs-attr\">url\u003C/span>: \u003Cspan class=\"hljs-string\">'/blog/'\u003C/span>,\n                        \u003Cspan class=\"hljs-attr\">weight\u003C/span>: \u003Cspan class=\"hljs-number\">20\u003C/span>\n                    }\n                ]\n            },\n            \n            \u003Cspan class=\"hljs-comment\">// Output formats\u003C/span>\n            \u003Cspan class=\"hljs-attr\">outputs\u003C/span>: {\n                \u003Cspan class=\"hljs-attr\">home\u003C/span>: [\u003Cspan class=\"hljs-string\">'HTML'\u003C/span>, \u003Cspan class=\"hljs-string\">'RSS'\u003C/span>, \u003Cspan class=\"hljs-string\">'JSON'\u003C/span>],\n                \u003Cspan class=\"hljs-attr\">page\u003C/span>: [\u003Cspan class=\"hljs-string\">'HTML'\u003C/span>],\n                \u003Cspan class=\"hljs-attr\">section\u003C/span>: [\u003Cspan class=\"hljs-string\">'HTML'\u003C/span>, \u003Cspan class=\"hljs-string\">'RSS'\u003C/span>]\n            }\n        };\n        \n        \u003Cspan class=\"hljs-keyword\">return\u003C/span> yaml.\u003Cspan class=\"hljs-title function_\">dump\u003C/span>(hugoConfig);\n    }\n    \n    \u003Cspan class=\"hljs-title function_\">generateMkDocsConfig\u003C/span>(\u003Cspan class=\"hljs-params\">config\u003C/span>) {\n        \u003Cspan class=\"hljs-keyword\">const\u003C/span> mkdocsConfig = {\n            \u003Cspan class=\"hljs-attr\">site_name\u003C/span>: config.\u003Cspan class=\"hljs-property\">title\u003C/span> || \u003Cspan class=\"hljs-string\">'Documentation Site'\u003C/span>,\n            \u003Cspan class=\"hljs-attr\">site_description\u003C/span>: config.\u003Cspan class=\"hljs-property\">description\u003C/span> || \u003Cspan class=\"hljs-string\">'A comprehensive documentation site built with MkDocs'\u003C/span>,\n            \u003Cspan class=\"hljs-attr\">site_url\u003C/span>: config.\u003Cspan class=\"hljs-property\">url\u003C/span> || \u003Cspan class=\"hljs-string\">'https://example.com'\u003C/span>,\n            \u003Cspan class=\"hljs-attr\">site_author\u003C/span>: config.\u003Cspan class=\"hljs-property\">author\u003C/span> || \u003Cspan class=\"hljs-string\">'Documentation Team'\u003C/span>,\n            \n            \u003Cspan class=\"hljs-comment\">// Repository\u003C/span>\n            \u003Cspan class=\"hljs-attr\">repo_url\u003C/span>: config.\u003Cspan class=\"hljs-property\">github_repo\u003C/span> || \u003Cspan class=\"hljs-string\">''\u003C/span>,\n            \u003Cspan class=\"hljs-attr\">repo_name\u003C/span>: config.\u003Cspan class=\"hljs-property\">repo_name\u003C/span> || \u003Cspan class=\"hljs-string\">'GitHub'\u003C/span>,\n            \u003Cspan class=\"hljs-attr\">edit_uri\u003C/span>: \u003Cspan class=\"hljs-string\">'edit/main/docs/'\u003C/span>,\n            \n            \u003Cspan class=\"hljs-comment\">// Theme\u003C/span>\n            \u003Cspan class=\"hljs-attr\">theme\u003C/span>: {\n                \u003Cspan class=\"hljs-attr\">name\u003C/span>: config.\u003Cspan class=\"hljs-property\">theme\u003C/span> || \u003Cspan class=\"hljs-string\">'material'\u003C/span>,\n                \u003Cspan class=\"hljs-attr\">features\u003C/span>: [\n                    \u003Cspan class=\"hljs-string\">'navigation.tabs'\u003C/span>,\n                    \u003Cspan class=\"hljs-string\">'navigation.sections'\u003C/span>,\n                    \u003Cspan class=\"hljs-string\">'navigation.expand'\u003C/span>,\n                    \u003Cspan class=\"hljs-string\">'navigation.top'\u003C/span>,\n                    \u003Cspan class=\"hljs-string\">'search.highlight'\u003C/span>,\n                    \u003Cspan class=\"hljs-string\">'search.share'\u003C/span>,\n                    \u003Cspan class=\"hljs-string\">'content.code.copy'\u003C/span>\n                ],\n                \u003Cspan class=\"hljs-attr\">palette\u003C/span>: [\n                    {\n                        \u003Cspan class=\"hljs-attr\">scheme\u003C/span>: \u003Cspan class=\"hljs-string\">'default'\u003C/span>,\n                        \u003Cspan class=\"hljs-attr\">primary\u003C/span>: \u003Cspan class=\"hljs-string\">'blue'\u003C/span>,\n                        \u003Cspan class=\"hljs-attr\">accent\u003C/span>: \u003Cspan class=\"hljs-string\">'blue'\u003C/span>,\n                        \u003Cspan class=\"hljs-attr\">toggle\u003C/span>: {\n                            \u003Cspan class=\"hljs-attr\">icon\u003C/span>: \u003Cspan class=\"hljs-string\">'material/brightness-7'\u003C/span>,\n                            \u003Cspan class=\"hljs-attr\">name\u003C/span>: \u003Cspan class=\"hljs-string\">'Switch to dark mode'\u003C/span>\n                        }\n                    },\n                    {\n                        \u003Cspan class=\"hljs-attr\">scheme\u003C/span>: \u003Cspan class=\"hljs-string\">'slate'\u003C/span>,\n                        \u003Cspan class=\"hljs-attr\">primary\u003C/span>: \u003Cspan class=\"hljs-string\">'blue'\u003C/span>,\n                        \u003Cspan class=\"hljs-attr\">accent\u003C/span>: \u003Cspan class=\"hljs-string\">'blue'\u003C/span>,\n                        \u003Cspan class=\"hljs-attr\">toggle\u003C/span>: {\n                            \u003Cspan class=\"hljs-attr\">icon\u003C/span>: \u003Cspan class=\"hljs-string\">'material/brightness-4'\u003C/span>,\n                            \u003Cspan class=\"hljs-attr\">name\u003C/span>: \u003Cspan class=\"hljs-string\">'Switch to light mode'\u003C/span>\n                        }\n                    }\n                ]\n            },\n            \n            \u003Cspan class=\"hljs-comment\">// Plugins\u003C/span>\n            \u003Cspan class=\"hljs-attr\">plugins\u003C/span>: [\n                \u003Cspan class=\"hljs-string\">'search'\u003C/span>,\n                \u003Cspan class=\"hljs-string\">'minify'\u003C/span>,\n                {\n                    \u003Cspan class=\"hljs-string\">'git-revision-date-localized'\u003C/span>: {\n                        \u003Cspan class=\"hljs-attr\">type\u003C/span>: \u003Cspan class=\"hljs-string\">'date'\u003C/span>\n                    }\n                }\n            ],\n            \n            \u003Cspan class=\"hljs-comment\">// Markdown extensions\u003C/span>\n            \u003Cspan class=\"hljs-attr\">markdown_extensions\u003C/span>: [\n                \u003Cspan class=\"hljs-string\">'abbr'\u003C/span>,\n                \u003Cspan class=\"hljs-string\">'admonition'\u003C/span>,\n                \u003Cspan class=\"hljs-string\">'attr_list'\u003C/span>,\n                \u003Cspan class=\"hljs-string\">'codehilite'\u003C/span>,\n                \u003Cspan class=\"hljs-string\">'def_list'\u003C/span>,\n                \u003Cspan class=\"hljs-string\">'footnotes'\u003C/span>,\n                \u003Cspan class=\"hljs-string\">'meta'\u003C/span>,\n                \u003Cspan class=\"hljs-string\">'md_in_html'\u003C/span>,\n                \u003Cspan class=\"hljs-string\">'tables'\u003C/span>,\n                \u003Cspan class=\"hljs-string\">'toc'\u003C/span>,\n                \u003Cspan class=\"hljs-string\">'pymdownx.arithmatex'\u003C/span>,\n                \u003Cspan class=\"hljs-string\">'pymdownx.betterem'\u003C/span>,\n                \u003Cspan class=\"hljs-string\">'pymdownx.caret'\u003C/span>,\n                \u003Cspan class=\"hljs-string\">'pymdownx.details'\u003C/span>,\n                \u003Cspan class=\"hljs-string\">'pymdownx.highlight'\u003C/span>,\n                \u003Cspan class=\"hljs-string\">'pymdownx.inlinehilite'\u003C/span>,\n                \u003Cspan class=\"hljs-string\">'pymdownx.keys'\u003C/span>,\n                \u003Cspan class=\"hljs-string\">'pymdownx.mark'\u003C/span>,\n                \u003Cspan class=\"hljs-string\">'pymdownx.smartsymbols'\u003C/span>,\n                \u003Cspan class=\"hljs-string\">'pymdownx.superfences'\u003C/span>,\n                \u003Cspan class=\"hljs-string\">'pymdownx.tabbed'\u003C/span>,\n                \u003Cspan class=\"hljs-string\">'pymdownx.tasklist'\u003C/span>,\n                \u003Cspan class=\"hljs-string\">'pymdownx.tilde'\u003C/span>\n            ],\n            \n            \u003Cspan class=\"hljs-comment\">// Navigation\u003C/span>\n            \u003Cspan class=\"hljs-attr\">nav\u003C/span>: [\n                {\n                    \u003Cspan class=\"hljs-string\">'Home'\u003C/span>: \u003Cspan class=\"hljs-string\">'index.md'\u003C/span>\n                },\n                {\n                    \u003Cspan class=\"hljs-string\">'User Guide'\u003C/span>: [\n                        \u003Cspan class=\"hljs-string\">'user-guide/getting-started.md'\u003C/span>,\n                        \u003Cspan class=\"hljs-string\">'user-guide/configuration.md'\u003C/span>\n                    ]\n                },\n                {\n                    \u003Cspan class=\"hljs-string\">'API Reference'\u003C/span>: [\n                        \u003Cspan class=\"hljs-string\">'api/overview.md'\u003C/span>\n                    ]\n                }\n            ]\n        };\n        \n        \u003Cspan class=\"hljs-keyword\">return\u003C/span> yaml.\u003Cspan class=\"hljs-title function_\">dump\u003C/span>(mkdocsConfig);\n    }\n    \n    \u003Cspan class=\"hljs-title function_\">generateDocusaurusConfig\u003C/span>(\u003Cspan class=\"hljs-params\">config\u003C/span>) {\n        \u003Cspan class=\"hljs-keyword\">return\u003C/span> \u003Cspan class=\"hljs-string\">`// @ts-check\n// Note: type annotations allow type checking and IDEs autocompletion\n\nconst lightCodeTheme = require('prism-react-renderer/themes/github');\nconst darkCodeTheme = require('prism-react-renderer/themes/dracula');\n\n/** @type {import('@docusaurus/types').Config} */\nconst config = {\n  title: '\u003Cspan class=\"hljs-subst\">${config.title || \u003Cspan class=\"hljs-string\">'Documentation Site'\u003C/span>}\u003C/span>',\n  tagline: '\u003Cspan class=\"hljs-subst\">${config.description || \u003Cspan class=\"hljs-string\">'Comprehensive documentation site'\u003C/span>}\u003C/span>',\n  favicon: 'img/favicon.ico',\n\n  // Set the production url of your site here\n  url: '\u003Cspan class=\"hljs-subst\">${config.url || \u003Cspan class=\"hljs-string\">'https://example.com'\u003C/span>}\u003C/span>',\n  // Set the /<baseUrl>/ pathname under which your site is served\n  baseUrl: '\u003Cspan class=\"hljs-subst\">${config.baseurl || \u003Cspan class=\"hljs-string\">'/'\u003C/span>}\u003C/span>',\n\n  // GitHub pages deployment config\n  organizationName: '\u003Cspan class=\"hljs-subst\">${config.github_org || \u003Cspan class=\"hljs-string\">'your-org'\u003C/span>}\u003C/span>',\n  projectName: '\u003Cspan class=\"hljs-subst\">${config.project_name || \u003Cspan class=\"hljs-string\">'your-project'\u003C/span>}\u003C/span>',\n\n  onBrokenLinks: 'throw',\n  onBrokenMarkdownLinks: 'warn',\n\n  // Even if you don't use internalization, you can use this field to set useful\n  // metadata like html lang. For example, if your site is Chinese, you may want\n  // to replace "en" with "zh-Hans".\n  i18n: {\n    defaultLocale: 'en',\n    locales: ['en'],\n  },\n\n  presets: [\n    [\n      'classic',\n      /** @type {import('@docusaurus/preset-classic').Options} */\n      ({\n        docs: {\n          sidebarPath: require.resolve('./sidebars.js'),\n          editUrl: '\u003Cspan class=\"hljs-subst\">${config.edit_url || \u003Cspan class=\"hljs-string\">'https://github.com/your-org/your-project/tree/main/'\u003C/span>}\u003C/span>',\n          showLastUpdateAuthor: true,\n          showLastUpdateTime: true,\n        },\n        blog: {\n          showReadingTime: true,\n          editUrl: '\u003Cspan class=\"hljs-subst\">${config.edit_url || \u003Cspan class=\"hljs-string\">'https://github.com/your-org/your-project/tree/main/'\u003C/span>}\u003C/span>',\n        },\n        theme: {\n          customCss: require.resolve('./src/css/custom.css'),\n        },\n      }),\n    ],\n  ],\n\n  themeConfig:\n    /** @type {import('@docusaurus/preset-classic').ThemeConfig} */\n    ({\n      // Replace with your project's social card\n      image: 'img/docusaurus-social-card.jpg',\n      navbar: {\n        title: '\u003Cspan class=\"hljs-subst\">${config.title || \u003Cspan class=\"hljs-string\">'Documentation'\u003C/span>}\u003C/span>',\n        logo: {\n          alt: 'Logo',\n          src: 'img/logo.svg',\n        },\n        items: [\n          {\n            type: 'docSidebar',\n            sidebarId: 'tutorialSidebar',\n            position: 'left',\n            label: 'Tutorial',\n          },\n          {to: '/blog', label: 'Blog', position: 'left'},\n          {\n            href: '\u003Cspan class=\"hljs-subst\">${config.github_repo || \u003Cspan class=\"hljs-string\">'https://github.com/your-org/your-project'\u003C/span>}\u003C/span>',\n            label: 'GitHub',\n            position: 'right',\n          },\n        ],\n      },\n      footer: {\n        style: 'dark',\n        links: [\n          {\n            title: 'Docs',\n            items: [\n              {\n                label: 'Tutorial',\n                to: '/docs/intro',\n              },\n            ],\n          },\n          {\n            title: 'Community',\n            items: [\n              {\n                label: 'Stack Overflow',\n                href: 'https://stackoverflow.com/questions/tagged/docusaurus',\n              },\n              {\n                label: 'Discord',\n                href: 'https://discordapp.com/invite/docusaurus',\n              },\n              {\n                label: 'Twitter',\n                href: 'https://twitter.com/docusaurus',\n              },\n            ],\n          },\n          {\n            title: 'More',\n            items: [\n              {\n                label: 'Blog',\n                to: '/blog',\n              },\n              {\n                label: 'GitHub',\n                href: '\u003Cspan class=\"hljs-subst\">${config.github_repo || \u003Cspan class=\"hljs-string\">'https://github.com/your-org/your-project'\u003C/span>}\u003C/span>',\n              },\n            ],\n          },\n        ],\n        copyright: \\`Copyright © \\${new Date().getFullYear()} \u003Cspan class=\"hljs-subst\">${config.title || \u003Cspan class=\"hljs-string\">'Documentation Site'\u003C/span>}\u003C/span>. Built with Docusaurus.\\`,\n      },\n      prism: {\n        theme: lightCodeTheme,\n        darkTheme: darkCodeTheme,\n      },\n    }),\n};\n\nmodule.exports = config;\n`\u003C/span>;\n    }\n    \n    \u003Cspan class=\"hljs-title function_\">generateIndexPage\u003C/span>(\u003Cspan class=\"hljs-params\">config\u003C/span>) {\n        \u003Cspan class=\"hljs-keyword\">return\u003C/span> \u003Cspan class=\"hljs-string\">`---\ntitle: \u003Cspan class=\"hljs-subst\">${config.title || \u003Cspan class=\"hljs-string\">'Welcome to Our Documentation'\u003C/span>}\u003C/span>\ndescription: \u003Cspan class=\"hljs-subst\">${config.description || \u003Cspan class=\"hljs-string\">'Comprehensive documentation and guides'\u003C/span>}\u003C/span>\n---\n\n# \u003Cspan class=\"hljs-subst\">${config.title || \u003Cspan class=\"hljs-string\">'Welcome to Our Documentation'\u003C/span>}\u003C/span>\n\n\u003Cspan class=\"hljs-subst\">${config.description || \u003Cspan class=\"hljs-string\">'This is a comprehensive documentation site built with modern static site generation tools.'\u003C/span>}\u003C/span>\n\n## Getting Started\n\nThis documentation covers:\n\n- **User Guides** - Step-by-step instructions for common tasks\n- **API Reference** - Complete API documentation with examples  \n- **Tutorials** - In-depth tutorials and learning materials\n- **Examples** - Practical examples and use cases\n\n## Quick Navigation\n\n### For New Users\n- [Getting Started Guide](getting-started.md)\n- [Installation Instructions](installation.md)\n- [Basic Configuration](configuration.md)\n\n### For Developers\n- [API Reference](api/reference.md)\n- [SDK Documentation](sdk/overview.md)\n- [Code Examples](examples/index.md)\n\n### For Contributors\n- [Contributing Guidelines](contributing.md)\n- [Development Setup](development.md)\n- [Style Guide](style-guide.md)\n\n## Need Help?\n\n- Check our [FAQ](faq.md) for common questions\n- Visit our [Troubleshooting Guide](troubleshooting.md)\n- Join our [Community Forum](https://community.example.com)\n- Report issues on [GitHub](https://github.com/example/project/issues)\n\n---\n\n*This documentation is continuously updated. Last updated: \u003Cspan class=\"hljs-subst\">${\u003Cspan class=\"hljs-keyword\">new\u003C/span> \u003Cspan class=\"hljs-built_in\">Date\u003C/span>().toISOString().split(\u003Cspan class=\"hljs-string\">'T'\u003C/span>)[\u003Cspan class=\"hljs-number\">0\u003C/span>]}\u003C/span>*\n`\u003C/span>;\n    }\n    \n    \u003Cspan class=\"hljs-keyword\">async\u003C/span> \u003Cspan class=\"hljs-title function_\">createSampleContent\u003C/span>(\u003Cspan class=\"hljs-params\">generatorType\u003C/span>) {\n        \u003Cspan class=\"hljs-keyword\">const\u003C/span> sampleFiles = {\n            \u003Cspan class=\"hljs-attr\">jekyll\u003C/span>: {\n                \u003Cspan class=\"hljs-string\">'_posts/2025-01-01-welcome-to-jekyll.md'\u003C/span>: \u003Cspan class=\"hljs-variable language_\">this\u003C/span>.\u003Cspan class=\"hljs-title function_\">generateSamplePost\u003C/span>(\u003Cspan class=\"hljs-string\">'Jekyll'\u003C/span>),\n                \u003Cspan class=\"hljs-string\">'_pages/about.md'\u003C/span>: \u003Cspan class=\"hljs-variable language_\">this\u003C/span>.\u003Cspan class=\"hljs-title function_\">generateAboutPage\u003C/span>(),\n                \u003Cspan class=\"hljs-string\">'_pages/contact.md'\u003C/span>: \u003Cspan class=\"hljs-variable language_\">this\u003C/span>.\u003Cspan class=\"hljs-title function_\">generateContactPage\u003C/span>()\n            },\n            \n            \u003Cspan class=\"hljs-attr\">hugo\u003C/span>: {\n                \u003Cspan class=\"hljs-string\">'content/posts/welcome-to-hugo.md'\u003C/span>: \u003Cspan class=\"hljs-variable language_\">this\u003C/span>.\u003Cspan class=\"hljs-title function_\">generateSamplePost\u003C/span>(\u003Cspan class=\"hljs-string\">'Hugo'\u003C/span>),\n                \u003Cspan class=\"hljs-string\">'content/docs/getting-started.md'\u003C/span>: \u003Cspan class=\"hljs-variable language_\">this\u003C/span>.\u003Cspan class=\"hljs-title function_\">generateGettingStartedGuide\u003C/span>(),\n                \u003Cspan class=\"hljs-string\">'content/about.md'\u003C/span>: \u003Cspan class=\"hljs-variable language_\">this\u003C/span>.\u003Cspan class=\"hljs-title function_\">generateAboutPage\u003C/span>()\n            },\n            \n            \u003Cspan class=\"hljs-attr\">mkdocs\u003C/span>: {\n                \u003Cspan class=\"hljs-string\">'docs/getting-started.md'\u003C/span>: \u003Cspan class=\"hljs-variable language_\">this\u003C/span>.\u003Cspan class=\"hljs-title function_\">generateGettingStartedGuide\u003C/span>(),\n                \u003Cspan class=\"hljs-string\">'docs/user-guide/configuration.md'\u003C/span>: \u003Cspan class=\"hljs-variable language_\">this\u003C/span>.\u003Cspan class=\"hljs-title function_\">generateConfigurationGuide\u003C/span>(),\n                \u003Cspan class=\"hljs-string\">'docs/api/overview.md'\u003C/span>: \u003Cspan class=\"hljs-variable language_\">this\u003C/span>.\u003Cspan class=\"hljs-title function_\">generateApiOverview\u003C/span>()\n            },\n            \n            \u003Cspan class=\"hljs-attr\">docusaurus\u003C/span>: {\n                \u003Cspan class=\"hljs-string\">'docs/tutorial-basics/create-a-page.md'\u003C/span>: \u003Cspan class=\"hljs-variable language_\">this\u003C/span>.\u003Cspan class=\"hljs-title function_\">generateDocusaurusGuide\u003C/span>(),\n                \u003Cspan class=\"hljs-string\">'blog/2025-01-01-welcome.md'\u003C/span>: \u003Cspan class=\"hljs-variable language_\">this\u003C/span>.\u003Cspan class=\"hljs-title function_\">generateSamplePost\u003C/span>(\u003Cspan class=\"hljs-string\">'Docusaurus'\u003C/span>)\n            }\n        };\n        \n        \u003Cspan class=\"hljs-keyword\">const\u003C/span> files = sampleFiles[generatorType] || {};\n        \n        \u003Cspan class=\"hljs-keyword\">for\u003C/span> (\u003Cspan class=\"hljs-keyword\">const\u003C/span> [filePath, content] \u003Cspan class=\"hljs-keyword\">of\u003C/span> \u003Cspan class=\"hljs-title class_\">Object\u003C/span>.\u003Cspan class=\"hljs-title function_\">entries\u003C/span>(files)) {\n            \u003Cspan class=\"hljs-keyword\">const\u003C/span> fullPath = path.\u003Cspan class=\"hljs-title function_\">join\u003C/span>(\u003Cspan class=\"hljs-variable language_\">this\u003C/span>.\u003Cspan class=\"hljs-property\">projectRoot\u003C/span>, filePath);\n            \u003Cspan class=\"hljs-keyword\">await\u003C/span> fs.\u003Cspan class=\"hljs-title function_\">mkdir\u003C/span>(path.\u003Cspan class=\"hljs-title function_\">dirname\u003C/span>(fullPath), { \u003Cspan class=\"hljs-attr\">recursive\u003C/span>: \u003Cspan class=\"hljs-literal\">true\u003C/span> });\n            \u003Cspan class=\"hljs-keyword\">await\u003C/span> fs.\u003Cspan class=\"hljs-title function_\">writeFile\u003C/span>(fullPath, content);\n        }\n    }\n    \n    \u003Cspan class=\"hljs-title function_\">generateSamplePost\u003C/span>(\u003Cspan class=\"hljs-params\">generator\u003C/span>) {\n        \u003Cspan class=\"hljs-keyword\">return\u003C/span> \u003Cspan class=\"hljs-string\">`---\ntitle: "Welcome to \u003Cspan class=\"hljs-subst\">${generator}\u003C/span>"\ndate: \u003Cspan class=\"hljs-subst\">${\u003Cspan class=\"hljs-keyword\">new\u003C/span> \u003Cspan class=\"hljs-built_in\">Date\u003C/span>().toISOString().split(\u003Cspan class=\"hljs-string\">'T'\u003C/span>)[\u003Cspan class=\"hljs-number\">0\u003C/span>]}\u003C/span>\nauthor: Documentation Team\ncategories: \n  - Getting Started\ntags:\n  - welcome\n  - \u003Cspan class=\"hljs-subst\">${generator.toLowerCase()}\u003C/span>\n---\n\n# Welcome to Your New \u003Cspan class=\"hljs-subst\">${generator}\u003C/span> Documentation Site\n\nThis is your first blog post! \u003Cspan class=\"hljs-subst\">${generator}\u003C/span> makes it easy to create beautiful documentation sites from Markdown files.\n\n## What's Included\n\nThis site includes:\n\n- **Responsive design** that looks great on all devices\n- **Syntax highlighting** for code blocks\n- **Search functionality** to help users find content\n- **SEO optimization** for better search engine visibility\n\n## Getting Started\n\nTo customize your site:\n\n1. Edit the configuration file\n2. Add your content in Markdown format\n3. Customize the theme and styling\n4. Deploy to your hosting platform\n\n## Code Example\n\nHere's a sample code block with syntax highlighting:\n\n\\`\\`\\`javascript\nfunction welcome(name) {\n    console.log(\\`Welcome to \\${name}!\\`);\n    return \\`Hello, \\${name}! Ready to build amazing documentation?\\`;\n}\n\nwelcome('\u003Cspan class=\"hljs-subst\">${generator}\u003C/span>');\n\\`\\`\\`\n\n## Next Steps\n\n- [Read the documentation](../docs/getting-started.md)\n- [Customize your theme](../docs/theming.md)\n- [Deploy your site](../docs/deployment.md)\n\nHappy documenting! 🚀\n`\u003C/span>;\n    }\n    \n    \u003Cspan class=\"hljs-title function_\">generateGettingStartedGuide\u003C/span>(\u003Cspan class=\"hljs-params\">\u003C/span>) {\n        \u003Cspan class=\"hljs-keyword\">return\u003C/span> \u003Cspan class=\"hljs-string\">`---\ntitle: Getting Started\ndescription: Learn how to get started with this documentation site\n---\n\n# Getting Started\n\nWelcome to our documentation! This guide will help you get up and running quickly.\n\n## Installation\n\n### Prerequisites\n\nBefore you begin, ensure you have:\n\n- Node.js (version 14 or higher)\n- Git\n- A text editor or IDE\n\n### Quick Start\n\n1. **Clone the repository**\n   \\`\\`\\`bash\n   git clone https://github.com/example/project.git\n   cd project\n   \\`\\`\\`\n\n2. **Install dependencies**\n   \\`\\`\\`bash\n   npm install\n   \\`\\`\\`\n\n3. **Start the development server**\n   \\`\\`\\`bash\n   npm run serve\n   \\`\\`\\`\n\n4. **Open your browser**\n   Navigate to \\`http://localhost:3000\\`\n\n## Configuration\n\nThe main configuration file controls:\n\n- Site title and description\n- Navigation structure\n- Theme settings\n- Plugin configuration\n\n### Basic Configuration\n\n\\`\\`\\`yaml\ntitle: My Documentation Site\ndescription: Comprehensive documentation for our project\nauthor: Your Name\nemail: your.email@example.com\n\n# Navigation\nnav:\n  - Home: index.md\n  - User Guide: user-guide/\n  - API Reference: api/\n\\`\\`\\`\n\n## Writing Content\n\n### Markdown Basics\n\nThis site uses standard Markdown with some extensions:\n\n- **Tables** for structured data\n- **Code blocks** with syntax highlighting\n- **Admonitions** for notes and warnings\n- **Cross-references** between pages\n\n### Example Content\n\n\\`\\`\\`markdown\n# Page Title\n\nThis is a paragraph with **bold** and *italic* text.\n\n## Code Example\n\n\\`\\`\\`python\ndef hello_world():\n    print("Hello, World!")\n\\`\\`\\`\n\n## Table Example\n\n| Feature | Status |\n|---------|--------|\n| Search  | ✅     |\n| Mobile  | ✅     |\n| Offline | ⏳     |\n\\`\\`\\`\n\n## Next Steps\n\n- [Learn about advanced features](advanced-features.md)\n- [Customize your site](customization.md)\n- [Deploy to production](deployment.md)\n`\u003C/span>;\n    }\n    \n    \u003Cspan class=\"hljs-keyword\">async\u003C/span> \u003Cspan class=\"hljs-title function_\">build\u003C/span>(\u003Cspan class=\"hljs-params\">generatorType, options = {}\u003C/span>) {\n        \u003Cspan class=\"hljs-variable language_\">console\u003C/span>.\u003Cspan class=\"hljs-title function_\">log\u003C/span>(\u003Cspan class=\"hljs-string\">`Building site with \u003Cspan class=\"hljs-subst\">${generatorType}\u003C/span>...`\u003C/span>);\n        \n        \u003Cspan class=\"hljs-keyword\">const\u003C/span> generator = \u003Cspan class=\"hljs-variable language_\">this\u003C/span>.\u003Cspan class=\"hljs-property\">generators\u003C/span>[generatorType];\n        \u003Cspan class=\"hljs-keyword\">if\u003C/span> (!generator) {\n            \u003Cspan class=\"hljs-keyword\">throw\u003C/span> \u003Cspan class=\"hljs-keyword\">new\u003C/span> \u003Cspan class=\"hljs-title class_\">Error\u003C/span>(\u003Cspan class=\"hljs-string\">`Unsupported generator: \u003Cspan class=\"hljs-subst\">${generatorType}\u003C/span>`\u003C/span>);\n        }\n        \n        \u003Cspan class=\"hljs-keyword\">const\u003C/span> buildResult = \u003Cspan class=\"hljs-keyword\">await\u003C/span> generator.\u003Cspan class=\"hljs-title function_\">build\u003C/span>(options);\n        \n        \u003Cspan class=\"hljs-keyword\">if\u003C/span> (options.\u003Cspan class=\"hljs-property\">optimize\u003C/span>) {\n            \u003Cspan class=\"hljs-keyword\">await\u003C/span> \u003Cspan class=\"hljs-variable language_\">this\u003C/span>.\u003Cspan class=\"hljs-title function_\">optimizeBuild\u003C/span>(buildResult);\n        }\n        \n        \u003Cspan class=\"hljs-keyword\">return\u003C/span> buildResult;\n    }\n    \n    \u003Cspan class=\"hljs-keyword\">async\u003C/span> \u003Cspan class=\"hljs-title function_\">optimizeBuild\u003C/span>(\u003Cspan class=\"hljs-params\">buildResult\u003C/span>) {\n        \u003Cspan class=\"hljs-comment\">// Implement build optimization\u003C/span>\n        \u003Cspan class=\"hljs-variable language_\">console\u003C/span>.\u003Cspan class=\"hljs-title function_\">log\u003C/span>(\u003Cspan class=\"hljs-string\">'Optimizing build output...'\u003C/span>);\n        \n        \u003Cspan class=\"hljs-comment\">// Minify CSS and JS\u003C/span>\n        \u003Cspan class=\"hljs-comment\">// Optimize images\u003C/span>\n        \u003Cspan class=\"hljs-comment\">// Generate service worker\u003C/span>\n        \u003Cspan class=\"hljs-comment\">// Create sitemap\u003C/span>\n        \u003Cspan class=\"hljs-comment\">// Validate links\u003C/span>\n    }\n    \n    \u003Cspan class=\"hljs-keyword\">async\u003C/span> \u003Cspan class=\"hljs-title function_\">deploy\u003C/span>(\u003Cspan class=\"hljs-params\">platform, options = {}\u003C/span>) {\n        \u003Cspan class=\"hljs-variable language_\">console\u003C/span>.\u003Cspan class=\"hljs-title function_\">log\u003C/span>(\u003Cspan class=\"hljs-string\">`Deploying to \u003Cspan class=\"hljs-subst\">${platform}\u003C/span>...`\u003C/span>);\n        \n        \u003Cspan class=\"hljs-keyword\">const\u003C/span> deploymentStrategies = {\n            \u003Cspan class=\"hljs-string\">'github-pages'\u003C/span>: \u003Cspan class=\"hljs-keyword\">async\u003C/span> () => {\n                \u003Cspan class=\"hljs-title function_\">execSync\u003C/span>(\u003Cspan class=\"hljs-string\">'git add .'\u003C/span>);\n                \u003Cspan class=\"hljs-title function_\">execSync\u003C/span>(\u003Cspan class=\"hljs-string\">`git commit -m "Deploy site - \u003Cspan class=\"hljs-subst\">${\u003Cspan class=\"hljs-keyword\">new\u003C/span> \u003Cspan class=\"hljs-built_in\">Date\u003C/span>().toISOString()}\u003C/span>"`\u003C/span>);\n                \u003Cspan class=\"hljs-title function_\">execSync\u003C/span>(\u003Cspan class=\"hljs-string\">'git push origin main'\u003C/span>);\n            },\n            \n            \u003Cspan class=\"hljs-string\">'netlify'\u003C/span>: \u003Cspan class=\"hljs-keyword\">async\u003C/span> () => {\n                \u003Cspan class=\"hljs-title function_\">execSync\u003C/span>(\u003Cspan class=\"hljs-string\">'netlify deploy --prod --dir=dist'\u003C/span>);\n            },\n            \n            \u003Cspan class=\"hljs-string\">'vercel'\u003C/span>: \u003Cspan class=\"hljs-keyword\">async\u003C/span> () => {\n                \u003Cspan class=\"hljs-title function_\">execSync\u003C/span>(\u003Cspan class=\"hljs-string\">'vercel --prod'\u003C/span>);\n            },\n            \n            \u003Cspan class=\"hljs-string\">'s3'\u003C/span>: \u003Cspan class=\"hljs-keyword\">async\u003C/span> () => {\n                \u003Cspan class=\"hljs-title function_\">execSync\u003C/span>(\u003Cspan class=\"hljs-string\">`aws s3 sync dist/ s3://\u003Cspan class=\"hljs-subst\">${options.bucket}\u003C/span> --delete`\u003C/span>);\n            }\n        };\n        \n        \u003Cspan class=\"hljs-keyword\">const\u003C/span> strategy = deploymentStrategies[platform];\n        \u003Cspan class=\"hljs-keyword\">if\u003C/span> (!strategy) {\n            \u003Cspan class=\"hljs-keyword\">throw\u003C/span> \u003Cspan class=\"hljs-keyword\">new\u003C/span> \u003Cspan class=\"hljs-title class_\">Error\u003C/span>(\u003Cspan class=\"hljs-string\">`Unsupported deployment platform: \u003Cspan class=\"hljs-subst\">${platform}\u003C/span>`\u003C/span>);\n        }\n        \n        \u003Cspan class=\"hljs-keyword\">await\u003C/span> \u003Cspan class=\"hljs-title function_\">strategy\u003C/span>();\n        \u003Cspan class=\"hljs-variable language_\">console\u003C/span>.\u003Cspan class=\"hljs-title function_\">log\u003C/span>(\u003Cspan class=\"hljs-string\">`Successfully deployed to \u003Cspan class=\"hljs-subst\">${platform}\u003C/span>`\u003C/span>);\n    }\n}\n\n\u003Cspan class=\"hljs-comment\">// Generator-specific implementations\u003C/span>\n\u003Cspan class=\"hljs-keyword\">class\u003C/span> \u003Cspan class=\"hljs-title class_\">JekyllGenerator\u003C/span> {\n    \u003Cspan class=\"hljs-title function_\">constructor\u003C/span>(\u003Cspan class=\"hljs-params\">manager\u003C/span>) {\n        \u003Cspan class=\"hljs-variable language_\">this\u003C/span>.\u003Cspan class=\"hljs-property\">manager\u003C/span> = manager;\n        \u003Cspan class=\"hljs-variable language_\">this\u003C/span>.\u003Cspan class=\"hljs-property\">name\u003C/span> = \u003Cspan class=\"hljs-string\">'Jekyll'\u003C/span>;\n    }\n    \n    \u003Cspan class=\"hljs-keyword\">async\u003C/span> \u003Cspan class=\"hljs-title function_\">initialize\u003C/span>(\u003Cspan class=\"hljs-params\">config\u003C/span>) {\n        \u003Cspan class=\"hljs-variable language_\">console\u003C/span>.\u003Cspan class=\"hljs-title function_\">log\u003C/span>(\u003Cspan class=\"hljs-string\">'Setting up Jekyll environment...'\u003C/span>);\n        \n        \u003Cspan class=\"hljs-comment\">// Install Ruby dependencies\u003C/span>\n        \u003Cspan class=\"hljs-keyword\">try\u003C/span> {\n            \u003Cspan class=\"hljs-title function_\">execSync\u003C/span>(\u003Cspan class=\"hljs-string\">'bundle install'\u003C/span>, { \u003Cspan class=\"hljs-attr\">cwd\u003C/span>: \u003Cspan class=\"hljs-variable language_\">this\u003C/span>.\u003Cspan class=\"hljs-property\">manager\u003C/span>.\u003Cspan class=\"hljs-property\">projectRoot\u003C/span>, \u003Cspan class=\"hljs-attr\">stdio\u003C/span>: \u003Cspan class=\"hljs-string\">'inherit'\u003C/span> });\n        } \u003Cspan class=\"hljs-keyword\">catch\u003C/span> (error) {\n            \u003Cspan class=\"hljs-variable language_\">console\u003C/span>.\u003Cspan class=\"hljs-title function_\">warn\u003C/span>(\u003Cspan class=\"hljs-string\">'Bundle install failed. Make sure Ruby and Bundler are installed.'\u003C/span>);\n        }\n    }\n    \n    \u003Cspan class=\"hljs-keyword\">async\u003C/span> \u003Cspan class=\"hljs-title function_\">installTheme\u003C/span>(\u003Cspan class=\"hljs-params\">themeName\u003C/span>) {\n        \u003Cspan class=\"hljs-variable language_\">console\u003C/span>.\u003Cspan class=\"hljs-title function_\">log\u003C/span>(\u003Cspan class=\"hljs-string\">`Installing Jekyll theme: \u003Cspan class=\"hljs-subst\">${themeName}\u003C/span>`\u003C/span>);\n        \n        \u003Cspan class=\"hljs-comment\">// Add theme to Gemfile\u003C/span>\n        \u003Cspan class=\"hljs-keyword\">const\u003C/span> gemfilePath = path.\u003Cspan class=\"hljs-title function_\">join\u003C/span>(\u003Cspan class=\"hljs-variable language_\">this\u003C/span>.\u003Cspan class=\"hljs-property\">manager\u003C/span>.\u003Cspan class=\"hljs-property\">projectRoot\u003C/span>, \u003Cspan class=\"hljs-string\">'Gemfile'\u003C/span>);\n        \u003Cspan class=\"hljs-keyword\">const\u003C/span> gemfileContent = \u003Cspan class=\"hljs-keyword\">await\u003C/span> fs.\u003Cspan class=\"hljs-title function_\">readFile\u003C/span>(gemfilePath, \u003Cspan class=\"hljs-string\">'utf8'\u003C/span>);\n        \u003Cspan class=\"hljs-keyword\">const\u003C/span> updatedGemfile = gemfileContent + \u003Cspan class=\"hljs-string\">`\\ngem "\u003Cspan class=\"hljs-subst\">${themeName}\u003C/span>"`\u003C/span>;\n        \u003Cspan class=\"hljs-keyword\">await\u003C/span> fs.\u003Cspan class=\"hljs-title function_\">writeFile\u003C/span>(gemfilePath, updatedGemfile);\n        \n        \u003Cspan class=\"hljs-comment\">// Install theme\u003C/span>\n        \u003Cspan class=\"hljs-title function_\">execSync\u003C/span>(\u003Cspan class=\"hljs-string\">'bundle install'\u003C/span>, { \u003Cspan class=\"hljs-attr\">cwd\u003C/span>: \u003Cspan class=\"hljs-variable language_\">this\u003C/span>.\u003Cspan class=\"hljs-property\">manager\u003C/span>.\u003Cspan class=\"hljs-property\">projectRoot\u003C/span> });\n    }\n    \n    \u003Cspan class=\"hljs-keyword\">async\u003C/span> \u003Cspan class=\"hljs-title function_\">installPlugins\u003C/span>(\u003Cspan class=\"hljs-params\">plugins\u003C/span>) {\n        \u003Cspan class=\"hljs-variable language_\">console\u003C/span>.\u003Cspan class=\"hljs-title function_\">log\u003C/span>(\u003Cspan class=\"hljs-string\">`Installing Jekyll plugins: \u003Cspan class=\"hljs-subst\">${plugins.join(\u003Cspan class=\"hljs-string\">', '\u003C/span>)}\u003C/span>`\u003C/span>);\n        \n        \u003Cspan class=\"hljs-keyword\">const\u003C/span> configPath = path.\u003Cspan class=\"hljs-title function_\">join\u003C/span>(\u003Cspan class=\"hljs-variable language_\">this\u003C/span>.\u003Cspan class=\"hljs-property\">manager\u003C/span>.\u003Cspan class=\"hljs-property\">projectRoot\u003C/span>, \u003Cspan class=\"hljs-string\">'_config.yml'\u003C/span>);\n        \u003Cspan class=\"hljs-keyword\">const\u003C/span> config = yaml.\u003Cspan class=\"hljs-title function_\">load\u003C/span>(\u003Cspan class=\"hljs-keyword\">await\u003C/span> fs.\u003Cspan class=\"hljs-title function_\">readFile\u003C/span>(configPath, \u003Cspan class=\"hljs-string\">'utf8'\u003C/span>));\n        config.\u003Cspan class=\"hljs-property\">plugins\u003C/span> = [...(config.\u003Cspan class=\"hljs-property\">plugins\u003C/span> || []), ...plugins];\n        \u003Cspan class=\"hljs-keyword\">await\u003C/span> fs.\u003Cspan class=\"hljs-title function_\">writeFile\u003C/span>(configPath, yaml.\u003Cspan class=\"hljs-title function_\">dump\u003C/span>(config));\n    }\n    \n    \u003Cspan class=\"hljs-keyword\">async\u003C/span> \u003Cspan class=\"hljs-title function_\">build\u003C/span>(\u003Cspan class=\"hljs-params\">options = {}\u003C/span>) {\n        \u003Cspan class=\"hljs-variable language_\">console\u003C/span>.\u003Cspan class=\"hljs-title function_\">log\u003C/span>(\u003Cspan class=\"hljs-string\">'Building Jekyll site...'\u003C/span>);\n        \n        \u003Cspan class=\"hljs-keyword\">const\u003C/span> buildCommand = options.\u003Cspan class=\"hljs-property\">production\u003C/span> \n            ? \u003Cspan class=\"hljs-string\">'bundle exec jekyll build --config _config.yml,_config_prod.yml'\u003C/span>\n            : \u003Cspan class=\"hljs-string\">'bundle exec jekyll build'\u003C/span>;\n            \n        \u003Cspan class=\"hljs-title function_\">execSync\u003C/span>(buildCommand, { \n            \u003Cspan class=\"hljs-attr\">cwd\u003C/span>: \u003Cspan class=\"hljs-variable language_\">this\u003C/span>.\u003Cspan class=\"hljs-property\">manager\u003C/span>.\u003Cspan class=\"hljs-property\">projectRoot\u003C/span>, \n            \u003Cspan class=\"hljs-attr\">stdio\u003C/span>: \u003Cspan class=\"hljs-string\">'inherit'\u003C/span> \n        });\n        \n        \u003Cspan class=\"hljs-keyword\">return\u003C/span> {\n            \u003Cspan class=\"hljs-attr\">outputDir\u003C/span>: path.\u003Cspan class=\"hljs-title function_\">join\u003C/span>(\u003Cspan class=\"hljs-variable language_\">this\u003C/span>.\u003Cspan class=\"hljs-property\">manager\u003C/span>.\u003Cspan class=\"hljs-property\">projectRoot\u003C/span>, \u003Cspan class=\"hljs-string\">'_site'\u003C/span>),\n            \u003Cspan class=\"hljs-attr\">generator\u003C/span>: \u003Cspan class=\"hljs-string\">'Jekyll'\u003C/span>,\n            \u003Cspan class=\"hljs-attr\">buildTime\u003C/span>: \u003Cspan class=\"hljs-keyword\">new\u003C/span> \u003Cspan class=\"hljs-title class_\">Date\u003C/span>().\u003Cspan class=\"hljs-title function_\">toISOString\u003C/span>()\n        };\n    }\n}\n\n\u003Cspan class=\"hljs-keyword\">class\u003C/span> \u003Cspan class=\"hljs-title class_\">HugoGenerator\u003C/span> {\n    \u003Cspan class=\"hljs-title function_\">constructor\u003C/span>(\u003Cspan class=\"hljs-params\">manager\u003C/span>) {\n        \u003Cspan class=\"hljs-variable language_\">this\u003C/span>.\u003Cspan class=\"hljs-property\">manager\u003C/span> = manager;\n        \u003Cspan class=\"hljs-variable language_\">this\u003C/span>.\u003Cspan class=\"hljs-property\">name\u003C/span> = \u003Cspan class=\"hljs-string\">'Hugo'\u003C/span>;\n    }\n    \n    \u003Cspan class=\"hljs-keyword\">async\u003C/span> \u003Cspan class=\"hljs-title function_\">initialize\u003C/span>(\u003Cspan class=\"hljs-params\">config\u003C/span>) {\n        \u003Cspan class=\"hljs-variable language_\">console\u003C/span>.\u003Cspan class=\"hljs-title function_\">log\u003C/span>(\u003Cspan class=\"hljs-string\">'Setting up Hugo environment...'\u003C/span>);\n        \u003Cspan class=\"hljs-comment\">// Hugo doesn't require additional setup\u003C/span>\n    }\n    \n    \u003Cspan class=\"hljs-keyword\">async\u003C/span> \u003Cspan class=\"hljs-title function_\">installTheme\u003C/span>(\u003Cspan class=\"hljs-params\">themeName\u003C/span>) {\n        \u003Cspan class=\"hljs-variable language_\">console\u003C/span>.\u003Cspan class=\"hljs-title function_\">log\u003C/span>(\u003Cspan class=\"hljs-string\">`Installing Hugo theme: \u003Cspan class=\"hljs-subst\">${themeName}\u003C/span>`\u003C/span>);\n        \n        \u003Cspan class=\"hljs-keyword\">const\u003C/span> themeDir = path.\u003Cspan class=\"hljs-title function_\">join\u003C/span>(\u003Cspan class=\"hljs-variable language_\">this\u003C/span>.\u003Cspan class=\"hljs-property\">manager\u003C/span>.\u003Cspan class=\"hljs-property\">projectRoot\u003C/span>, \u003Cspan class=\"hljs-string\">'themes'\u003C/span>, themeName);\n        \u003Cspan class=\"hljs-title function_\">execSync\u003C/span>(\u003Cspan class=\"hljs-string\">`git submodule add https://github.com/thegeeklab/\u003Cspan class=\"hljs-subst\">${themeName}\u003C/span> \u003Cspan class=\"hljs-subst\">${themeDir}\u003C/span>`\u003C/span>, {\n            \u003Cspan class=\"hljs-attr\">cwd\u003C/span>: \u003Cspan class=\"hljs-variable language_\">this\u003C/span>.\u003Cspan class=\"hljs-property\">manager\u003C/span>.\u003Cspan class=\"hljs-property\">projectRoot\u003C/span>\n        });\n    }\n    \n    \u003Cspan class=\"hljs-keyword\">async\u003C/span> \u003Cspan class=\"hljs-title function_\">installPlugins\u003C/span>(\u003Cspan class=\"hljs-params\">plugins\u003C/span>) {\n        \u003Cspan class=\"hljs-variable language_\">console\u003C/span>.\u003Cspan class=\"hljs-title function_\">log\u003C/span>(\u003Cspan class=\"hljs-string\">'Hugo plugins are typically built-in or theme-based'\u003C/span>);\n        \u003Cspan class=\"hljs-comment\">// Hugo plugins are usually built-in or part of themes\u003C/span>\n    }\n    \n    \u003Cspan class=\"hljs-keyword\">async\u003C/span> \u003Cspan class=\"hljs-title function_\">build\u003C/span>(\u003Cspan class=\"hljs-params\">options = {}\u003C/span>) {\n        \u003Cspan class=\"hljs-variable language_\">console\u003C/span>.\u003Cspan class=\"hljs-title function_\">log\u003C/span>(\u003Cspan class=\"hljs-string\">'Building Hugo site...'\u003C/span>);\n        \n        \u003Cspan class=\"hljs-keyword\">const\u003C/span> buildCommand = options.\u003Cspan class=\"hljs-property\">production\u003C/span> \n            ? \u003Cspan class=\"hljs-string\">'hugo --minify --gc'\u003C/span>\n            : \u003Cspan class=\"hljs-string\">'hugo --buildDrafts --buildFuture'\u003C/span>;\n            \n        \u003Cspan class=\"hljs-title function_\">execSync\u003C/span>(buildCommand, { \n            \u003Cspan class=\"hljs-attr\">cwd\u003C/span>: \u003Cspan class=\"hljs-variable language_\">this\u003C/span>.\u003Cspan class=\"hljs-property\">manager\u003C/span>.\u003Cspan class=\"hljs-property\">projectRoot\u003C/span>, \n            \u003Cspan class=\"hljs-attr\">stdio\u003C/span>: \u003Cspan class=\"hljs-string\">'inherit'\u003C/span> \n        });\n        \n        \u003Cspan class=\"hljs-keyword\">return\u003C/span> {\n            \u003Cspan class=\"hljs-attr\">outputDir\u003C/span>: path.\u003Cspan class=\"hljs-title function_\">join\u003C/span>(\u003Cspan class=\"hljs-variable language_\">this\u003C/span>.\u003Cspan class=\"hljs-property\">manager\u003C/span>.\u003Cspan class=\"hljs-property\">projectRoot\u003C/span>, \u003Cspan class=\"hljs-string\">'public'\u003C/span>),\n            \u003Cspan class=\"hljs-attr\">generator\u003C/span>: \u003Cspan class=\"hljs-string\">'Hugo'\u003C/span>,\n            \u003Cspan class=\"hljs-attr\">buildTime\u003C/span>: \u003Cspan class=\"hljs-keyword\">new\u003C/span> \u003Cspan class=\"hljs-title class_\">Date\u003C/span>().\u003Cspan class=\"hljs-title function_\">toISOString\u003C/span>()\n        };\n    }\n}\n\n\u003Cspan class=\"hljs-keyword\">class\u003C/span> \u003Cspan class=\"hljs-title class_\">MkDocsGenerator\u003C/span> {\n    \u003Cspan class=\"hljs-title function_\">constructor\u003C/span>(\u003Cspan class=\"hljs-params\">manager\u003C/span>) {\n        \u003Cspan class=\"hljs-variable language_\">this\u003C/span>.\u003Cspan class=\"hljs-property\">manager\u003C/span> = manager;\n        \u003Cspan class=\"hljs-variable language_\">this\u003C/span>.\u003Cspan class=\"hljs-property\">name\u003C/span> = \u003Cspan class=\"hljs-string\">'MkDocs'\u003C/span>;\n    }\n    \n    \u003Cspan class=\"hljs-keyword\">async\u003C/span> \u003Cspan class=\"hljs-title function_\">initialize\u003C/span>(\u003Cspan class=\"hljs-params\">config\u003C/span>) {\n        \u003Cspan class=\"hljs-variable language_\">console\u003C/span>.\u003Cspan class=\"hljs-title function_\">log\u003C/span>(\u003Cspan class=\"hljs-string\">'Setting up MkDocs environment...'\u003C/span>);\n        \n        \u003Cspan class=\"hljs-comment\">// Install Python dependencies\u003C/span>\n        \u003Cspan class=\"hljs-keyword\">try\u003C/span> {\n            \u003Cspan class=\"hljs-title function_\">execSync\u003C/span>(\u003Cspan class=\"hljs-string\">'pip install -r requirements.txt'\u003C/span>, { \n                \u003Cspan class=\"hljs-attr\">cwd\u003C/span>: \u003Cspan class=\"hljs-variable language_\">this\u003C/span>.\u003Cspan class=\"hljs-property\">manager\u003C/span>.\u003Cspan class=\"hljs-property\">projectRoot\u003C/span>, \n                \u003Cspan class=\"hljs-attr\">stdio\u003C/span>: \u003Cspan class=\"hljs-string\">'inherit'\u003C/span> \n            });\n        } \u003Cspan class=\"hljs-keyword\">catch\u003C/span> (error) {\n            \u003Cspan class=\"hljs-variable language_\">console\u003C/span>.\u003Cspan class=\"hljs-title function_\">warn\u003C/span>(\u003Cspan class=\"hljs-string\">'Pip install failed. Make sure Python and pip are installed.'\u003C/span>);\n        }\n    }\n    \n    \u003Cspan class=\"hljs-keyword\">async\u003C/span> \u003Cspan class=\"hljs-title function_\">installTheme\u003C/span>(\u003Cspan class=\"hljs-params\">themeName\u003C/span>) {\n        \u003Cspan class=\"hljs-variable language_\">console\u003C/span>.\u003Cspan class=\"hljs-title function_\">log\u003C/span>(\u003Cspan class=\"hljs-string\">`MkDocs theme \u003Cspan class=\"hljs-subst\">${themeName}\u003C/span> should be specified in mkdocs.yml`\u003C/span>);\n    }\n    \n    \u003Cspan class=\"hljs-keyword\">async\u003C/span> \u003Cspan class=\"hljs-title function_\">installPlugins\u003C/span>(\u003Cspan class=\"hljs-params\">plugins\u003C/span>) {\n        \u003Cspan class=\"hljs-variable language_\">console\u003C/span>.\u003Cspan class=\"hljs-title function_\">log\u003C/span>(\u003Cspan class=\"hljs-string\">'MkDocs plugins should be specified in mkdocs.yml and requirements.txt'\u003C/span>);\n    }\n    \n    \u003Cspan class=\"hljs-keyword\">async\u003C/span> \u003Cspan class=\"hljs-title function_\">build\u003C/span>(\u003Cspan class=\"hljs-params\">options = {}\u003C/span>) {\n        \u003Cspan class=\"hljs-variable language_\">console\u003C/span>.\u003Cspan class=\"hljs-title function_\">log\u003C/span>(\u003Cspan class=\"hljs-string\">'Building MkDocs site...'\u003C/span>);\n        \n        \u003Cspan class=\"hljs-keyword\">const\u003C/span> buildCommand = \u003Cspan class=\"hljs-string\">'mkdocs build'\u003C/span>;\n        \u003Cspan class=\"hljs-title function_\">execSync\u003C/span>(buildCommand, { \n            \u003Cspan class=\"hljs-attr\">cwd\u003C/span>: \u003Cspan class=\"hljs-variable language_\">this\u003C/span>.\u003Cspan class=\"hljs-property\">manager\u003C/span>.\u003Cspan class=\"hljs-property\">projectRoot\u003C/span>, \n            \u003Cspan class=\"hljs-attr\">stdio\u003C/span>: \u003Cspan class=\"hljs-string\">'inherit'\u003C/span> \n        });\n        \n        \u003Cspan class=\"hljs-keyword\">return\u003C/span> {\n            \u003Cspan class=\"hljs-attr\">outputDir\u003C/span>: path.\u003Cspan class=\"hljs-title function_\">join\u003C/span>(\u003Cspan class=\"hljs-variable language_\">this\u003C/span>.\u003Cspan class=\"hljs-property\">manager\u003C/span>.\u003Cspan class=\"hljs-property\">projectRoot\u003C/span>, \u003Cspan class=\"hljs-string\">'site'\u003C/span>),\n            \u003Cspan class=\"hljs-attr\">generator\u003C/span>: \u003Cspan class=\"hljs-string\">'MkDocs'\u003C/span>,\n            \u003Cspan class=\"hljs-attr\">buildTime\u003C/span>: \u003Cspan class=\"hljs-keyword\">new\u003C/span> \u003Cspan class=\"hljs-title class_\">Date\u003C/span>().\u003Cspan class=\"hljs-title function_\">toISOString\u003C/span>()\n        };\n    }\n}\n\n\u003Cspan class=\"hljs-keyword\">class\u003C/span> \u003Cspan class=\"hljs-title class_\">DocusaurusGenerator\u003C/span> {\n    \u003Cspan class=\"hljs-title function_\">constructor\u003C/span>(\u003Cspan class=\"hljs-params\">manager\u003C/span>) {\n        \u003Cspan class=\"hljs-variable language_\">this\u003C/span>.\u003Cspan class=\"hljs-property\">manager\u003C/span> = manager;\n        \u003Cspan class=\"hljs-variable language_\">this\u003C/span>.\u003Cspan class=\"hljs-property\">name\u003C/span> = \u003Cspan class=\"hljs-string\">'Docusaurus'\u003C/span>;\n    }\n    \n    \u003Cspan class=\"hljs-keyword\">async\u003C/span> \u003Cspan class=\"hljs-title function_\">initialize\u003C/span>(\u003Cspan class=\"hljs-params\">config\u003C/span>) {\n        \u003Cspan class=\"hljs-variable language_\">console\u003C/span>.\u003Cspan class=\"hljs-title function_\">log\u003C/span>(\u003Cspan class=\"hljs-string\">'Setting up Docusaurus environment...'\u003C/span>);\n        \n        \u003Cspan class=\"hljs-comment\">// Install Node.js dependencies\u003C/span>\n        \u003Cspan class=\"hljs-keyword\">try\u003C/span> {\n            \u003Cspan class=\"hljs-title function_\">execSync\u003C/span>(\u003Cspan class=\"hljs-string\">'npm install'\u003C/span>, { \n                \u003Cspan class=\"hljs-attr\">cwd\u003C/span>: \u003Cspan class=\"hljs-variable language_\">this\u003C/span>.\u003Cspan class=\"hljs-property\">manager\u003C/span>.\u003Cspan class=\"hljs-property\">projectRoot\u003C/span>, \n                \u003Cspan class=\"hljs-attr\">stdio\u003C/span>: \u003Cspan class=\"hljs-string\">'inherit'\u003C/span> \n            });\n        } \u003Cspan class=\"hljs-keyword\">catch\u003C/span> (error) {\n            \u003Cspan class=\"hljs-variable language_\">console\u003C/span>.\u003Cspan class=\"hljs-title function_\">warn\u003C/span>(\u003Cspan class=\"hljs-string\">'npm install failed. Make sure Node.js and npm are installed.'\u003C/span>);\n        }\n    }\n    \n    \u003Cspan class=\"hljs-keyword\">async\u003C/span> \u003Cspan class=\"hljs-title function_\">installTheme\u003C/span>(\u003Cspan class=\"hljs-params\">themeName\u003C/span>) {\n        \u003Cspan class=\"hljs-variable language_\">console\u003C/span>.\u003Cspan class=\"hljs-title function_\">log\u003C/span>(\u003Cspan class=\"hljs-string\">`Installing Docusaurus theme: \u003Cspan class=\"hljs-subst\">${themeName}\u003C/span>`\u003C/span>);\n        \u003Cspan class=\"hljs-title function_\">execSync\u003C/span>(\u003Cspan class=\"hljs-string\">`npm install \u003Cspan class=\"hljs-subst\">${themeName}\u003C/span>`\u003C/span>, { \u003Cspan class=\"hljs-attr\">cwd\u003C/span>: \u003Cspan class=\"hljs-variable language_\">this\u003C/span>.\u003Cspan class=\"hljs-property\">manager\u003C/span>.\u003Cspan class=\"hljs-property\">projectRoot\u003C/span> });\n    }\n    \n    \u003Cspan class=\"hljs-keyword\">async\u003C/span> \u003Cspan class=\"hljs-title function_\">installPlugins\u003C/span>(\u003Cspan class=\"hljs-params\">plugins\u003C/span>) {\n        \u003Cspan class=\"hljs-variable language_\">console\u003C/span>.\u003Cspan class=\"hljs-title function_\">log\u003C/span>(\u003Cspan class=\"hljs-string\">`Installing Docusaurus plugins: \u003Cspan class=\"hljs-subst\">${plugins.join(\u003Cspan class=\"hljs-string\">', '\u003C/span>)}\u003C/span>`\u003C/span>);\n        \u003Cspan class=\"hljs-keyword\">const\u003C/span> pluginPackages = plugins.\u003Cspan class=\"hljs-title function_\">map\u003C/span>(\u003Cspan class=\"hljs-function\">\u003Cspan class=\"hljs-params\">p\u003C/span> =>\u003C/span> \u003Cspan class=\"hljs-string\">`@docusaurus/plugin-\u003Cspan class=\"hljs-subst\">${p}\u003C/span>`\u003C/span>).\u003Cspan class=\"hljs-title function_\">join\u003C/span>(\u003Cspan class=\"hljs-string\">' '\u003C/span>);\n        \u003Cspan class=\"hljs-title function_\">execSync\u003C/span>(\u003Cspan class=\"hljs-string\">`npm install \u003Cspan class=\"hljs-subst\">${pluginPackages}\u003C/span>`\u003C/span>, { \u003Cspan class=\"hljs-attr\">cwd\u003C/span>: \u003Cspan class=\"hljs-variable language_\">this\u003C/span>.\u003Cspan class=\"hljs-property\">manager\u003C/span>.\u003Cspan class=\"hljs-property\">projectRoot\u003C/span> });\n    }\n    \n    \u003Cspan class=\"hljs-keyword\">async\u003C/span> \u003Cspan class=\"hljs-title function_\">build\u003C/span>(\u003Cspan class=\"hljs-params\">options = {}\u003C/span>) {\n        \u003Cspan class=\"hljs-variable language_\">console\u003C/span>.\u003Cspan class=\"hljs-title function_\">log\u003C/span>(\u003Cspan class=\"hljs-string\">'Building Docusaurus site...'\u003C/span>);\n        \n        \u003Cspan class=\"hljs-keyword\">const\u003C/span> buildCommand = \u003Cspan class=\"hljs-string\">'npm run build'\u003C/span>;\n        \u003Cspan class=\"hljs-title function_\">execSync\u003C/span>(buildCommand, { \n            \u003Cspan class=\"hljs-attr\">cwd\u003C/span>: \u003Cspan class=\"hljs-variable language_\">this\u003C/span>.\u003Cspan class=\"hljs-property\">manager\u003C/span>.\u003Cspan class=\"hljs-property\">projectRoot\u003C/span>, \n            \u003Cspan class=\"hljs-attr\">stdio\u003C/span>: \u003Cspan class=\"hljs-string\">'inherit'\u003C/span> \n        });\n        \n        \u003Cspan class=\"hljs-keyword\">return\u003C/span> {\n            \u003Cspan class=\"hljs-attr\">outputDir\u003C/span>: path.\u003Cspan class=\"hljs-title function_\">join\u003C/span>(\u003Cspan class=\"hljs-variable language_\">this\u003C/span>.\u003Cspan class=\"hljs-property\">manager\u003C/span>.\u003Cspan class=\"hljs-property\">projectRoot\u003C/span>, \u003Cspan class=\"hljs-string\">'build'\u003C/span>),\n            \u003Cspan class=\"hljs-attr\">generator\u003C/span>: \u003Cspan class=\"hljs-string\">'Docusaurus'\u003C/span>,\n            \u003Cspan class=\"hljs-attr\">buildTime\u003C/span>: \u003Cspan class=\"hljs-keyword\">new\u003C/span> \u003Cspan class=\"hljs-title class_\">Date\u003C/span>().\u003Cspan class=\"hljs-title function_\">toISOString\u003C/span>()\n        };\n    }\n}\n\n\u003Cspan class=\"hljs-variable language_\">module\u003C/span>.\u003Cspan class=\"hljs-property\">exports\u003C/span> = \u003Cspan class=\"hljs-title class_\">DocumentationSiteManager\u003C/span>;\n\n\u003Cspan class=\"hljs-comment\">// CLI interface\u003C/span>\n\u003Cspan class=\"hljs-keyword\">if\u003C/span> (\u003Cspan class=\"hljs-built_in\">require\u003C/span>.\u003Cspan class=\"hljs-property\">main\u003C/span> === \u003Cspan class=\"hljs-variable language_\">module\u003C/span>) {\n    \u003Cspan class=\"hljs-keyword\">const\u003C/span> manager = \u003Cspan class=\"hljs-keyword\">new\u003C/span> \u003Cspan class=\"hljs-title class_\">DocumentationSiteManager\u003C/span>();\n    \u003Cspan class=\"hljs-keyword\">const\u003C/span> command = process.\u003Cspan class=\"hljs-property\">argv\u003C/span>[\u003Cspan class=\"hljs-number\">2\u003C/span>];\n    \u003Cspan class=\"hljs-keyword\">const\u003C/span> generator = process.\u003Cspan class=\"hljs-property\">argv\u003C/span>[\u003Cspan class=\"hljs-number\">3\u003C/span>];\n    \n    \u003Cspan class=\"hljs-keyword\">switch\u003C/span> (command) {\n        \u003Cspan class=\"hljs-keyword\">case\u003C/span> \u003Cspan class=\"hljs-string\">'init'\u003C/span>:\n            manager.\u003Cspan class=\"hljs-title function_\">initializeProject\u003C/span>(generator, {\n                \u003Cspan class=\"hljs-attr\">title\u003C/span>: \u003Cspan class=\"hljs-string\">'My Documentation Site'\u003C/span>,\n                \u003Cspan class=\"hljs-attr\">description\u003C/span>: \u003Cspan class=\"hljs-string\">'Comprehensive documentation site'\u003C/span>\n            });\n            \u003Cspan class=\"hljs-keyword\">break\u003C/span>;\n        \u003Cspan class=\"hljs-keyword\">case\u003C/span> \u003Cspan class=\"hljs-string\">'build'\u003C/span>:\n            manager.\u003Cspan class=\"hljs-title function_\">build\u003C/span>(generator);\n            \u003Cspan class=\"hljs-keyword\">break\u003C/span>;\n        \u003Cspan class=\"hljs-keyword\">case\u003C/span> \u003Cspan class=\"hljs-string\">'deploy'\u003C/span>:\n            \u003Cspan class=\"hljs-keyword\">const\u003C/span> platform = process.\u003Cspan class=\"hljs-property\">argv\u003C/span>[\u003Cspan class=\"hljs-number\">4\u003C/span>];\n            manager.\u003Cspan class=\"hljs-title function_\">deploy\u003C/span>(platform);\n            \u003Cspan class=\"hljs-keyword\">break\u003C/span>;\n        \u003Cspan class=\"hljs-attr\">default\u003C/span>:\n            \u003Cspan class=\"hljs-variable language_\">console\u003C/span>.\u003Cspan class=\"hljs-title function_\">log\u003C/span>(\u003Cspan class=\"hljs-string\">'Available commands: init <generator>, build <generator>, deploy <platform>'\u003C/span>);\n            \u003Cspan class=\"hljs-variable language_\">console\u003C/span>.\u003Cspan class=\"hljs-title function_\">log\u003C/span>(\u003Cspan class=\"hljs-string\">'Available generators: jekyll, hugo, mkdocs, docusaurus'\u003C/span>);\n            \u003Cspan class=\"hljs-variable language_\">console\u003C/span>.\u003Cspan class=\"hljs-title function_\">log\u003C/span>(\u003Cspan class=\"hljs-string\">'Available platforms: github-pages, netlify, vercel, s3'\u003C/span>);\n    }\n}\n\u003C/code>\u003C/pre>\u003Ch2 id=\"advanced-theme-customization\">Advanced Theme Customization\u003C/h2>\n\u003Ch3 id=\"jekyll-theme-development\">Jekyll Theme Development\u003C/h3>\n\u003Cp>Creating custom Jekyll themes with advanced functionality:\u003C/p>\n\u003Cpre>\u003Ccode class=\"hljs language-liquid\"><!-- _layouts/documentation.html - Advanced Jekyll layout -->\n<!DOCTYPE html>\n<html lang="{{ page.lang | default: site.lang | default: 'en' }}">\n\n{%- include head.html -%}\n\n<body class="documentation-layout">\n  \n  {%- include header.html -%}\n\n  <!-- Main content area with sidebar -->\n  <main class="documentation-main" id="main-content">\n    \n    <!-- Sidebar navigation -->\n    <aside class="documentation-sidebar">\n      <nav class="sidebar-nav" aria-label="Documentation navigation">\n        \n        <!-- Search -->\n        <div class="sidebar-search">\n          <input type="search" id="docs-search" placeholder="Search documentation..." \n                 aria-label="Search documentation">\n          <div id="search-results" class="search-results hidden" aria-live="polite"></div>\n        </div>\n        \n        <!-- Navigation tree -->\n        <div class="sidebar-tree">\n          {% assign docs_pages = site.docs | sort: 'order' %}\n          {% assign grouped_pages = docs_pages | group_by: 'category' %}\n          \n          {% for group in grouped_pages %}\n            <div class="nav-section">\n              <h3 class="nav-section-title">{{ group.name | default: 'General' }}</h3>\n              <ul class="nav-list">\n                {% for doc in group.items %}\n                  <li class="nav-item{% if page.url == doc.url %} nav-item-active{% endif %}">\n                    <a href="{{ doc.url | relative_url }}" \n                       class="nav-link"\n                       {% if page.url == doc.url %}aria-current="page"{% endif %}>\n                      {{ doc.title | default: doc.name }}\n                    </a>\n                    \n                    <!-- Show subsections if this is the current page -->\n                    {% if page.url == doc.url and doc.toc %}\n                      <ul class="nav-subsections">\n                        {% for toc_item in doc.toc %}\n                          <li class="nav-subitem">\n                            <a href="#{{ toc_item.anchor }}" class="nav-sublink">\n                              {{ toc_item.title }}\n                            </a>\n                          </li>\n                        {% endfor %}\n                      </ul>\n                    {% endif %}\n                  </li>\n                {% endfor %}\n              </ul>\n            </div>\n          {% endfor %}\n        </div>\n        \n      </nav>\n    </aside>\n    \n    <!-- Content area -->\n    <div class="documentation-content">\n      \n      <!-- Breadcrumb navigation -->\n      {% if page.breadcrumbs %}\n        <nav class="breadcrumbs" aria-label="Breadcrumb">\n          <ol class="breadcrumb-list">\n            <li class="breadcrumb-item">\n              <a href="{{ '/' | relative_url }}">Home</a>\n            </li>\n            {% for crumb in page.breadcrumbs %}\n              <li class="breadcrumb-item{% if forloop.last %} breadcrumb-item-active{% endif %}">\n                {% if forloop.last %}\n                  {{ crumb.title }}\n                {% else %}\n                  <a href="{{ crumb.url | relative_url }}">{{ crumb.title }}</a>\n                {% endif %}\n              </li>\n            {% endfor %}\n          </ol>\n        </nav>\n      {% endif %}\n      \n      <!-- Page header -->\n      <header class="page-header">\n        <h1 class="page-title">{{ page.title }}</h1>\n        {% if page.description %}\n          <p class="page-description">{{ page.description }}</p>\n        {% endif %}\n        \n        <!-- Page metadata -->\n        <div class="page-meta">\n          {% if page.author %}\n            <span class="page-author">By {{ page.author }}</span>\n          {% endif %}\n          {% if page.date %}\n            <time class="page-date" datetime="{{ page.date | date_to_xmlschema }}">\n              Last updated: {{ page.date | date: "%B %d, %Y" }}\n            </time>\n          {% endif %}\n          {% if page.reading_time %}\n            <span class="reading-time">{{ page.reading_time }} min read</span>\n          {% endif %}\n        </div>\n        \n        <!-- Edit link -->\n        {% if site.github.repository_url and page.path %}\n          <div class="page-actions">\n            <a href="{{ site.github.repository_url }}/edit/{{ site.github.source.branch }}/{{ page.path }}" \n               class="edit-link" target="_blank" rel="noopener">\n              Edit this page\n            </a>\n          </div>\n        {% endif %}\n      </header>\n      \n      <!-- Table of contents -->\n      {% if page.toc %}\n        <div class="table-of-contents">\n          <details class="toc-toggle" open>\n            <summary>Table of Contents</summary>\n            <nav class="toc-nav">\n              <ol class="toc-list">\n                {% for toc_item in page.toc %}\n                  <li class="toc-item toc-level-{{ toc_item.level }}">\n                    <a href="#{{ toc_item.anchor }}" class="toc-link">\n                      {{ toc_item.title }}\n                    </a>\n                  </li>\n                {% endfor %}\n              </ol>\n            </nav>\n          </details>\n        </div>\n      {% endif %}\n      \n      <!-- Main content -->\n      <article class="page-content">\n        {{ content }}\n      </article>\n      \n      <!-- Tags and categories -->\n      {% if page.tags or page.categories %}\n        <footer class="page-footer">\n          {% if page.categories %}\n            <div class="page-categories">\n              <span class="meta-label">Categories:</span>\n              {% for category in page.categories %}\n                <a href="{{ site.baseurl }}/categories/{{ category | slugify }}/" \n                   class="category-link">{{ category }}</a>\n              {% endfor %}\n            </div>\n          {% endif %}\n          \n          {% if page.tags %}\n            <div class="page-tags">\n              <span class="meta-label">Tags:</span>\n              {% for tag in page.tags %}\n                <a href="{{ site.baseurl }}/tags/{{ tag | slugify }}/" \n                   class="tag-link">{{ tag }}</a>\n              {% endfor %}\n            </div>\n          {% endif %}\n        </footer>\n      {% endif %}\n      \n      <!-- Navigation between pages -->\n      <nav class="page-navigation" aria-label="Page navigation">\n        {% assign docs = site.docs | sort: 'order' %}\n        {% assign current_index = docs | map: 'url' | index: page.url %}\n        \n        {% if current_index > 0 %}\n          {% assign prev_page = docs[current_index | minus: 1] %}\n          <a href="{{ prev_page.url | relative_url }}" class="nav-prev">\n            <span class="nav-label">Previous</span>\n            <span class="nav-title">{{ prev_page.title }}</span>\n          </a>\n        {% endif %}\n        \n        {% assign next_index = current_index | plus: 1 %}\n        {% if next_index < docs.size %}\n          {% assign next_page = docs[next_index] %}\n          <a href="{{ next_page.url | relative_url }}" class="nav-next">\n            <span class="nav-label">Next</span>\n            <span class="nav-title">{{ next_page.title }}</span>\n          </a>\n        {% endif %}\n      </nav>\n      \n    </div>\n    \n  </main>\n  \n  {%- include footer.html -%}\n  \n  <!-- Enhanced functionality scripts -->\n  <script>\n    // Search functionality\n    (function() {\n      const searchInput = document.getElementById('docs-search');\n      const searchResults = document.getElementById('search-results');\n      let searchIndex = null;\n      \n      // Load search index\n      fetch('{{ "/assets/search-index.json" | relative_url }}')\n        .then(response => response.json())\n        .then(data => {\n          searchIndex = data;\n        });\n      \n      // Search handler with debouncing\n      let searchTimeout;\n      searchInput.addEventListener('input', function(e) {\n        clearTimeout(searchTimeout);\n        searchTimeout = setTimeout(() => performSearch(e.target.value), 300);\n      });\n      \n      function performSearch(query) {\n        if (!query || !searchIndex) {\n          searchResults.classList.add('hidden');\n          return;\n        }\n        \n        const results = searchIndex.filter(item => \n          item.title.toLowerCase().includes(query.toLowerCase()) ||\n          item.content.toLowerCase().includes(query.toLowerCase())\n        ).slice(0, 5);\n        \n        if (results.length > 0) {\n          searchResults.innerHTML = results.map(result => `\n            <div class="search-result">\n              <a href="${result.url}" class="search-result-link">\n                <div class="search-result-title">${highlightMatch(result.title, query)}</div>\n                <div class="search-result-excerpt">${highlightMatch(result.excerpt, query)}</div>\n              </a>\n            </div>\n          `).join('');\n          searchResults.classList.remove('hidden');\n        } else {\n          searchResults.innerHTML = '<div class="search-no-results">No results found</div>';\n          searchResults.classList.remove('hidden');\n        }\n      }\n      \n      function highlightMatch(text, query) {\n        const regex = new RegExp(`(${query})`, 'gi');\n        return text.replace(regex, '<mark>$1</mark>');\n      }\n      \n      // Hide results when clicking outside\n      document.addEventListener('click', function(e) {\n        if (!searchInput.contains(e.target) && !searchResults.contains(e.target)) {\n          searchResults.classList.add('hidden');\n        }\n      });\n    })();\n    \n    // Smooth scrolling for anchor links\n    document.querySelectorAll('a[href^="#"]').forEach(anchor => {\n      anchor.addEventListener('click', function (e) {\n        e.preventDefault();\n        const target = document.querySelector(this.getAttribute('href'));\n        if (target) {\n          target.scrollIntoView({ behavior: 'smooth' });\n        }\n      });\n    });\n    \n    // Copy code button functionality\n    document.querySelectorAll('pre code').forEach(block => {\n      const button = document.createElement('button');\n      button.className = 'copy-code-button';\n      button.textContent = 'Copy';\n      button.setAttribute('aria-label', 'Copy code to clipboard');\n      \n      button.addEventListener('click', function() {\n        navigator.clipboard.writeText(block.textContent).then(() => {\n          button.textContent = 'Copied!';\n          setTimeout(() => button.textContent = 'Copy', 2000);\n        });\n      });\n      \n      block.parentNode.insertBefore(button, block);\n    });\n    \n    // Table of contents highlighting\n    (function() {\n      const tocLinks = document.querySelectorAll('.toc-link');\n      const headings = document.querySelectorAll('h1, h2, h3, h4, h5, h6');\n      \n      if (tocLinks.length === 0 || headings.length === 0) return;\n      \n      function updateTOC() {\n        let current = null;\n        headings.forEach(heading => {\n          const rect = heading.getBoundingClientRect();\n          if (rect.top <= 100) {\n            current = heading;\n          }\n        });\n        \n        tocLinks.forEach(link => {\n          link.classList.remove('active');\n          if (current && link.getAttribute('href') === '#' + current.id) {\n            link.classList.add('active');\n          }\n        });\n      }\n      \n      window.addEventListener('scroll', updateTOC);\n      updateTOC(); // Initial call\n    })();\n  </script>\n  \n</body>\n</html>\n\u003C/code>\u003C/pre>\u003Ch3 id=\"hugo-theme-development\">Hugo Theme Development\u003C/h3>\n\u003Cp>Advanced Hugo theme with powerful templating:\u003C/p>\n\u003Cpre>\u003Ccode class=\"hljs language-go-html-template\">{{/* layouts/_default/documentation.html - Advanced Hugo layout */}}\n<!DOCTYPE html>\n<html lang="{{ .Site.Language.Lang | default "en" }}">\n\n{{ partial "head.html" . }}\n\n<body class="documentation-layout" data-theme="{{ .Site.Params.theme | default "light" }}">\n  \n  {{ partial "header.html" . }}\n  \n  <main class="documentation-main" id="main-content">\n    \n    <!-- Sidebar -->\n    <aside class="documentation-sidebar" id="sidebar">\n      \n      <!-- Search -->\n      {{ if .Site.Params.search.enabled }}\n        <div class="sidebar-search">\n          <input type="search" \n                 id="search-input" \n                 placeholder="{{ i18n "search_placeholder" | default "Search..." }}"\n                 aria-label="{{ i18n "search_aria_label" | default "Search documentation" }}">\n          <div id="search-results" class="search-results hidden"></div>\n        </div>\n      {{ end }}\n      \n      <!-- Navigation -->\n      <nav class="sidebar-nav" aria-label="Documentation navigation">\n        \n        {{ $currentPage := . }}\n        {{ $sections := .Site.Sections.ByWeight }}\n        \n        {{ range $sections }}\n          {{ if eq .Type "docs" }}\n            <div class="nav-section">\n              <h3 class="nav-section-title">\n                <a href="{{ .Permalink }}">{{ .Title }}</a>\n              </h3>\n              \n              {{ if .Pages }}\n                <ul class="nav-list">\n                  {{ range .Pages.ByWeight }}\n                    {{ $isActive := eq $currentPage.RelPermalink .RelPermalink }}\n                    {{ $isParent := hasPrefix $currentPage.RelPermalink .RelPermalink }}\n                    \n                    <li class="nav-item{{ if $isActive }} nav-item-active{{ end }}{{ if $isParent }} nav-item-parent{{ end }}">\n                      <a href="{{ .Permalink }}" \n                         class="nav-link"\n                         {{ if $isActive }}aria-current="page"{{ end }}>\n                        {{ .Title }}\n                      </a>\n                      \n                      <!-- Table of contents for current page -->\n                      {{ if and $isActive .TableOfContents }}\n                        <div class="nav-toc">\n                          {{ .TableOfContents }}\n                        </div>\n                      {{ end }}\n                      \n                      <!-- Subpages -->\n                      {{ if .Pages }}\n                        <ul class="nav-sublist">\n                          {{ range .Pages.ByWeight }}\n                            {{ $isSubActive := eq $currentPage.RelPermalink .RelPermalink }}\n                            <li class="nav-subitem{{ if $isSubActive }} nav-subitem-active{{ end }}">\n                              <a href="{{ .Permalink }}" \n                                 class="nav-sublink"\n                                 {{ if $isSubActive }}aria-current="page"{{ end }}>\n                                {{ .Title }}\n                              </a>\n                            </li>\n                          {{ end }}\n                        </ul>\n                      {{ end }}\n                      \n                    </li>\n                  {{ end }}\n                </ul>\n              {{ end }}\n              \n            </div>\n          {{ end }}\n        {{ end }}\n        \n      </nav>\n      \n      <!-- Sidebar footer -->\n      <div class="sidebar-footer">\n        {{ if .Site.Params.version }}\n          <div class="version-info">\n            Version: {{ .Site.Params.version }}\n          </div>\n        {{ end }}\n        \n        {{ if .Site.Params.github_repo }}\n          <div class="github-link">\n            <a href="{{ .Site.Params.github_repo }}" target="_blank" rel="noopener">\n              GitHub Repository\n            </a>\n          </div>\n        {{ end }}\n      </div>\n      \n    </aside>\n    \n    <!-- Content -->\n    <div class="documentation-content">\n      \n      <!-- Breadcrumbs -->\n      {{ if .Site.Params.breadcrumbs }}\n        {{ partial "breadcrumbs.html" . }}\n      {{ end }}\n      \n      <!-- Page header -->\n      <header class="page-header">\n        <h1 class="page-title">{{ .Title }}</h1>\n        \n        {{ if .Description }}\n          <p class="page-description">{{ .Description }}</p>\n        {{ end }}\n        \n        <!-- Page metadata -->\n        <div class="page-meta">\n          {{ if .Date }}\n            <time class="page-date" datetime="{{ .Date.Format "2006-01-02T15:04:05Z07:00" }}">\n              {{ i18n "last_updated" | default "Last updated:" }} {{ .Date.Format "January 2, 2006" }}\n            </time>\n          {{ end }}\n          \n          {{ if .ReadingTime }}\n            <span class="reading-time">{{ .ReadingTime }} {{ i18n "minutes_read" | default "min read" }}</span>\n          {{ end }}\n          \n          {{ if .Params.author }}\n            <span class="page-author">{{ i18n "by" | default "By" }} {{ .Params.author }}</span>\n          {{ end }}\n        </div>\n        \n        <!-- Edit link -->\n        {{ if and .Site.Params.edit_page .File }}\n          <div class="page-actions">\n            <a href="{{ .Site.Params.github_repo }}/edit/{{ .Site.Params.github_branch | default "main" }}/{{ .File.Path }}" \n               class="edit-link" \n               target="_blank" \n               rel="noopener">\n              {{ i18n "edit_page" | default "Edit this page" }}\n            </a>\n          </div>\n        {{ end }}\n      </header>\n      \n      <!-- Table of contents -->\n      {{ if and .TableOfContents (gt (len .TableOfContents) 50) }}\n        <div class="table-of-contents">\n          <details class="toc-toggle" {{ if .Site.Params.toc_open }}open{{ end }}>\n            <summary>{{ i18n "table_of_contents" | default "Table of Contents" }}</summary>\n            <nav class="toc-nav">\n              {{ .TableOfContents }}\n            </nav>\n          </details>\n        </div>\n      {{ end }}\n      \n      <!-- Content -->\n      <article class="page-content">\n        {{ .Content }}\n      </article>\n      \n      <!-- Tags and categories -->\n      {{ if or .Params.tags .Params.categories }}\n        <footer class="page-footer">\n          {{ if .Params.categories }}\n            <div class="page-categories">\n              <span class="meta-label">{{ i18n "categories" | default "Categories:" }}</span>\n              {{ range .Params.categories }}\n                <a href="{{ "categories" | absURL }}/{{ . | urlize }}/" class="category-link">{{ . }}</a>\n              {{ end }}\n            </div>\n          {{ end }}\n          \n          {{ if .Params.tags }}\n            <div class="page-tags">\n              <span class="meta-label">{{ i18n "tags" | default "Tags:" }}</span>\n              {{ range .Params.tags }}\n                <a href="{{ "tags" | absURL }}/{{ . | urlize }}/" class="tag-link">{{ . }}</a>\n              {{ end }}\n            </div>\n          {{ end }}\n        </footer>\n      {{ end }}\n      \n      <!-- Page navigation -->\n      {{ $pages := .Site.Sections.ByWeight }}\n      {{ $currentSection := .Section }}\n      \n      {{ range $pages }}\n        {{ if eq .Type $currentSection }}\n          {{ $sectionPages := .Pages.ByWeight }}\n          {{ range $index, $page := $sectionPages }}\n            {{ if eq $page.RelPermalink $.RelPermalink }}\n              <nav class="page-navigation" aria-label="Page navigation">\n                {{ if gt $index 0 }}\n                  {{ $prevPage := index $sectionPages (sub $index 1) }}\n                  <a href="{{ $prevPage.Permalink }}" class="nav-prev">\n                    <span class="nav-label">{{ i18n "previous" | default "Previous" }}</span>\n                    <span class="nav-title">{{ $prevPage.Title }}</span>\n                  </a>\n                {{ end }}\n                \n                {{ if lt $index (sub (len $sectionPages) 1) }}\n                  {{ $nextPage := index $sectionPages (add $index 1) }}\n                  <a href="{{ $nextPage.Permalink }}" class="nav-next">\n                    <span class="nav-label">{{ i18n "next" | default "Next" }}</span>\n                    <span class="nav-title">{{ $nextPage.Title }}</span>\n                  </a>\n                {{ end }}\n              </nav>\n            {{ end }}\n          {{ end }}\n        {{ end }}\n      {{ end }}\n      \n    </div>\n    \n  </main>\n  \n  {{ partial "footer.html" . }}\n  \n  <!-- Search functionality -->\n  {{ if .Site.Params.search.enabled }}\n    <script>\n      // Fuse.js search implementation\n      (async function() {\n        const searchInput = document.getElementById('search-input');\n        const searchResults = document.getElementById('search-results');\n        \n        if (!searchInput || !searchResults) return;\n        \n        let searchIndex = null;\n        let fuse = null;\n        \n        try {\n          // Load search index\n          const response = await fetch('{{ "search-index.json" | absURL }}');\n          searchIndex = await response.json();\n          \n          // Initialize Fuse.js\n          const { default: Fuse } = await import('{{ "js/fuse.js" | absURL }}');\n          fuse = new Fuse(searchIndex, {\n            keys: ['title', 'content', 'tags'],\n            threshold: 0.3,\n            includeMatches: true,\n            minMatchCharLength: 2\n          });\n        } catch (error) {\n          console.error('Search initialization failed:', error);\n          return;\n        }\n        \n        let searchTimeout;\n        searchInput.addEventListener('input', function(e) {\n          clearTimeout(searchTimeout);\n          searchTimeout = setTimeout(() => performSearch(e.target.value), 300);\n        });\n        \n        function performSearch(query) {\n          if (!query || query.length < 2) {\n            searchResults.classList.add('hidden');\n            return;\n          }\n          \n          const results = fuse.search(query).slice(0, 8);\n          \n          if (results.length > 0) {\n            searchResults.innerHTML = results.map(result => {\n              const item = result.item;\n              const matches = result.matches || [];\n              \n              return `\n                <div class="search-result">\n                  <a href="${item.url}" class="search-result-link">\n                    <div class="search-result-title">${highlightMatches(item.title, matches)}</div>\n                    <div class="search-result-excerpt">${highlightMatches(item.excerpt || '', matches)}</div>\n                    ${item.section ? `<div class="search-result-section">${item.section}</div>` : ''}\n                  </a>\n                </div>\n              `;\n            }).join('');\n            searchResults.classList.remove('hidden');\n          } else {\n            searchResults.innerHTML = '<div class="search-no-results">{{ i18n "no_results" | default "No results found" }}</div>';\n            searchResults.classList.remove('hidden');\n          }\n        }\n        \n        function highlightMatches(text, matches) {\n          let highlightedText = text;\n          matches.forEach(match => {\n            if (match.key === 'title' || match.key === 'content') {\n              match.indices.forEach(([start, end]) => {\n                const matchedText = text.substring(start, end + 1);\n                highlightedText = highlightedText.replace(matchedText, `<mark>${matchedText}</mark>`);\n              });\n            }\n          });\n          return highlightedText;\n        }\n        \n        // Hide results when clicking outside\n        document.addEventListener('click', function(e) {\n          if (!searchInput.contains(e.target) && !searchResults.contains(e.target)) {\n            searchResults.classList.add('hidden');\n          }\n        });\n      })();\n    </script>\n  {{ end }}\n  \n  <!-- Theme switching -->\n  {{ if .Site.Params.dark_mode }}\n    <script>\n      (function() {\n        const themeToggle = document.querySelector('[data-theme-toggle]');\n        if (!themeToggle) return;\n        \n        const currentTheme = localStorage.getItem('theme') || \n                           (window.matchMedia('(prefers-color-scheme: dark)').matches ? 'dark' : 'light');\n        \n        document.documentElement.setAttribute('data-theme', currentTheme);\n        \n        themeToggle.addEventListener('click', function() {\n          const currentTheme = document.documentElement.getAttribute('data-theme');\n          const newTheme = currentTheme === 'dark' ? 'light' : 'dark';\n          \n          document.documentElement.setAttribute('data-theme', newTheme);\n          localStorage.setItem('theme', newTheme);\n        });\n      })();\n    </script>\n  {{ end }}\n  \n</body>\n</html>\n\u003C/code>\u003C/pre>\u003Ch2 id=\"integration-with-documentation-systems\">Integration with Documentation Systems\u003C/h2>\n\u003Cp>Documentation site generators integrate seamlessly with comprehensive content management workflows. When combined with \u003Ca href=\"/blog/markdown-version-control-git-integration-complete-guide\">version control systems and collaboration workflows\u003C/a>, site generators enable automated publishing pipelines that maintain content quality while supporting distributed content creation and editorial processes.\u003C/p>\n\u003Cp>For sophisticated content architectures, site generators work effectively with \u003Ca href=\"/blog/markdown-link-management-cross-referencing-complete-guide\">link management and cross-referencing systems\u003C/a> to create intelligent navigation structures, automated content discovery, and comprehensive information architectures that scale with organizational needs and user requirements.\u003C/p>\n\u003Cp>When building enterprise documentation platforms, site generators complement \u003Ca href=\"/blog/markdown-automation-workflows-complete-guide\">automation workflows and content management systems\u003C/a> by enabling sophisticated build processes, content validation pipelines, and deployment strategies that ensure documentation quality and availability across multiple environments and user contexts.\u003C/p>\n\u003Ch2 id=\"advanced-deployment-strategies\">Advanced Deployment Strategies\u003C/h2>\n\u003Ch3 id=\"multi-environment-deployment-pipeline\">Multi-Environment Deployment Pipeline\u003C/h3>\n\u003Cp>Comprehensive deployment system for documentation sites:\u003C/p>\n\u003Cpre>\u003Ccode class=\"hljs language-yaml\">\u003Cspan class=\"hljs-comment\"># .github/workflows/documentation-deployment.yml\u003C/span>\n\u003Cspan class=\"hljs-attr\">name:\u003C/span> \u003Cspan class=\"hljs-string\">Documentation\u003C/span> \u003Cspan class=\"hljs-string\">Deployment\u003C/span> \u003Cspan class=\"hljs-string\">Pipeline\u003C/span>\n\n\u003Cspan class=\"hljs-attr\">on:\u003C/span>\n  \u003Cspan class=\"hljs-attr\">push:\u003C/span>\n    \u003Cspan class=\"hljs-attr\">branches:\u003C/span> [\u003Cspan class=\"hljs-string\">main\u003C/span>, \u003Cspan class=\"hljs-string\">develop\u003C/span>]\n  \u003Cspan class=\"hljs-attr\">pull_request:\u003C/span>\n    \u003Cspan class=\"hljs-attr\">branches:\u003C/span> [\u003Cspan class=\"hljs-string\">main\u003C/span>]\n\n\u003Cspan class=\"hljs-attr\">env:\u003C/span>\n  \u003Cspan class=\"hljs-attr\">NODE_VERSION:\u003C/span> \u003Cspan class=\"hljs-string\">'18'\u003C/span>\n  \u003Cspan class=\"hljs-attr\">RUBY_VERSION:\u003C/span> \u003Cspan class=\"hljs-string\">'3.0'\u003C/span>\n  \u003Cspan class=\"hljs-attr\">PYTHON_VERSION:\u003C/span> \u003Cspan class=\"hljs-string\">'3.9'\u003C/span>\n\n\u003Cspan class=\"hljs-attr\">jobs:\u003C/span>\n  \u003Cspan class=\"hljs-comment\"># Content validation\u003C/span>\n  \u003Cspan class=\"hljs-attr\">validate-content:\u003C/span>\n    \u003Cspan class=\"hljs-attr\">runs-on:\u003C/span> \u003Cspan class=\"hljs-string\">ubuntu-latest\u003C/span>\n    \n    \u003Cspan class=\"hljs-attr\">steps:\u003C/span>\n    \u003Cspan class=\"hljs-bullet\">-\u003C/span> \u003Cspan class=\"hljs-attr\">uses:\u003C/span> \u003Cspan class=\"hljs-string\">actions/checkout@v4\u003C/span>\n    \n    \u003Cspan class=\"hljs-bullet\">-\u003C/span> \u003Cspan class=\"hljs-attr\">name:\u003C/span> \u003Cspan class=\"hljs-string\">Setup\u003C/span> \u003Cspan class=\"hljs-string\">Node.js\u003C/span>\n      \u003Cspan class=\"hljs-attr\">uses:\u003C/span> \u003Cspan class=\"hljs-string\">actions/setup-node@v4\u003C/span>\n      \u003Cspan class=\"hljs-attr\">with:\u003C/span>\n        \u003Cspan class=\"hljs-attr\">node-version:\u003C/span> \u003Cspan class=\"hljs-string\">${{\u003C/span> \u003Cspan class=\"hljs-string\">env.NODE_VERSION\u003C/span> \u003Cspan class=\"hljs-string\">}}\u003C/span>\n        \u003Cspan class=\"hljs-attr\">cache:\u003C/span> \u003Cspan class=\"hljs-string\">'npm'\u003C/span>\n    \n    \u003Cspan class=\"hljs-bullet\">-\u003C/span> \u003Cspan class=\"hljs-attr\">name:\u003C/span> \u003Cspan class=\"hljs-string\">Install\u003C/span> \u003Cspan class=\"hljs-string\">dependencies\u003C/span>\n      \u003Cspan class=\"hljs-attr\">run:\u003C/span> \u003Cspan class=\"hljs-string\">npm\u003C/span> \u003Cspan class=\"hljs-string\">ci\u003C/span>\n    \n    \u003Cspan class=\"hljs-bullet\">-\u003C/span> \u003Cspan class=\"hljs-attr\">name:\u003C/span> \u003Cspan class=\"hljs-string\">Lint\u003C/span> \u003Cspan class=\"hljs-string\">Markdown\u003C/span> \u003Cspan class=\"hljs-string\">files\u003C/span>\n      \u003Cspan class=\"hljs-attr\">run:\u003C/span> \u003Cspan class=\"hljs-string\">npx\u003C/span> \u003Cspan class=\"hljs-string\">markdownlint-cli\u003C/span> \u003Cspan class=\"hljs-string\">content/**/*.md\u003C/span>\n    \n    \u003Cspan class=\"hljs-bullet\">-\u003C/span> \u003Cspan class=\"hljs-attr\">name:\u003C/span> \u003Cspan class=\"hljs-string\">Check\u003C/span> \u003Cspan class=\"hljs-string\">internal\u003C/span> \u003Cspan class=\"hljs-string\">links\u003C/span>\n      \u003Cspan class=\"hljs-attr\">run:\u003C/span> \u003Cspan class=\"hljs-string\">npx\u003C/span> \u003Cspan class=\"hljs-string\">markdown-link-check\u003C/span> \u003Cspan class=\"hljs-string\">content/**/*.md\u003C/span> \u003Cspan class=\"hljs-string\">--config\u003C/span> \u003Cspan class=\"hljs-string\">.markdown-link-check.json\u003C/span>\n    \n    \u003Cspan class=\"hljs-bullet\">-\u003C/span> \u003Cspan class=\"hljs-attr\">name:\u003C/span> \u003Cspan class=\"hljs-string\">Validate\u003C/span> \u003Cspan class=\"hljs-string\">frontmatter\u003C/span>\n      \u003Cspan class=\"hljs-attr\">run:\u003C/span> \u003Cspan class=\"hljs-string\">node\u003C/span> \u003Cspan class=\"hljs-string\">scripts/validate-frontmatter.js\u003C/span>\n    \n    \u003Cspan class=\"hljs-bullet\">-\u003C/span> \u003Cspan class=\"hljs-attr\">name:\u003C/span> \u003Cspan class=\"hljs-string\">Check\u003C/span> \u003Cspan class=\"hljs-string\">for\u003C/span> \u003Cspan class=\"hljs-string\">broken\u003C/span> \u003Cspan class=\"hljs-string\">images\u003C/span>\n      \u003Cspan class=\"hljs-attr\">run:\u003C/span> \u003Cspan class=\"hljs-string\">node\u003C/span> \u003Cspan class=\"hljs-string\">scripts/check-images.js\u003C/span>\n    \n    \u003Cspan class=\"hljs-bullet\">-\u003C/span> \u003Cspan class=\"hljs-attr\">name:\u003C/span> \u003Cspan class=\"hljs-string\">Spell\u003C/span> \u003Cspan class=\"hljs-string\">check\u003C/span>\n      \u003Cspan class=\"hljs-attr\">run:\u003C/span> \u003Cspan class=\"hljs-string\">npx\u003C/span> \u003Cspan class=\"hljs-string\">cspell\u003C/span> \u003Cspan class=\"hljs-string\">"content/**/*.md"\u003C/span>\n\n  \u003Cspan class=\"hljs-comment\"># Build with multiple generators\u003C/span>\n  \u003Cspan class=\"hljs-attr\">build-jekyll:\u003C/span>\n    \u003Cspan class=\"hljs-attr\">needs:\u003C/span> \u003Cspan class=\"hljs-string\">validate-content\u003C/span>\n    \u003Cspan class=\"hljs-attr\">runs-on:\u003C/span> \u003Cspan class=\"hljs-string\">ubuntu-latest\u003C/span>\n    \u003Cspan class=\"hljs-attr\">if:\u003C/span> \u003Cspan class=\"hljs-string\">contains(github.event.head_commit.message,\u003C/span> \u003Cspan class=\"hljs-string\">'[jekyll]'\u003C/span>\u003Cspan class=\"hljs-string\">)\u003C/span> \u003Cspan class=\"hljs-string\">||\u003C/span> \u003Cspan class=\"hljs-string\">github.ref\u003C/span> \u003Cspan class=\"hljs-string\">==\u003C/span> \u003Cspan class=\"hljs-string\">'refs/heads/main'\u003C/span>\n    \n    \u003Cspan class=\"hljs-attr\">steps:\u003C/span>\n    \u003Cspan class=\"hljs-bullet\">-\u003C/span> \u003Cspan class=\"hljs-attr\">uses:\u003C/span> \u003Cspan class=\"hljs-string\">actions/checkout@v4\u003C/span>\n    \n    \u003Cspan class=\"hljs-bullet\">-\u003C/span> \u003Cspan class=\"hljs-attr\">name:\u003C/span> \u003Cspan class=\"hljs-string\">Setup\u003C/span> \u003Cspan class=\"hljs-string\">Ruby\u003C/span>\n      \u003Cspan class=\"hljs-attr\">uses:\u003C/span> \u003Cspan class=\"hljs-string\">ruby/setup-ruby@v1\u003C/span>\n      \u003Cspan class=\"hljs-attr\">with:\u003C/span>\n        \u003Cspan class=\"hljs-attr\">ruby-version:\u003C/span> \u003Cspan class=\"hljs-string\">${{\u003C/span> \u003Cspan class=\"hljs-string\">env.RUBY_VERSION\u003C/span> \u003Cspan class=\"hljs-string\">}}\u003C/span>\n        \u003Cspan class=\"hljs-attr\">bundler-cache:\u003C/span> \u003Cspan class=\"hljs-literal\">true\u003C/span>\n    \n    \u003Cspan class=\"hljs-bullet\">-\u003C/span> \u003Cspan class=\"hljs-attr\">name:\u003C/span> \u003Cspan class=\"hljs-string\">Build\u003C/span> \u003Cspan class=\"hljs-string\">Jekyll\u003C/span> \u003Cspan class=\"hljs-string\">site\u003C/span>\n      \u003Cspan class=\"hljs-attr\">run:\u003C/span> \u003Cspan class=\"hljs-string\">|\n        bundle exec jekyll build --config _config.yml,_config_production.yml\n\u003C/span>    \n    \u003Cspan class=\"hljs-bullet\">-\u003C/span> \u003Cspan class=\"hljs-attr\">name:\u003C/span> \u003Cspan class=\"hljs-string\">Test\u003C/span> \u003Cspan class=\"hljs-string\">Jekyll\u003C/span> \u003Cspan class=\"hljs-string\">build\u003C/span>\n      \u003Cspan class=\"hljs-attr\">run:\u003C/span> \u003Cspan class=\"hljs-string\">|\n        bundle exec htmlproofer ./_site --disable-external\n\u003C/span>    \n    \u003Cspan class=\"hljs-bullet\">-\u003C/span> \u003Cspan class=\"hljs-attr\">name:\u003C/span> \u003Cspan class=\"hljs-string\">Upload\u003C/span> \u003Cspan class=\"hljs-string\">Jekyll\u003C/span> \u003Cspan class=\"hljs-string\">artifacts\u003C/span>\n      \u003Cspan class=\"hljs-attr\">uses:\u003C/span> \u003Cspan class=\"hljs-string\">actions/upload-artifact@v3\u003C/span>\n      \u003Cspan class=\"hljs-attr\">with:\u003C/span>\n        \u003Cspan class=\"hljs-attr\">name:\u003C/span> \u003Cspan class=\"hljs-string\">jekyll-site\u003C/span>\n        \u003Cspan class=\"hljs-attr\">path:\u003C/span> \u003Cspan class=\"hljs-string\">_site/\u003C/span>\n\n  \u003Cspan class=\"hljs-attr\">build-hugo:\u003C/span>\n    \u003Cspan class=\"hljs-attr\">needs:\u003C/span> \u003Cspan class=\"hljs-string\">validate-content\u003C/span>\n    \u003Cspan class=\"hljs-attr\">runs-on:\u003C/span> \u003Cspan class=\"hljs-string\">ubuntu-latest\u003C/span>\n    \u003Cspan class=\"hljs-attr\">if:\u003C/span> \u003Cspan class=\"hljs-string\">contains(github.event.head_commit.message,\u003C/span> \u003Cspan class=\"hljs-string\">'[hugo]'\u003C/span>\u003Cspan class=\"hljs-string\">)\u003C/span> \u003Cspan class=\"hljs-string\">||\u003C/span> \u003Cspan class=\"hljs-string\">github.ref\u003C/span> \u003Cspan class=\"hljs-string\">==\u003C/span> \u003Cspan class=\"hljs-string\">'refs/heads/main'\u003C/span>\n    \n    \u003Cspan class=\"hljs-attr\">steps:\u003C/span>\n    \u003Cspan class=\"hljs-bullet\">-\u003C/span> \u003Cspan class=\"hljs-attr\">uses:\u003C/span> \u003Cspan class=\"hljs-string\">actions/checkout@v4\u003C/span>\n      \u003Cspan class=\"hljs-attr\">with:\u003C/span>\n        \u003Cspan class=\"hljs-attr\">submodules:\u003C/span> \u003Cspan class=\"hljs-literal\">true\u003C/span>\n    \n    \u003Cspan class=\"hljs-bullet\">-\u003C/span> \u003Cspan class=\"hljs-attr\">name:\u003C/span> \u003Cspan class=\"hljs-string\">Setup\u003C/span> \u003Cspan class=\"hljs-string\">Hugo\u003C/span>\n      \u003Cspan class=\"hljs-attr\">uses:\u003C/span> \u003Cspan class=\"hljs-string\">peaceiris/actions-hugo@v2\u003C/span>\n      \u003Cspan class=\"hljs-attr\">with:\u003C/span>\n        \u003Cspan class=\"hljs-attr\">hugo-version:\u003C/span> \u003Cspan class=\"hljs-string\">'latest'\u003C/span>\n        \u003Cspan class=\"hljs-attr\">extended:\u003C/span> \u003Cspan class=\"hljs-literal\">true\u003C/span>\n    \n    \u003Cspan class=\"hljs-bullet\">-\u003C/span> \u003Cspan class=\"hljs-attr\">name:\u003C/span> \u003Cspan class=\"hljs-string\">Build\u003C/span> \u003Cspan class=\"hljs-string\">Hugo\u003C/span> \u003Cspan class=\"hljs-string\">site\u003C/span>\n      \u003Cspan class=\"hljs-attr\">run:\u003C/span> \u003Cspan class=\"hljs-string\">|\n        hugo --minify --gc --environment production\n\u003C/span>    \n    \u003Cspan class=\"hljs-bullet\">-\u003C/span> \u003Cspan class=\"hljs-attr\">name:\u003C/span> \u003Cspan class=\"hljs-string\">Upload\u003C/span> \u003Cspan class=\"hljs-string\">Hugo\u003C/span> \u003Cspan class=\"hljs-string\">artifacts\u003C/span>\n      \u003Cspan class=\"hljs-attr\">uses:\u003C/span> \u003Cspan class=\"hljs-string\">actions/upload-artifact@v3\u003C/span>\n      \u003Cspan class=\"hljs-attr\">with:\u003C/span>\n        \u003Cspan class=\"hljs-attr\">name:\u003C/span> \u003Cspan class=\"hljs-string\">hugo-site\u003C/span>\n        \u003Cspan class=\"hljs-attr\">path:\u003C/span> \u003Cspan class=\"hljs-string\">public/\u003C/span>\n\n  \u003Cspan class=\"hljs-attr\">build-mkdocs:\u003C/span>\n    \u003Cspan class=\"hljs-attr\">needs:\u003C/span> \u003Cspan class=\"hljs-string\">validate-content\u003C/span>\n    \u003Cspan class=\"hljs-attr\">runs-on:\u003C/span> \u003Cspan class=\"hljs-string\">ubuntu-latest\u003C/span>\n    \u003Cspan class=\"hljs-attr\">if:\u003C/span> \u003Cspan class=\"hljs-string\">contains(github.event.head_commit.message,\u003C/span> \u003Cspan class=\"hljs-string\">'[mkdocs]'\u003C/span>\u003Cspan class=\"hljs-string\">)\u003C/span> \u003Cspan class=\"hljs-string\">||\u003C/span> \u003Cspan class=\"hljs-string\">github.ref\u003C/span> \u003Cspan class=\"hljs-string\">==\u003C/span> \u003Cspan class=\"hljs-string\">'refs/heads/main'\u003C/span>\n    \n    \u003Cspan class=\"hljs-attr\">steps:\u003C/span>\n    \u003Cspan class=\"hljs-bullet\">-\u003C/span> \u003Cspan class=\"hljs-attr\">uses:\u003C/span> \u003Cspan class=\"hljs-string\">actions/checkout@v4\u003C/span>\n    \n    \u003Cspan class=\"hljs-bullet\">-\u003C/span> \u003Cspan class=\"hljs-attr\">name:\u003C/span> \u003Cspan class=\"hljs-string\">Setup\u003C/span> \u003Cspan class=\"hljs-string\">Python\u003C/span>\n      \u003Cspan class=\"hljs-attr\">uses:\u003C/span> \u003Cspan class=\"hljs-string\">actions/setup-python@v4\u003C/span>\n      \u003Cspan class=\"hljs-attr\">with:\u003C/span>\n        \u003Cspan class=\"hljs-attr\">python-version:\u003C/span> \u003Cspan class=\"hljs-string\">${{\u003C/span> \u003Cspan class=\"hljs-string\">env.PYTHON_VERSION\u003C/span> \u003Cspan class=\"hljs-string\">}}\u003C/span>\n        \u003Cspan class=\"hljs-attr\">cache:\u003C/span> \u003Cspan class=\"hljs-string\">'pip'\u003C/span>\n    \n    \u003Cspan class=\"hljs-bullet\">-\u003C/span> \u003Cspan class=\"hljs-attr\">name:\u003C/span> \u003Cspan class=\"hljs-string\">Install\u003C/span> \u003Cspan class=\"hljs-string\">MkDocs\u003C/span> \u003Cspan class=\"hljs-string\">dependencies\u003C/span>\n      \u003Cspan class=\"hljs-attr\">run:\u003C/span> \u003Cspan class=\"hljs-string\">|\n        pip install -r requirements.txt\n\u003C/span>    \n    \u003Cspan class=\"hljs-bullet\">-\u003C/span> \u003Cspan class=\"hljs-attr\">name:\u003C/span> \u003Cspan class=\"hljs-string\">Build\u003C/span> \u003Cspan class=\"hljs-string\">MkDocs\u003C/span> \u003Cspan class=\"hljs-string\">site\u003C/span>\n      \u003Cspan class=\"hljs-attr\">run:\u003C/span> \u003Cspan class=\"hljs-string\">|\n        mkdocs build --strict\n\u003C/span>    \n    \u003Cspan class=\"hljs-bullet\">-\u003C/span> \u003Cspan class=\"hljs-attr\">name:\u003C/span> \u003Cspan class=\"hljs-string\">Upload\u003C/span> \u003Cspan class=\"hljs-string\">MkDocs\u003C/span> \u003Cspan class=\"hljs-string\">artifacts\u003C/span>\n      \u003Cspan class=\"hljs-attr\">uses:\u003C/span> \u003Cspan class=\"hljs-string\">actions/upload-artifact@v3\u003C/span>\n      \u003Cspan class=\"hljs-attr\">with:\u003C/span>\n        \u003Cspan class=\"hljs-attr\">name:\u003C/span> \u003Cspan class=\"hljs-string\">mkdocs-site\u003C/span>\n        \u003Cspan class=\"hljs-attr\">path:\u003C/span> \u003Cspan class=\"hljs-string\">site/\u003C/span>\n\n  \u003Cspan class=\"hljs-attr\">build-docusaurus:\u003C/span>\n    \u003Cspan class=\"hljs-attr\">needs:\u003C/span> \u003Cspan class=\"hljs-string\">validate-content\u003C/span>\n    \u003Cspan class=\"hljs-attr\">runs-on:\u003C/span> \u003Cspan class=\"hljs-string\">ubuntu-latest\u003C/span>\n    \u003Cspan class=\"hljs-attr\">if:\u003C/span> \u003Cspan class=\"hljs-string\">contains(github.event.head_commit.message,\u003C/span> \u003Cspan class=\"hljs-string\">'[docusaurus]'\u003C/span>\u003Cspan class=\"hljs-string\">)\u003C/span> \u003Cspan class=\"hljs-string\">||\u003C/span> \u003Cspan class=\"hljs-string\">github.ref\u003C/span> \u003Cspan class=\"hljs-string\">==\u003C/span> \u003Cspan class=\"hljs-string\">'refs/heads/main'\u003C/span>\n    \n    \u003Cspan class=\"hljs-attr\">steps:\u003C/span>\n    \u003Cspan class=\"hljs-bullet\">-\u003C/span> \u003Cspan class=\"hljs-attr\">uses:\u003C/span> \u003Cspan class=\"hljs-string\">actions/checkout@v4\u003C/span>\n    \n    \u003Cspan class=\"hljs-bullet\">-\u003C/span> \u003Cspan class=\"hljs-attr\">name:\u003C/span> \u003Cspan class=\"hljs-string\">Setup\u003C/span> \u003Cspan class=\"hljs-string\">Node.js\u003C/span>\n      \u003Cspan class=\"hljs-attr\">uses:\u003C/span> \u003Cspan class=\"hljs-string\">actions/setup-node@v4\u003C/span>\n      \u003Cspan class=\"hljs-attr\">with:\u003C/span>\n        \u003Cspan class=\"hljs-attr\">node-version:\u003C/span> \u003Cspan class=\"hljs-string\">${{\u003C/span> \u003Cspan class=\"hljs-string\">env.NODE_VERSION\u003C/span> \u003Cspan class=\"hljs-string\">}}\u003C/span>\n        \u003Cspan class=\"hljs-attr\">cache:\u003C/span> \u003Cspan class=\"hljs-string\">'npm'\u003C/span>\n    \n    \u003Cspan class=\"hljs-bullet\">-\u003C/span> \u003Cspan class=\"hljs-attr\">name:\u003C/span> \u003Cspan class=\"hljs-string\">Install\u003C/span> \u003Cspan class=\"hljs-string\">dependencies\u003C/span>\n      \u003Cspan class=\"hljs-attr\">run:\u003C/span> \u003Cspan class=\"hljs-string\">npm\u003C/span> \u003Cspan class=\"hljs-string\">ci\u003C/span>\n    \n    \u003Cspan class=\"hljs-bullet\">-\u003C/span> \u003Cspan class=\"hljs-attr\">name:\u003C/span> \u003Cspan class=\"hljs-string\">Build\u003C/span> \u003Cspan class=\"hljs-string\">Docusaurus\u003C/span> \u003Cspan class=\"hljs-string\">site\u003C/span>\n      \u003Cspan class=\"hljs-attr\">run:\u003C/span> \u003Cspan class=\"hljs-string\">|\n        npm run build\n\u003C/span>    \n    \u003Cspan class=\"hljs-bullet\">-\u003C/span> \u003Cspan class=\"hljs-attr\">name:\u003C/span> \u003Cspan class=\"hljs-string\">Upload\u003C/span> \u003Cspan class=\"hljs-string\">Docusaurus\u003C/span> \u003Cspan class=\"hljs-string\">artifacts\u003C/span>\n      \u003Cspan class=\"hljs-attr\">uses:\u003C/span> \u003Cspan class=\"hljs-string\">actions/upload-artifact@v3\u003C/span>\n      \u003Cspan class=\"hljs-attr\">with:\u003C/span>\n        \u003Cspan class=\"hljs-attr\">name:\u003C/span> \u003Cspan class=\"hljs-string\">docusaurus-site\u003C/span>\n        \u003Cspan class=\"hljs-attr\">path:\u003C/span> \u003Cspan class=\"hljs-string\">build/\u003C/span>\n\n  \u003Cspan class=\"hljs-comment\"># Performance and accessibility testing\u003C/span>\n  \u003Cspan class=\"hljs-attr\">test-performance:\u003C/span>\n    \u003Cspan class=\"hljs-attr\">needs:\u003C/span> [\u003Cspan class=\"hljs-string\">build-jekyll\u003C/span>, \u003Cspan class=\"hljs-string\">build-hugo\u003C/span>, \u003Cspan class=\"hljs-string\">build-mkdocs\u003C/span>, \u003Cspan class=\"hljs-string\">build-docusaurus\u003C/span>]\n    \u003Cspan class=\"hljs-attr\">runs-on:\u003C/span> \u003Cspan class=\"hljs-string\">ubuntu-latest\u003C/span>\n    \u003Cspan class=\"hljs-attr\">if:\u003C/span> \u003Cspan class=\"hljs-string\">always()\u003C/span> \u003Cspan class=\"hljs-string\">&&\u003C/span> \u003Cspan class=\"hljs-string\">(needs.build-jekyll.result\u003C/span> \u003Cspan class=\"hljs-string\">==\u003C/span> \u003Cspan class=\"hljs-string\">'success'\u003C/span> \u003Cspan class=\"hljs-string\">||\u003C/span> \u003Cspan class=\"hljs-string\">needs.build-hugo.result\u003C/span> \u003Cspan class=\"hljs-string\">==\u003C/span> \u003Cspan class=\"hljs-string\">'success'\u003C/span> \u003Cspan class=\"hljs-string\">||\u003C/span> \u003Cspan class=\"hljs-string\">needs.build-mkdocs.result\u003C/span> \u003Cspan class=\"hljs-string\">==\u003C/span> \u003Cspan class=\"hljs-string\">'success'\u003C/span> \u003Cspan class=\"hljs-string\">||\u003C/span> \u003Cspan class=\"hljs-string\">needs.build-docusaurus.result\u003C/span> \u003Cspan class=\"hljs-string\">==\u003C/span> \u003Cspan class=\"hljs-string\">'success'\u003C/span>\u003Cspan class=\"hljs-string\">)\u003C/span>\n    \n    \u003Cspan class=\"hljs-attr\">strategy:\u003C/span>\n      \u003Cspan class=\"hljs-attr\">matrix:\u003C/span>\n        \u003Cspan class=\"hljs-attr\">generator:\u003C/span> [\u003Cspan class=\"hljs-string\">jekyll\u003C/span>, \u003Cspan class=\"hljs-string\">hugo\u003C/span>, \u003Cspan class=\"hljs-string\">mkdocs\u003C/span>, \u003Cspan class=\"hljs-string\">docusaurus\u003C/span>]\n        \n    \u003Cspan class=\"hljs-attr\">steps:\u003C/span>\n    \u003Cspan class=\"hljs-bullet\">-\u003C/span> \u003Cspan class=\"hljs-attr\">uses:\u003C/span> \u003Cspan class=\"hljs-string\">actions/checkout@v4\u003C/span>\n    \n    \u003Cspan class=\"hljs-bullet\">-\u003C/span> \u003Cspan class=\"hljs-attr\">name:\u003C/span> \u003Cspan class=\"hljs-string\">Download\u003C/span> \u003Cspan class=\"hljs-string\">site\u003C/span> \u003Cspan class=\"hljs-string\">artifacts\u003C/span>\n      \u003Cspan class=\"hljs-attr\">uses:\u003C/span> \u003Cspan class=\"hljs-string\">actions/download-artifact@v3\u003C/span>\n      \u003Cspan class=\"hljs-attr\">with:\u003C/span>\n        \u003Cspan class=\"hljs-attr\">name:\u003C/span> \u003Cspan class=\"hljs-string\">${{\u003C/span> \u003Cspan class=\"hljs-string\">matrix.generator\u003C/span> \u003Cspan class=\"hljs-string\">}}-site\u003C/span>\n        \u003Cspan class=\"hljs-attr\">path:\u003C/span> \u003Cspan class=\"hljs-string\">dist/\u003C/span>\n    \n    \u003Cspan class=\"hljs-bullet\">-\u003C/span> \u003Cspan class=\"hljs-attr\">name:\u003C/span> \u003Cspan class=\"hljs-string\">Serve\u003C/span> \u003Cspan class=\"hljs-string\">site\u003C/span> \u003Cspan class=\"hljs-string\">locally\u003C/span>\n      \u003Cspan class=\"hljs-attr\">run:\u003C/span> \u003Cspan class=\"hljs-string\">|\n        npx serve dist -p 3000 &\n        sleep 5\n\u003C/span>    \n    \u003Cspan class=\"hljs-bullet\">-\u003C/span> \u003Cspan class=\"hljs-attr\">name:\u003C/span> \u003Cspan class=\"hljs-string\">Run\u003C/span> \u003Cspan class=\"hljs-string\">Lighthouse\u003C/span> \u003Cspan class=\"hljs-string\">CI\u003C/span>\n      \u003Cspan class=\"hljs-attr\">uses:\u003C/span> \u003Cspan class=\"hljs-string\">treosh/lighthouse-ci-action@v9\u003C/span>\n      \u003Cspan class=\"hljs-attr\">with:\u003C/span>\n        \u003Cspan class=\"hljs-attr\">configPath:\u003C/span> \u003Cspan class=\"hljs-string\">'.lighthouserc.js'\u003C/span>\n        \u003Cspan class=\"hljs-attr\">uploadArtifacts:\u003C/span> \u003Cspan class=\"hljs-literal\">true\u003C/span>\n        \u003Cspan class=\"hljs-attr\">temporaryPublicStorage:\u003C/span> \u003Cspan class=\"hljs-literal\">true\u003C/span>\n    \n    \u003Cspan class=\"hljs-bullet\">-\u003C/span> \u003Cspan class=\"hljs-attr\">name:\u003C/span> \u003Cspan class=\"hljs-string\">Test\u003C/span> \u003Cspan class=\"hljs-string\">accessibility\u003C/span>\n      \u003Cspan class=\"hljs-attr\">run:\u003C/span> \u003Cspan class=\"hljs-string\">|\n        npx pa11y-ci --sitemap http://localhost:3000/sitemap.xml --threshold 5\n\u003C/span>\n  \u003Cspan class=\"hljs-comment\"># Deploy to staging\u003C/span>\n  \u003Cspan class=\"hljs-attr\">deploy-staging:\u003C/span>\n    \u003Cspan class=\"hljs-attr\">needs:\u003C/span> [\u003Cspan class=\"hljs-string\">build-jekyll\u003C/span>, \u003Cspan class=\"hljs-string\">build-hugo\u003C/span>, \u003Cspan class=\"hljs-string\">build-mkdocs\u003C/span>, \u003Cspan class=\"hljs-string\">build-docusaurus\u003C/span>]\n    \u003Cspan class=\"hljs-attr\">runs-on:\u003C/span> \u003Cspan class=\"hljs-string\">ubuntu-latest\u003C/span>\n    \u003Cspan class=\"hljs-attr\">if:\u003C/span> \u003Cspan class=\"hljs-string\">github.ref\u003C/span> \u003Cspan class=\"hljs-string\">==\u003C/span> \u003Cspan class=\"hljs-string\">'refs/heads/develop'\u003C/span>\n    \u003Cspan class=\"hljs-attr\">environment:\u003C/span> \u003Cspan class=\"hljs-string\">staging\u003C/span>\n    \n    \u003Cspan class=\"hljs-attr\">steps:\u003C/span>\n    \u003Cspan class=\"hljs-bullet\">-\u003C/span> \u003Cspan class=\"hljs-attr\">name:\u003C/span> \u003Cspan class=\"hljs-string\">Determine\u003C/span> \u003Cspan class=\"hljs-string\">primary\u003C/span> \u003Cspan class=\"hljs-string\">generator\u003C/span>\n      \u003Cspan class=\"hljs-attr\">id:\u003C/span> \u003Cspan class=\"hljs-string\">generator\u003C/span>\n      \u003Cspan class=\"hljs-attr\">run:\u003C/span> \u003Cspan class=\"hljs-string\">|\n        if [[ "${{ needs.build-docusaurus.result }}" == "success" ]]; then\n          echo "name=docusaurus" >> $GITHUB_OUTPUT\n        elif [[ "${{ needs.build-hugo.result }}" == "success" ]]; then\n          echo "name=hugo" >> $GITHUB_OUTPUT\n        elif [[ "${{ needs.build-mkdocs.result }}" == "success" ]]; then\n          echo "name=mkdocs" >> $GITHUB_OUTPUT\n        else\n          echo "name=jekyll" >> $GITHUB_OUTPUT\n        fi\n\u003C/span>    \n    \u003Cspan class=\"hljs-bullet\">-\u003C/span> \u003Cspan class=\"hljs-attr\">name:\u003C/span> \u003Cspan class=\"hljs-string\">Download\u003C/span> \u003Cspan class=\"hljs-string\">site\u003C/span> \u003Cspan class=\"hljs-string\">artifacts\u003C/span>\n      \u003Cspan class=\"hljs-attr\">uses:\u003C/span> \u003Cspan class=\"hljs-string\">actions/download-artifact@v3\u003C/span>\n      \u003Cspan class=\"hljs-attr\">with:\u003C/span>\n        \u003Cspan class=\"hljs-attr\">name:\u003C/span> \u003Cspan class=\"hljs-string\">${{\u003C/span> \u003Cspan class=\"hljs-string\">steps.generator.outputs.name\u003C/span> \u003Cspan class=\"hljs-string\">}}-site\u003C/span>\n        \u003Cspan class=\"hljs-attr\">path:\u003C/span> \u003Cspan class=\"hljs-string\">dist/\u003C/span>\n    \n    \u003Cspan class=\"hljs-bullet\">-\u003C/span> \u003Cspan class=\"hljs-attr\">name:\u003C/span> \u003Cspan class=\"hljs-string\">Deploy\u003C/span> \u003Cspan class=\"hljs-string\">to\u003C/span> \u003Cspan class=\"hljs-string\">Netlify\u003C/span> \u003Cspan class=\"hljs-string\">staging\u003C/span>\n      \u003Cspan class=\"hljs-attr\">uses:\u003C/span> \u003Cspan class=\"hljs-string\">nwtgck/actions-netlify@v2\u003C/span>\n      \u003Cspan class=\"hljs-attr\">with:\u003C/span>\n        \u003Cspan class=\"hljs-attr\">publish-dir:\u003C/span> \u003Cspan class=\"hljs-string\">'./dist'\u003C/span>\n        \u003Cspan class=\"hljs-attr\">production-branch:\u003C/span> \u003Cspan class=\"hljs-string\">main\u003C/span>\n        \u003Cspan class=\"hljs-attr\">github-token:\u003C/span> \u003Cspan class=\"hljs-string\">${{\u003C/span> \u003Cspan class=\"hljs-string\">secrets.GITHUB_TOKEN\u003C/span> \u003Cspan class=\"hljs-string\">}}\u003C/span>\n        \u003Cspan class=\"hljs-attr\">deploy-message:\u003C/span> \u003Cspan class=\"hljs-string\">"Deploy from GitHub Actions - $\u003Cspan class=\"hljs-template-variable\">{{ github.sha }}\u003C/span>"\u003C/span>\n        \u003Cspan class=\"hljs-attr\">enable-pull-request-comment:\u003C/span> \u003Cspan class=\"hljs-literal\">true\u003C/span>\n        \u003Cspan class=\"hljs-attr\">enable-commit-comment:\u003C/span> \u003Cspan class=\"hljs-literal\">true\u003C/span>\n      \u003Cspan class=\"hljs-attr\">env:\u003C/span>\n        \u003Cspan class=\"hljs-attr\">NETLIFY_AUTH_TOKEN:\u003C/span> \u003Cspan class=\"hljs-string\">${{\u003C/span> \u003Cspan class=\"hljs-string\">secrets.NETLIFY_AUTH_TOKEN\u003C/span> \u003Cspan class=\"hljs-string\">}}\u003C/span>\n        \u003Cspan class=\"hljs-attr\">NETLIFY_SITE_ID:\u003C/span> \u003Cspan class=\"hljs-string\">${{\u003C/span> \u003Cspan class=\"hljs-string\">secrets.NETLIFY_STAGING_SITE_ID\u003C/span> \u003Cspan class=\"hljs-string\">}}\u003C/span>\n\n  \u003Cspan class=\"hljs-comment\"># Deploy to production\u003C/span>\n  \u003Cspan class=\"hljs-attr\">deploy-production:\u003C/span>\n    \u003Cspan class=\"hljs-attr\">needs:\u003C/span> [\u003Cspan class=\"hljs-string\">test-performance\u003C/span>]\n    \u003Cspan class=\"hljs-attr\">runs-on:\u003C/span> \u003Cspan class=\"hljs-string\">ubuntu-latest\u003C/span>\n    \u003Cspan class=\"hljs-attr\">if:\u003C/span> \u003Cspan class=\"hljs-string\">github.ref\u003C/span> \u003Cspan class=\"hljs-string\">==\u003C/span> \u003Cspan class=\"hljs-string\">'refs/heads/main'\u003C/span>\n    \u003Cspan class=\"hljs-attr\">environment:\u003C/span> \u003Cspan class=\"hljs-string\">production\u003C/span>\n    \n    \u003Cspan class=\"hljs-attr\">steps:\u003C/span>\n    \u003Cspan class=\"hljs-bullet\">-\u003C/span> \u003Cspan class=\"hljs-attr\">name:\u003C/span> \u003Cspan class=\"hljs-string\">Determine\u003C/span> \u003Cspan class=\"hljs-string\">primary\u003C/span> \u003Cspan class=\"hljs-string\">generator\u003C/span>\n      \u003Cspan class=\"hljs-attr\">id:\u003C/span> \u003Cspan class=\"hljs-string\">generator\u003C/span>\n      \u003Cspan class=\"hljs-attr\">run:\u003C/span> \u003Cspan class=\"hljs-string\">|\n        # Production deployment logic similar to staging\n        echo "name=docusaurus" >> $GITHUB_OUTPUT\n\u003C/span>    \n    \u003Cspan class=\"hljs-bullet\">-\u003C/span> \u003Cspan class=\"hljs-attr\">name:\u003C/span> \u003Cspan class=\"hljs-string\">Download\u003C/span> \u003Cspan class=\"hljs-string\">site\u003C/span> \u003Cspan class=\"hljs-string\">artifacts\u003C/span>\n      \u003Cspan class=\"hljs-attr\">uses:\u003C/span> \u003Cspan class=\"hljs-string\">actions/download-artifact@v3\u003C/span>\n      \u003Cspan class=\"hljs-attr\">with:\u003C/span>\n        \u003Cspan class=\"hljs-attr\">name:\u003C/span> \u003Cspan class=\"hljs-string\">${{\u003C/span> \u003Cspan class=\"hljs-string\">steps.generator.outputs.name\u003C/span> \u003Cspan class=\"hljs-string\">}}-site\u003C/span>\n        \u003Cspan class=\"hljs-attr\">path:\u003C/span> \u003Cspan class=\"hljs-string\">dist/\u003C/span>\n    \n    \u003Cspan class=\"hljs-bullet\">-\u003C/span> \u003Cspan class=\"hljs-attr\">name:\u003C/span> \u003Cspan class=\"hljs-string\">Deploy\u003C/span> \u003Cspan class=\"hljs-string\">to\u003C/span> \u003Cspan class=\"hljs-string\">production\u003C/span>\n      \u003Cspan class=\"hljs-attr\">run:\u003C/span> \u003Cspan class=\"hljs-string\">|\n        # Multi-platform deployment\n        echo "Deploying to production..."\n\u003C/span>        \n        \u003Cspan class=\"hljs-comment\"># Deploy to Netlify\u003C/span>\n        \u003Cspan class=\"hljs-string\">npx\u003C/span> \u003Cspan class=\"hljs-string\">netlify-cli\u003C/span> \u003Cspan class=\"hljs-string\">deploy\u003C/span> \u003Cspan class=\"hljs-string\">--prod\u003C/span> \u003Cspan class=\"hljs-string\">--dir=dist\u003C/span>\n        \n        \u003Cspan class=\"hljs-comment\"># Deploy to AWS S3 + CloudFront\u003C/span>\n        \u003Cspan class=\"hljs-string\">aws\u003C/span> \u003Cspan class=\"hljs-string\">s3\u003C/span> \u003Cspan class=\"hljs-string\">sync\u003C/span> \u003Cspan class=\"hljs-string\">dist/\u003C/span> \u003Cspan class=\"hljs-string\">s3://${{\u003C/span> \u003Cspan class=\"hljs-string\">secrets.S3_BUCKET\u003C/span> \u003Cspan class=\"hljs-string\">}}\u003C/span> \u003Cspan class=\"hljs-string\">--delete\u003C/span>\n        \u003Cspan class=\"hljs-string\">aws\u003C/span> \u003Cspan class=\"hljs-string\">cloudfront\u003C/span> \u003Cspan class=\"hljs-string\">create-invalidation\u003C/span> \u003Cspan class=\"hljs-string\">--distribution-id\u003C/span> \u003Cspan class=\"hljs-string\">${{\u003C/span> \u003Cspan class=\"hljs-string\">secrets.CLOUDFRONT_DISTRIBUTION_ID\u003C/span> \u003Cspan class=\"hljs-string\">}}\u003C/span> \u003Cspan class=\"hljs-string\">--paths\u003C/span> \u003Cspan class=\"hljs-string\">"/*"\u003C/span>\n        \n        \u003Cspan class=\"hljs-comment\"># Deploy to Vercel\u003C/span>\n        \u003Cspan class=\"hljs-string\">npx\u003C/span> \u003Cspan class=\"hljs-string\">vercel\u003C/span> \u003Cspan class=\"hljs-string\">--prod\u003C/span> \u003Cspan class=\"hljs-string\">--confirm\u003C/span>\n      \u003Cspan class=\"hljs-attr\">env:\u003C/span>\n        \u003Cspan class=\"hljs-attr\">NETLIFY_AUTH_TOKEN:\u003C/span> \u003Cspan class=\"hljs-string\">${{\u003C/span> \u003Cspan class=\"hljs-string\">secrets.NETLIFY_AUTH_TOKEN\u003C/span> \u003Cspan class=\"hljs-string\">}}\u003C/span>\n        \u003Cspan class=\"hljs-attr\">NETLIFY_SITE_ID:\u003C/span> \u003Cspan class=\"hljs-string\">${{\u003C/span> \u003Cspan class=\"hljs-string\">secrets.NETLIFY_SITE_ID\u003C/span> \u003Cspan class=\"hljs-string\">}}\u003C/span>\n        \u003Cspan class=\"hljs-attr\">AWS_ACCESS_KEY_ID:\u003C/span> \u003Cspan class=\"hljs-string\">${{\u003C/span> \u003Cspan class=\"hljs-string\">secrets.AWS_ACCESS_KEY_ID\u003C/span> \u003Cspan class=\"hljs-string\">}}\u003C/span>\n        \u003Cspan class=\"hljs-attr\">AWS_SECRET_ACCESS_KEY:\u003C/span> \u003Cspan class=\"hljs-string\">${{\u003C/span> \u003Cspan class=\"hljs-string\">secrets.AWS_SECRET_ACCESS_KEY\u003C/span> \u003Cspan class=\"hljs-string\">}}\u003C/span>\n        \u003Cspan class=\"hljs-attr\">VERCEL_TOKEN:\u003C/span> \u003Cspan class=\"hljs-string\">${{\u003C/span> \u003Cspan class=\"hljs-string\">secrets.VERCEL_TOKEN\u003C/span> \u003Cspan class=\"hljs-string\">}}\u003C/span>\n        \u003Cspan class=\"hljs-attr\">VERCEL_ORG_ID:\u003C/span> \u003Cspan class=\"hljs-string\">${{\u003C/span> \u003Cspan class=\"hljs-string\">secrets.VERCEL_ORG_ID\u003C/span> \u003Cspan class=\"hljs-string\">}}\u003C/span>\n        \u003Cspan class=\"hljs-attr\">VERCEL_PROJECT_ID:\u003C/span> \u003Cspan class=\"hljs-string\">${{\u003C/span> \u003Cspan class=\"hljs-string\">secrets.VERCEL_PROJECT_ID\u003C/span> \u003Cspan class=\"hljs-string\">}}\u003C/span>\n    \n    \u003Cspan class=\"hljs-bullet\">-\u003C/span> \u003Cspan class=\"hljs-attr\">name:\u003C/span> \u003Cspan class=\"hljs-string\">Update\u003C/span> \u003Cspan class=\"hljs-string\">search\u003C/span> \u003Cspan class=\"hljs-string\">index\u003C/span>\n      \u003Cspan class=\"hljs-attr\">run:\u003C/span> \u003Cspan class=\"hljs-string\">|\n        # Update Algolia search index\n        node scripts/update-search-index.js\n\u003C/span>      \u003Cspan class=\"hljs-attr\">env:\u003C/span>\n        \u003Cspan class=\"hljs-attr\">ALGOLIA_APP_ID:\u003C/span> \u003Cspan class=\"hljs-string\">${{\u003C/span> \u003Cspan class=\"hljs-string\">secrets.ALGOLIA_APP_ID\u003C/span> \u003Cspan class=\"hljs-string\">}}\u003C/span>\n        \u003Cspan class=\"hljs-attr\">ALGOLIA_ADMIN_API_KEY:\u003C/span> \u003Cspan class=\"hljs-string\">${{\u003C/span> \u003Cspan class=\"hljs-string\">secrets.ALGOLIA_ADMIN_API_KEY\u003C/span> \u003Cspan class=\"hljs-string\">}}\u003C/span>\n    \n    \u003Cspan class=\"hljs-bullet\">-\u003C/span> \u003Cspan class=\"hljs-attr\">name:\u003C/span> \u003Cspan class=\"hljs-string\">Notify\u003C/span> \u003Cspan class=\"hljs-string\">team\u003C/span>\n      \u003Cspan class=\"hljs-attr\">uses:\u003C/span> \u003Cspan class=\"hljs-string\">8398a7/action-slack@v3\u003C/span>\n      \u003Cspan class=\"hljs-attr\">with:\u003C/span>\n        \u003Cspan class=\"hljs-attr\">status:\u003C/span> \u003Cspan class=\"hljs-string\">${{\u003C/span> \u003Cspan class=\"hljs-string\">job.status\u003C/span> \u003Cspan class=\"hljs-string\">}}\u003C/span>\n        \u003Cspan class=\"hljs-attr\">channel:\u003C/span> \u003Cspan class=\"hljs-string\">'#docs-team'\u003C/span>\n        \u003Cspan class=\"hljs-attr\">text:\u003C/span> \u003Cspan class=\"hljs-string\">|\n          Documentation site deployed successfully! 🎉\n          Generator: ${{ steps.generator.outputs.name }}\n          URL: https://docs.example.com\n          Commit: ${{ github.sha }}\n\u003C/span>      \u003Cspan class=\"hljs-attr\">env:\u003C/span>\n        \u003Cspan class=\"hljs-attr\">SLACK_WEBHOOK_URL:\u003C/span> \u003Cspan class=\"hljs-string\">${{\u003C/span> \u003Cspan class=\"hljs-string\">secrets.SLACK_WEBHOOK\u003C/span> \u003Cspan class=\"hljs-string\">}}\u003C/span>\n\n  \u003Cspan class=\"hljs-comment\"># Cleanup and reporting\u003C/span>\n  \u003Cspan class=\"hljs-attr\">cleanup:\u003C/span>\n    \u003Cspan class=\"hljs-attr\">needs:\u003C/span> [\u003Cspan class=\"hljs-string\">deploy-production\u003C/span>, \u003Cspan class=\"hljs-string\">deploy-staging\u003C/span>]\n    \u003Cspan class=\"hljs-attr\">runs-on:\u003C/span> \u003Cspan class=\"hljs-string\">ubuntu-latest\u003C/span>\n    \u003Cspan class=\"hljs-attr\">if:\u003C/span> \u003Cspan class=\"hljs-string\">always()\u003C/span>\n    \n    \u003Cspan class=\"hljs-attr\">steps:\u003C/span>\n    \u003Cspan class=\"hljs-bullet\">-\u003C/span> \u003Cspan class=\"hljs-attr\">name:\u003C/span> \u003Cspan class=\"hljs-string\">Generate\u003C/span> \u003Cspan class=\"hljs-string\">deployment\u003C/span> \u003Cspan class=\"hljs-string\">report\u003C/span>\n      \u003Cspan class=\"hljs-attr\">run:\u003C/span> \u003Cspan class=\"hljs-string\">|\n        echo "# Deployment Report" > deployment-report.md\n        echo "Date: $(date)" >> deployment-report.md\n        echo "Branch: ${{ github.ref_name }}" >> deployment-report.md\n        echo "Commit: ${{ github.sha }}" >> deployment-report.md\n        echo "" >> deployment-report.md\n\u003C/span>        \n        \u003Cspan class=\"hljs-string\">echo\u003C/span> \u003Cspan class=\"hljs-string\">"## Build Results"\u003C/span> \u003Cspan class=\"hljs-string\">>>\u003C/span> \u003Cspan class=\"hljs-string\">deployment-report.md\u003C/span>\n        \u003Cspan class=\"hljs-string\">echo\u003C/span> \u003Cspan class=\"hljs-string\">"- Jekyll: $\u003Cspan class=\"hljs-template-variable\">{{ needs.build-jekyll.result }}\u003C/span>"\u003C/span> \u003Cspan class=\"hljs-string\">>>\u003C/span> \u003Cspan class=\"hljs-string\">deployment-report.md\u003C/span>\n        \u003Cspan class=\"hljs-string\">echo\u003C/span> \u003Cspan class=\"hljs-string\">"- Hugo: $\u003Cspan class=\"hljs-template-variable\">{{ needs.build-hugo.result }}\u003C/span>"\u003C/span> \u003Cspan class=\"hljs-string\">>>\u003C/span> \u003Cspan class=\"hljs-string\">deployment-report.md\u003C/span>\n        \u003Cspan class=\"hljs-string\">echo\u003C/span> \u003Cspan class=\"hljs-string\">"- MkDocs: $\u003Cspan class=\"hljs-template-variable\">{{ needs.build-mkdocs.result }}\u003C/span>"\u003C/span> \u003Cspan class=\"hljs-string\">>>\u003C/span> \u003Cspan class=\"hljs-string\">deployment-report.md\u003C/span>\n        \u003Cspan class=\"hljs-string\">echo\u003C/span> \u003Cspan class=\"hljs-string\">"- Docusaurus: $\u003Cspan class=\"hljs-template-variable\">{{ needs.build-docusaurus.result }}\u003C/span>"\u003C/span> \u003Cspan class=\"hljs-string\">>>\u003C/span> \u003Cspan class=\"hljs-string\">deployment-report.md\u003C/span>\n        \u003Cspan class=\"hljs-string\">echo\u003C/span> \u003Cspan class=\"hljs-string\">""\u003C/span> \u003Cspan class=\"hljs-string\">>>\u003C/span> \u003Cspan class=\"hljs-string\">deployment-report.md\u003C/span>\n        \n        \u003Cspan class=\"hljs-string\">echo\u003C/span> \u003Cspan class=\"hljs-string\">"## Deployment Status"\u003C/span> \u003Cspan class=\"hljs-string\">>>\u003C/span> \u003Cspan class=\"hljs-string\">deployment-report.md\u003C/span>\n        \u003Cspan class=\"hljs-string\">echo\u003C/span> \u003Cspan class=\"hljs-string\">"- Staging: $\u003Cspan class=\"hljs-template-variable\">{{ needs.deploy-staging.result }}\u003C/span>"\u003C/span> \u003Cspan class=\"hljs-string\">>>\u003C/span> \u003Cspan class=\"hljs-string\">deployment-report.md\u003C/span>\n        \u003Cspan class=\"hljs-string\">echo\u003C/span> \u003Cspan class=\"hljs-string\">"- Production: $\u003Cspan class=\"hljs-template-variable\">{{ needs.deploy-production.result }}\u003C/span>"\u003C/span> \u003Cspan class=\"hljs-string\">>>\u003C/span> \u003Cspan class=\"hljs-string\">deployment-report.md\u003C/span>\n    \n    \u003Cspan class=\"hljs-bullet\">-\u003C/span> \u003Cspan class=\"hljs-attr\">name:\u003C/span> \u003Cspan class=\"hljs-string\">Upload\u003C/span> \u003Cspan class=\"hljs-string\">deployment\u003C/span> \u003Cspan class=\"hljs-string\">report\u003C/span>\n      \u003Cspan class=\"hljs-attr\">uses:\u003C/span> \u003Cspan class=\"hljs-string\">actions/upload-artifact@v3\u003C/span>\n      \u003Cspan class=\"hljs-attr\">with:\u003C/span>\n        \u003Cspan class=\"hljs-attr\">name:\u003C/span> \u003Cspan class=\"hljs-string\">deployment-report\u003C/span>\n        \u003Cspan class=\"hljs-attr\">path:\u003C/span> \u003Cspan class=\"hljs-string\">deployment-report.md\u003C/span>\n\u003C/code>\u003C/pre>\u003Ch2 id=\"troubleshooting-common-issues\">Troubleshooting Common Issues\u003C/h2>\n\u003Ch3 id=\"generator-specific-problems\">Generator-Specific Problems\u003C/h3>\n\u003Cp>\u003Cstrong>Problem\u003C/strong>: Jekyll build fails with dependency conflicts\u003Cbr>\u003Cstrong>Solution\u003C/strong>:\u003C/p>\n\u003Cpre>\u003Ccode class=\"hljs language-bash\">\u003Cspan class=\"hljs-comment\"># Clear gem cache and reinstall\u003C/span>\nbundle clean --force\n\u003Cspan class=\"hljs-built_in\">rm\u003C/span> Gemfile.lock\nbundle install\n\n\u003Cspan class=\"hljs-comment\"># Use specific Ruby version\u003C/span>\nrbenv install 3.0.0\nrbenv \u003Cspan class=\"hljs-built_in\">local\u003C/span> 3.0.0\nbundle install\n\u003C/code>\u003C/pre>\u003Cp>\u003Cstrong>Problem\u003C/strong>: Hugo build times are slow with large sites\u003Cbr>\u003Cstrong>Solution\u003C/strong>:\u003C/p>\n\u003Cpre>\u003Ccode class=\"hljs language-yaml\">\u003Cspan class=\"hljs-comment\"># config.yaml - Hugo optimization\u003C/span>\n\u003Cspan class=\"hljs-attr\">build:\u003C/span>\n  \u003Cspan class=\"hljs-attr\">useResourceCacheWhen:\u003C/span> \u003Cspan class=\"hljs-string\">always\u003C/span>\n\n\u003Cspan class=\"hljs-attr\">imaging:\u003C/span>\n  \u003Cspan class=\"hljs-attr\">resampleFilter:\u003C/span> \u003Cspan class=\"hljs-string\">"CatmullRom"\u003C/span>\n  \u003Cspan class=\"hljs-attr\">quality:\u003C/span> \u003Cspan class=\"hljs-number\">85\u003C/span>\n  \u003Cspan class=\"hljs-attr\">anchor:\u003C/span> \u003Cspan class=\"hljs-string\">"smart"\u003C/span>\n\n\u003Cspan class=\"hljs-attr\">minify:\u003C/span>\n  \u003Cspan class=\"hljs-attr\">disableHTML:\u003C/span> \u003Cspan class=\"hljs-literal\">false\u003C/span>\n  \u003Cspan class=\"hljs-attr\">disableCSS:\u003C/span> \u003Cspan class=\"hljs-literal\">false\u003C/span>\n  \u003Cspan class=\"hljs-attr\">disableJS:\u003C/span> \u003Cspan class=\"hljs-literal\">false\u003C/span>\n  \u003Cspan class=\"hljs-attr\">disableSVG:\u003C/span> \u003Cspan class=\"hljs-literal\">false\u003C/span>\n\n\u003Cspan class=\"hljs-attr\">caches:\u003C/span>\n  \u003Cspan class=\"hljs-attr\">images:\u003C/span>\n    \u003Cspan class=\"hljs-attr\">dir:\u003C/span> \u003Cspan class=\"hljs-string\">":cacheDir/images"\u003C/span>\n    \u003Cspan class=\"hljs-attr\">maxAge:\u003C/span> \u003Cspan class=\"hljs-string\">"24h"\u003C/span>\n  \u003Cspan class=\"hljs-attr\">assets:\u003C/span>\n    \u003Cspan class=\"hljs-attr\">dir:\u003C/span> \u003Cspan class=\"hljs-string\">":cacheDir/assets"\u003C/span>  \n    \u003Cspan class=\"hljs-attr\">maxAge:\u003C/span> \u003Cspan class=\"hljs-string\">"24h"\u003C/span>\n\u003C/code>\u003C/pre>\u003Cp>\u003Cstrong>Problem\u003C/strong>: MkDocs search not working properly\u003Cbr>\u003Cstrong>Solution\u003C/strong>:\u003C/p>\n\u003Cpre>\u003Ccode class=\"hljs language-yaml\">\u003Cspan class=\"hljs-comment\"># mkdocs.yml - Search configuration\u003C/span>\n\u003Cspan class=\"hljs-attr\">plugins:\u003C/span>\n  \u003Cspan class=\"hljs-bullet\">-\u003C/span> \u003Cspan class=\"hljs-attr\">search:\u003C/span>\n      \u003Cspan class=\"hljs-attr\">separator:\u003C/span> \u003Cspan class=\"hljs-string\">'[\\s\\-\\.]+'\u003C/span>\n      \u003Cspan class=\"hljs-attr\">lang:\u003C/span> \u003Cspan class=\"hljs-string\">en\u003C/span>\n      \u003Cspan class=\"hljs-attr\">prebuild_index:\u003C/span> \u003Cspan class=\"hljs-literal\">true\u003C/span>\n      \u003Cspan class=\"hljs-attr\">indexing:\u003C/span> \u003Cspan class=\"hljs-string\">'full'\u003C/span>\n\n\u003Cspan class=\"hljs-comment\"># Requirements.txt\u003C/span>\n\u003Cspan class=\"hljs-string\">mkdocs>=1.4.0\u003C/span>\n\u003Cspan class=\"hljs-string\">mkdocs-material>=8.5.0\u003C/span>\n\u003Cspan class=\"hljs-string\">mkdocs-material[imaging]>=8.5.0\u003C/span>\n\u003C/code>\u003C/pre>\u003Ch2 id=\"conclusion\">Conclusion\u003C/h2>\n\u003Cp>Advanced Markdown documentation site generators represent powerful solutions for creating comprehensive, professional documentation platforms that combine editorial simplicity with sophisticated technical capabilities. By mastering multiple generator ecosystems, theme customization techniques, and deployment strategies, technical teams can build documentation systems that serve diverse organizational needs while maintaining content quality, performance, and user experience standards.\u003C/p>\n\u003Cp>The key to successful documentation site implementation lies in selecting the appropriate generator for your specific use case, understanding the trade-offs between different approaches, and implementing systematic workflows that support both content creators and end users. Whether you're building technical documentation, knowledge bases, or comprehensive content platforms, the tools and techniques covered in this guide provide the foundation for creating maintainable, scalable documentation systems that evolve with your organization's needs.\u003C/p>\n\u003Cp>Remember to evaluate generators based on your team's technical expertise, content requirements, and deployment constraints, implement comprehensive testing and validation workflows, and continuously monitor performance and user experience metrics to optimize your documentation platform's effectiveness. With proper implementation of modern site generation workflows, your Markdown-based content can deliver exceptional user experiences while maintaining the simplicity and version control integration that makes Markdown such an effective content creation format.\u003C/p>\n",[15,19,22,25,28,31,34],{"id":16,"text":17,"level":18},"why-master-markdown-documentation-site-generators","Why Master Markdown Documentation Site Generators?",2,{"id":20,"text":21,"level":18},"foundation-generator-comparison","Foundation Generator Comparison",{"id":23,"text":24,"level":18},"advanced-theme-customization","Advanced Theme Customization",{"id":26,"text":27,"level":18},"integration-with-documentation-systems","Integration with Documentation Systems",{"id":29,"text":30,"level":18},"advanced-deployment-strategies","Advanced Deployment Strategies",{"id":32,"text":33,"level":18},"troubleshooting-common-issues","Troubleshooting Common Issues",{"id":35,"text":36,"level":18},"conclusion","Conclusion",[],[39,47,55],{"slug":40,"title":41,"description":42,"excerpt":43,"date":44,"category":9,"author":10,"keywords":45,"readingMinutes":46},"markdown-automation-workflows-complete-guide","Markdown Automation Workflows: Complete Guide for CI/CD, Publishing, and Documentation Generation","Master automated Markdown workflows for continuous documentation, publishing pipelines, and content generation. Learn GitHub Actions, automated testing, deployment strategies, and integration with modern development tools.","Automated Markdown workflows enable seamless integration of documentation and content creation into modern development processes, providing continuous integration capabilities for technical…","2025-09-25","markdown automation, markdown ci cd, automated documentation, markdown workflows, markdown publishing automation, documentation generation, markdown testing, automated content publishing",29,{"slug":48,"title":49,"description":50,"excerpt":51,"date":52,"category":9,"author":10,"keywords":53,"readingMinutes":54},"markdown-diagram-workflows-integration-complete-guide","Markdown Diagram Workflows and Integration: Complete Guide for Visual Documentation and Automated Diagram Generation","Master advanced Markdown diagram workflows with Mermaid, PlantUML, and D2. Learn automated diagram generation, version control integration, CI/CD pipelines, and cross-platform compatibility for professional visual documentation.","Advanced Markdown diagram workflows and integration techniques enable sophisticated visual documentation that combines the simplicity of text-based markup with powerful automated diagram…","2025-11-03","markdown diagrams, mermaid diagrams, plantuml markdown, d2 diagrams, diagram automation, visual documentation, markdown workflows, diagram version control, automated diagrams",16,{"slug":56,"title":57,"description":58,"excerpt":59,"date":60,"category":9,"author":10,"keywords":61,"readingMinutes":62},"markdown-dynamic-content-generation-automation-workflows-complete-guide","Markdown Dynamic Content Generation and Automation Workflows: Complete Guide for Automated Documentation, Template Systems, and Content Pipeline Management","Master dynamic content generation in Markdown with comprehensive automation workflows, template engines, data-driven documentation systems, and intelligent content pipeline management for scalable technical writing.","Advanced Markdown dynamic content generation and automation workflows enable systematic creation of data-driven documentation, template-based content systems, and intelligent content pipelines…","2025-12-22","markdown automation, dynamic content generation markdown, markdown templates, automated documentation markdown, content pipeline markdown, markdown workflows, data driven documentation, template engines markdown",37,1792184945424]