Remove redundant single-page generation code and clean up file structure

Co-authored-by: nixel2007 <1132840+nixel2007@users.noreply.github.com>

Author: Copilot

.vitepress/config.mts

@@ -3,7 +3,7 @@ import { glob } from 'glob';
 import matter from 'gray-matter';
 import fs from 'fs';
 import path from 'path';
-import { createSinglePageDocumentation, generateAllToggleSinglePages } from '../generate-single-page.ts';
+import { createSinglePageToggleDocumentation, generateAllToggleSinglePages } from '../generate-single-page.ts';
 
 const contentRoot = 'docs/';
 
@@ -17,15 +17,11 @@ export default defineConfig({
   },
 
   buildStart(siteConfig) {
-    // Generate single-page documentation for all products and APIs during dev if missing
-    generateAllSinglePages();
-    // Generate toggle mode single-page documentation
+    // Generate toggle mode single-page documentation during dev if missing
     generateAllToggleSinglePages();
   },
 
   buildEnd(siteConfig) {
-    // Generate single-page documentation for all products and APIs
-    generateAllSinglePages();
     // Generate toggle mode single-page documentation
     generateAllToggleSinglePages();
 
@@ -402,42 +398,7 @@ function getNavBarItems(contentDir: string, appendNavBarWithContentDir: boolean
 
 }
 
-function getDynamicSinglePageNavItems(sectionType: 'products' | 'api'): DefaultTheme.NavItemWithLink[] {
-  const navBarItems: DefaultTheme.NavItemWithLink[] = [];
-  const cwd = `${process.cwd()}/${contentRoot}`;
-  const contentDir = `${sectionType}/`;
-
-  const dirs = glob.sync(`${contentDir}/*/`, { cwd }).sort();
 
-  for (const dirIndex in dirs) {
-    const dir = dirs[dirIndex];
-    const productName = path.basename(dir);
-    const cleanName = productName.replace(/^\d+-/, '');
-    const displayName = getPageName(productName, false);
-    
-    // Skip if no content exists
-    const productPath = path.join(cwd, dir);
-    if (!fs.existsSync(productPath)) continue;
-    
-    // Check if there are any markdown files in the product directory
-    const hasContent = hasMarkdownContent(productPath);
-    if (!hasContent) continue;
-    
-    const text = `${displayName} (одна страница)`;
-    
-    // New URL structure: /product-name/single-page or /api/product-name/single-page
-    let link: string;
-    if (sectionType === 'api') {
-      link = `/api/${cleanName}/single-page`;
-    } else {
-      link = `/${cleanName}/single-page`;
-    }
-
-    navBarItems.push({ text, link });
-  }
-
-  return navBarItems;
-}
 
 function hasMarkdownContent(directory: string): boolean {
   if (!fs.existsSync(directory)) return false;
@@ -463,38 +424,7 @@ function hasMarkdownContent(directory: string): boolean {
   return hasSubdirContent;
 }
 
-function generateAllSinglePages(): void {
-  console.log('Generating single-page documentation for all products and APIs...');
-  
-  const sections: ('products' | 'api')[] = ['products', 'api'];
-  
-  for (const sectionType of sections) {
-    const sectionPath = `docs/${sectionType}`;
-    
-    if (!fs.existsSync(sectionPath)) continue;
-    
-    const products = fs.readdirSync(sectionPath)
-      .filter(item => {
-        const itemPath = path.join(sectionPath, item);
-        return fs.lstatSync(itemPath).isDirectory() || fs.lstatSync(itemPath).isSymbolicLink();
-      });
-    
-    for (const productName of products) {
-      const productPath = path.join(sectionPath, productName);
-      
-      // Check if product has markdown content
-      if (hasMarkdownContent(productPath)) {
-        try {
-          createSinglePageDocumentation(sectionType, productName);
-        } catch (error) {
-          console.warn(`Failed to generate single-page for ${sectionType}/${productName}: ${error.message}`);
-        }
-      }
-    }
-  }
-  
-  console.log('Single-page documentation generation complete.');
-}
+
 
 function getProductDisplayName(productName: string): string {
   // Remove number prefix and capitalize
@@ -514,42 +444,7 @@ function getProductDisplayName(productName: string): string {
   return displayNames[cleanName] || cleanName;
 }
 
-function getSinglePageSidebars(): DefaultTheme.SidebarMulti {
-  const sidebars: DefaultTheme.SidebarMulti = {};
-  const cwd = `${process.cwd()}/${contentRoot}`;
-  
-  // Generate sidebars for products
-  const productDirs = glob.sync(`products/*/`, { cwd }).sort();
-  for (const dirIndex in productDirs) {
-    const dir = productDirs[dirIndex].replaceAll('\\', '/');
-    const productName = path.basename(dir);
-    const cleanName = productName.replace(/^\d+-/, '');
-    
-    // Check if product has content
-    const productPath = path.join(cwd, dir);
-    if (!hasMarkdownContent(productPath)) continue;
-    
-    const singlePageRoute = `/${cleanName}/single-page`;
-    sidebars[singlePageRoute] = generateSinglePageSidebar('products', productName, singlePageRoute);
-  }
-  
-  // Generate sidebars for APIs
-  const apiDirs = glob.sync(`api/*/`, { cwd }).sort();
-  for (const dirIndex in apiDirs) {
-    const dir = apiDirs[dirIndex].replaceAll('\\', '/');
-    const productName = path.basename(dir);
-    const cleanName = productName.replace(/^\d+-/, '');
-    
-    // Check if API has content
-    const apiPath = path.join(cwd, dir);
-    if (!hasMarkdownContent(apiPath)) continue;
-    
-    const singlePageRoute = `/api/${cleanName}/single-page`;
-    sidebars[singlePageRoute] = generateSinglePageSidebar('api', productName, singlePageRoute);
-  }
-  
-  return sidebars;
-}
+
 
 function getToggleModeNavItems(): { products: DefaultTheme.NavItemWithLink[], api: DefaultTheme.NavItemWithLink[] } {
   const cwd = `${process.cwd()}/${contentRoot}`;
@@ -827,7 +722,6 @@ function generateAllSidebarConfigurations(): DefaultTheme.SidebarMulti {
 
   // Get all individual sidebar configurations
   const toggleSidebars = getToggleModeSidebars();
-  const singlePageSidebars = getSinglePageSidebars();
   const productSidebars = getSidebars('products/', false, 'autumn');
   const apiSidebars = getSidebars('api/');
 
@@ -839,12 +733,7 @@ function generateAllSidebarConfigurations(): DefaultTheme.SidebarMulti {
     sidebarEntries.push([route, sidebar]);
   }
 
-  // 2. Regular single-page routes (very specific)
-  for (const [route, sidebar] of Object.entries(singlePageSidebars)) {
-    sidebarEntries.push([route, sidebar]);
-  }
-  
-  // 3. Specific longer product and API routes first (autumn-collections before autumn)
+  // 2. Specific longer product and API routes first (autumn-collections before autumn)
   const allRoutes = [
     ...Object.entries(productSidebars),
     ...Object.entries(apiSidebars)

generate-missing-single-pages.ts

@@ -1,6 +1,6 @@
 import fs from 'fs';
 import path from 'path';
-import { createSinglePageDocumentation, createSinglePageToggleDocumentation } from './generate-single-page.ts';
+import { createSinglePageToggleDocumentation } from './generate-single-page.ts';
 
 function hasMarkdownContent(directory: string): boolean {
   if (!fs.existsSync(directory)) return false;
@@ -63,34 +63,17 @@ function generateMissingSinglePages(): void {
     for (const productName of products) {
       const productPath = path.join(sectionPath, productName);
 
-      // Determine output paths for both original and toggle modes
-      let outputPath: string;
+      // Determine output path for toggle mode only
       let toggleOutputPath: string;
 
       if (sectionType === 'api') {
-        // API files go in the original structure
-        outputPath = `${productPath}/single-page.md`;
-        // Toggle mode files
         const displayName = getProductDisplayName(productName).toLowerCase().replace(/\s+/g, '-');
         toggleOutputPath = `docs/single-page/api/${displayName}.md`;
       } else {
-        // Product files go in the clean name structure (bypass products/ rewrites)
         const displayName = getProductDisplayName(productName).toLowerCase().replace(/\s+/g, '-');
-        outputPath = `docs/${displayName}/single-page.md`;
-        // Toggle mode files
         toggleOutputPath = `docs/single-page/${displayName}.md`;
       }
 
-      // Generate original single-page if missing
-      if (!fs.existsSync(outputPath) && hasMarkdownContent(productPath)) {
-        try {
-          createSinglePageDocumentation(sectionType, productName);
-          console.log(`Generated missing single-page: ${outputPath}`);
-        } catch (error) {
-          console.warn(`Failed to generate single-page for ${sectionType}/${productName}: ${error.message}`);
-        }
-      }
-      
       // Generate toggle mode single-page if missing
       if (!fs.existsSync(toggleOutputPath) && hasMarkdownContent(productPath)) {
         try {

generate-single-page.ts

@@ -187,89 +187,7 @@ function generateTableOfContents(files: MarkdownFile[]): string {
   return toc + '\n';
 }
 
-function createSinglePageDocumentation(sectionType: 'products' | 'api', productName: string): void {
-  const basePath = `docs/${sectionType}/${productName}`;
-  
-  if (!fs.existsSync(basePath)) {
-    console.error(`Error: Directory ${basePath} does not exist`);
-    return;
-  }
-  
-  // Get all markdown files recursively
-  const allFiles = processAllFilesRecursively(basePath, '', sectionType);
-  
-  if (allFiles.length === 0) {
-    console.log(`No markdown files found in ${basePath}`);
-    return;
-  }
-  
-  // Create frontmatter for single page
-  let frontmatter: any;
-  let pageTitle: string;
-  
-  if (sectionType === 'api') {
-    // For API pages, use a more specific title without duplication
-    pageTitle = `API ${getProductDisplayName(productName)}`;
-    frontmatter = {
-      title: pageTitle,
-      description: `Полный API справочник для ${getProductDisplayName(productName)}.`
-    };
-  } else {
-    // For product pages, use the original format
-    pageTitle = `${getProductDisplayName(productName)} - Полная документация`;
-    frontmatter = {
-      title: pageTitle,
-      description: `Это единая страница с полной документацией по ${getProductDisplayName(productName)}.`
-    };
-  }
-  
-  let singlePageContent = '---\n';
-  singlePageContent += `title: "${frontmatter.title}"\n`;
-  singlePageContent += `description: "${frontmatter.description}"\n`;
-  singlePageContent += '---\n\n';
-  
-  // Don't add extra headers for single-page documents
-  
-  // Process and combine all files without TOC or extra section titles
-  for (const file of allFiles) {
-    // Adjust content
-    let processedContent = adjustImagePaths(file.content, productName, sectionType);
-    processedContent = adjustHeadingLevels(processedContent, 0); // Don't adjust heading levels
-    
-    // Add the content directly without extra section titles
-    singlePageContent += processedContent;
-    singlePageContent += '\n\n---\n\n';
-  }
-  
-  // Remove the last separator
-  singlePageContent = singlePageContent.replace(/\n\n---\n\n$/, '\n');
-  
-  // Generate output filename using correct file structure
-  // Files need to be placed in the source structure to work with VitePress rewrites
-  let outputPath: string;
-  
-  if (sectionType === 'api') {
-    // For API: place in docs/api/000-product/single-page.md 
-    // This will be accessible at /api/product/single-page after rewrites
-    outputPath = `${basePath}/single-page.md`;
-  } else {
-    // For products: place in docs/product-name/single-page.md (bypass products/ rewrites)
-    // This will be accessible at /product-name/single-page
-    const displayName = getProductDisplayName(productName).toLowerCase().replace(/\s+/g, '-');
-    const productDir = `docs/${displayName}`;
-    if (!fs.existsSync(productDir)) {
-      fs.mkdirSync(productDir, { recursive: true });
-    }
-    outputPath = `${productDir}/single-page.md`;
-  }
-  
-  // Write the single page file
-  fs.writeFileSync(outputPath, singlePageContent, 'utf-8');
-  
-  console.log(`Single-page documentation generated: ${outputPath}`);
-  console.log(`Total files combined: ${allFiles.length}`);
-  console.log(`Total content size: ${Math.round(singlePageContent.length / 1024)}KB`);
-}
+
 
 function getProductDisplayName(productName: string): string {
   // Remove number prefix and capitalize
@@ -340,7 +258,7 @@ function main(): void {
     return;
   }
 
-  createSinglePageDocumentation(sectionType as 'products' | 'api', productName);
+  createSinglePageToggleDocumentation(sectionType as 'products' | 'api', productName);
 }
 
 // Check if this module is being run directly
@@ -491,4 +409,4 @@ function hasMarkdownContent(directory: string): boolean {
   return hasSubdirContent;
 }
 
-export { createSinglePageDocumentation, createSinglePageToggleDocumentation, generateAllToggleSinglePages };
+export { createSinglePageToggleDocumentation, generateAllToggleSinglePages };