fix-markdown.mjs

import fs from 'node:fs';
import path from 'node:path';

const documentationDirectory = path.resolve('./docs/docs');

// Rename README.md to index.md and fix links containing 'functions/'
function renameREADMEtoIndex(filePath) {
  const newPath = path.join(path.dirname(filePath), 'index.md');

  // Read file content and fix 'functions/' links
  let content = fs.readFileSync(filePath, 'utf8');
  content = content.replaceAll('functions/', './');

  // Write the fixed content back
  fs.writeFileSync(filePath, content, 'utf8');

  // Rename the file
  fs.renameSync(filePath, newPath);
  console.log(`Renamed ${filePath} to ${newPath} and fixed links.`);
}

// Fix Markdown content
function fixMarkdown(filePath) {
  const content = fs.readFileSync(filePath, 'utf8');
  const lines = content.split('\n');
  const newContent = lines.slice(6);
  const newLines = [];

  let skipProcessing = false;

  for (let line of newContent) {
    if (skipProcessing) {
      newLines.push(line);
      continue;
    }

    if (line.startsWith('## Index') || line.startsWith('### Functions')) {
      continue;
    } else if (line.startsWith('## Modules')) {
      line = line.replace('## Modules', '# Documentation');
    } else if (line.startsWith('# Function:')) {
      line = line.replace('# Function:', '#');
    } else if (line.startsWith('## Example')) {
      skipProcessing = true;
      newLines.push(line);
      continue;
    }

    line = line
      .replaceAll(/README.md/g, '')
      .replaceAll(/<([A-Za-z]+)>/g, '&lt;$1&gt;');

    newLines.push(line);
  }

  const fixedContent = newLines.join('\n');
  fs.writeFileSync(filePath, fixedContent, 'utf8');
}

// Move files out of 'functions' folder and delete the folder
function moveOutFunctions(directory) {
  const functionsDirectory = path.join(directory, 'functions');
  if (
    fs.existsSync(functionsDirectory) &&
    fs.statSync(functionsDirectory).isDirectory()
  ) {
    const files = fs.readdirSync(functionsDirectory);

    // Move all files to the parent directory
    for (const file of files) {
      const oldPath = path.join(functionsDirectory, file);
      const newPath = path.join(directory, file);
      fs.renameSync(oldPath, newPath);
      console.log(`Moved ${file} to ${directory}`);
    }

    // Delete the 'functions' folder if it's empty
    fs.rmdirSync(functionsDirectory);
    console.log(`Deleted empty folder: ${functionsDirectory}`);
  }
}

// Traverse and process documents
function traverseDocuments(directory) {
  const files = fs.readdirSync(directory);

  for (const file of files) {
    const fullPath = path.join(directory, file);

    if (fs.statSync(fullPath).isDirectory()) {
      traverseDocuments(fullPath);

      // Handle 'functions' directory specifically
      if (path.basename(fullPath) === 'functions') {
        moveOutFunctions(path.dirname(fullPath));
      }
    } else if (file.endsWith('.md')) {
      console.log(`Processing file: ${file}`);
      fixMarkdown(fullPath);
      if (file === 'README.md') {
        console.log(`Renaming file: ${file} to index.md`);
        renameREADMEtoIndex(fullPath);
      }
    }
  }
}

// Run the script
traverseDocuments(documentationDirectory);