xd

Author: bleonheart

.github/workflows/ci.yml

@@ -111,7 +111,8 @@ jobs:
             raww=$(grep -Po 'MODULE\.WorkshopContent\s*=\s*(\{[^}]*\}|"[^"]*")' "$m" | head -n1 | sed -E 's/^[^=]+=\s*//' || true)
             feat=$(parse_list "$rawf")
             work=$(parse_list "$raww")
-            # Use the actual directory name for the folder path (not the display name)
+            # Generate slug for anchor
+            slug=$(echo "$name" | tr '[:upper:]' '[:lower:]' | sed -E 's/[^a-z0-9]+/-/g' | sed -E 's/^-+|-+$//g')
             folder="$dir"
             jq --arg name "$name" \
                --arg versionID "$uniqueid" \
@@ -120,10 +121,11 @@ jobs:
                --arg desc "$desc" \
                --arg version "$version" \
                --arg download "https://github.com/LiliaFramework/Modules/raw/refs/heads/gh-pages/${dir}.zip" \
-               --arg source "../modules/${folder}/index.md" \
+               --arg source "../modules/index.md#${slug}" \
+               --arg folder "$folder" \
                --argjson features "$feat" \
                --argjson workshop "$work" \
-               '. += [{name:$name,versionID:$versionID,author:$author,discord:$discord,description:$desc,version:$version,download:$download,source:$source,features:$features,workshop:$workshop}]' modules_data.json > tmp.json
+               '. += [{name:$name,versionID:$versionID,author:$author,discord:$discord,description:$desc,version:$version,download:$download,source:$source,folder:$folder,features:$features,workshop:$workshop}]' modules_data.json > tmp.json
             mv tmp.json modules_data.json
           done
       - name: zip-modules
@@ -289,6 +291,9 @@ jobs:
           # Run the Node.js script to generate modules.md and modules/index.md
           if [ -f "generate_module_docs.js" ]; then
             node generate_module_docs.js
+            # Cleanup individual module folders now that they are combined into the index
+            # This prevents files from being "split" across multiple directories
+            find documentation/docs/modules/ -mindepth 1 -maxdepth 1 -type d -exec rm -rf {} +
           else
             echo "Error: generate_module_docs.js not found"
             ls -la

generate_module_docs.js

@@ -14,6 +14,10 @@ function toSlug(name) {
     .replace(/^-+|-$/g, '')
 }
 
+function stripH1(content) {
+  return content.replace(/^#\s+.*\n?/, '').trim()
+}
+
 function getChangelog(folder) {
   const changelogPath = path.join(docsModulesDir, folder, 'changelog.md')
   if (fs.existsSync(changelogPath)) {
@@ -26,6 +30,18 @@ function getChangelog(folder) {
   return ''
 }
 
+function getAbout(folder) {
+  const aboutPath = path.join(docsModulesDir, folder, 'index.md')
+  if (fs.existsSync(aboutPath)) {
+    try {
+      return fs.readFileSync(aboutPath, 'utf8')
+    } catch (err) {
+      console.error(`Failed to read about for ${folder}:`, err)
+    }
+  }
+  return ''
+}
+
 function main() {
   if (!fs.existsSync(modulesJsonPath)) {
     console.error('modules.json not found, skipping modules.md generation.')
@@ -80,20 +96,19 @@ function main() {
       const description = mod.description || 'No description available.'
       const features = mod.features || []
       const download = mod.download || '#'
-      const sourceUrl = mod.source || ''
-
-      // Extract folder from source URL: ../modules/{folder}/index.md
-      let folder = ''
-      const match = sourceUrl.match(/\/modules\/([^/]+)\//)
-      if (match) {
-        folder = match[1]
-      }
+      const folder = mod.folder || ''
+      const slug = toSlug(name)
 
+      const about = folder ? getAbout(folder) : ''
       const changelog = folder ? getChangelog(folder) : ''
 
-      markdown += `<details>\n<summary>${name}</summary>\n\n`
-      markdown += `- **Name**: ${name}\n`
-      markdown += `- **Description**: ${description}\n`
+      markdown += `<details id="${slug}">\n<summary>${name}</summary>\n\n`
+
+      if (about) {
+        markdown += `### About\n\n${stripH1(about)}\n\n`
+      } else {
+        markdown += `- **Description**: ${description}\n`
+      }
 
       if (features.length > 0) {
         markdown += `- **Main Features**:\n`
@@ -106,8 +121,6 @@ function main() {
         markdown += `- <details><summary>Changelog</summary>\n\n`
         markdown += `${changelog}\n\n`
         markdown += `</details>\n`
-      } else {
-        markdown += `- **Changelog**: Not available\n`
       }
 
       markdown += `- [Download Button](${download})\n\n`
@@ -120,17 +133,9 @@ function main() {
   fs.writeFileSync(modulesMdPath, markdown)
   console.log(`Generated modules.md at ${modulesMdPath}`)
 
-  // Write modules/index.md
-  let indexMarkdown = '# Modules\n\n'
-  if (modules.length === 0) {
-    indexMarkdown += 'No module data available. Please check back later.\n'
-  } else {
-    modules.forEach(mod => {
-      indexMarkdown += `- [${mod.name || 'Unknown'}](${mod.source || ''})\n`
-    })
-  }
+  // Write modules/index.md (Same content as modules.md now)
   fs.mkdirSync(path.dirname(modulesIndexMdPath), { recursive: true })
-  fs.writeFileSync(modulesIndexMdPath, indexMarkdown)
+  fs.writeFileSync(modulesIndexMdPath, markdown)
   console.log(`Generated modules/index.md at ${modulesIndexMdPath}`)
 }