Function generateCategorySection

scripts/generate-readme.js:32–77

* Generate HTML for a single category * @param {string} categoryName - Category directory name * @returns {Promise } Generated HTML for all entries in the category

(categoryName)

 * @returns {Promise<string>} Generated HTML for all entries in the category
 */
async function generateCategorySection(categoryName) {
  const categoryPath = path.join(__dirname, '../data', categoryName);

  let entries = [];
  let errors = [];

  try {
    entries = await readYamlDir(categoryPath);
  } catch (err) {
    // If directory doesn't exist, return empty string
    if (err.code === 'ENOENT') {
      return { html: '', count: 0, errors: [] };
    }
    // Re-throw other errors
    throw err;
  }

  // Validate and filter entries
  const validEntries = [];
  for (const entry of entries) {
    const result = validateEntry(entry, entry._filePath || path.join(categoryPath, `${entry.name || 'unknown'}.yaml`));
    
    if (result.valid) {
      validEntries.push(entry);
    } else {
      const errorMsg = formatValidationErrors(result);
      errors.push(errorMsg);
      console.error(errorMsg);
    }
  }

  // Sort alphabetically by name (case-insensitive)
  validEntries.sort((a, b) => {
    const nameA = (a.name || '').toLowerCase();
    const nameB = (b.name || '').toLowerCase();
    return nameA.localeCompare(nameB);
  });

  // Generate HTML for each entry
  const htmlParts = validEntries.map(entry => generateEntryHtml(entry));

  // Join with double newlines for proper spacing
  const html = htmlParts.join('\n\n');

  return { html, count: validEntries.length, errors };
}

/**
 * Main function to generate the README