@kenjura/ursa 0.45.0 → 0.47.0

package/CHANGELOG.md

@@ -1,3 +1,20 @@
+# 0.47.0
+2025-12-20
+
+- Improved handling of trailing slashes in URLs to ensure consistency across all links and resources
+
+# 0.46.0
+2025-12-20
+
+- Normalized handling of trailing slashes in URLs
+
+# 0.45.0
+2025-12-20
+
+- Added --exclude flag to ignore specified files or directories during generation
+- Improved performance of the serve command with optimized file watching
+- Automatically generating index.html for directories without an index file
+
 # 0.44.0
 2025-12-16
 

package/package.json

@@ -2,7 +2,7 @@
   "name": "@kenjura/ursa",
   "author": "Andrew London <andrew@kenjura.com>",
   "type": "module",
-  "version": "0.45.0",
+  "version": "0.47.0",
   "description": "static site generator from MD/wikitext/YML",
   "main": "lib/index.js",
   "bin": {

package/src/jobs/generate.js

@@ -578,7 +578,7 @@ export async function generate({
 
   // Automatic index generation for folders without index.html
   progress.log(`Checking for missing index files...`);
-  await generateAutoIndices(output, allSourceFilenamesThatAreDirectories, source, templates, menu, footer);
+  await generateAutoIndices(output, allSourceFilenamesThatAreDirectories, source, templates, menu, footer, allSourceFilenamesThatAreArticles);
 
   // Save the hash cache to .ursa folder in source directory
   if (hashCache.size > 0) {
@@ -631,14 +631,30 @@ export async function generate({
  * @param {string} menu - Rendered menu HTML
  * @param {string} footer - Footer HTML
  */
-async function generateAutoIndices(output, directories, source, templates, menu, footer) {
+async function generateAutoIndices(output, directories, source, templates, menu, footer, generatedArticles) {
   // Alternate index file names to look for (in priority order)
   const INDEX_ALTERNATES = ['_index.html', 'home.html', '_home.html'];
   
+  // Normalize paths (remove trailing slashes for consistent replacement)
+  const sourceNorm = source.replace(/\/+$/, '');
+  const outputNorm = output.replace(/\/+$/, '');
+  
+  // Build set of directories that already have an index.html from a source index.md/txt/yml
+  const dirsWithSourceIndex = new Set();
+  for (const articlePath of generatedArticles) {
+    const base = basename(articlePath, extname(articlePath));
+    if (base === 'index') {
+      const dir = dirname(articlePath);
+      const outputDir = dir.replace(sourceNorm, outputNorm);
+      dirsWithSourceIndex.add(outputDir);
+    }
+  }
+  
   // Get all output directories (including root)
-  const outputDirs = new Set([output]);
+  const outputDirs = new Set([outputNorm]);
   for (const dir of directories) {
-    const outputDir = dir.replace(source, output);
+    // Handle both with and without trailing slash in source
+    const outputDir = dir.replace(sourceNorm, outputNorm);
     outputDirs.add(outputDir);
   }
   
@@ -648,7 +664,12 @@ async function generateAutoIndices(output, directories, source, templates, menu,
   for (const dir of outputDirs) {
     const indexPath = join(dir, 'index.html');
     
-    // Skip if index.html already exists
+    // Skip if this directory had a source index.md/txt/yml that was already processed
+    if (dirsWithSourceIndex.has(dir)) {
+      continue;
+    }
+    
+    // Skip if index.html already exists (e.g., created by previous run)
     if (existsSync(indexPath)) {
       continue;
     }
@@ -673,7 +694,7 @@ async function generateAutoIndices(output, directories, source, templates, menu,
         const content = await readFile(foundAlternate, 'utf8');
         await outputFile(indexPath, content);
         renamedCount++;
-        progress.status('Auto-index', `Promoted ${basename(foundAlternate)} → index.html in ${dir.replace(output, '')}`);
+        progress.status('Auto-index', `Promoted ${basename(foundAlternate)} → index.html in ${dir.replace(outputNorm, '') || '/'}`);
       } catch (e) {
         progress.log(`Error promoting ${foundAlternate} to index.html: ${e.message}`);
       }
@@ -705,7 +726,7 @@ async function generateAutoIndices(output, directories, source, templates, menu,
           continue;
         }
         
-        const folderDisplayName = dir === output ? 'Home' : toTitleCase(folderName);
+        const folderDisplayName = dir === outputNorm ? 'Home' : toTitleCase(folderName);
         const indexHtml = `<h1>${folderDisplayName}</h1>\n<ul class="auto-index">\n${items.join('\n')}\n</ul>`;
         
         const template = templates["default-template"];
@@ -731,7 +752,7 @@ async function generateAutoIndices(output, directories, source, templates, menu,
         
         await outputFile(indexPath, finalHtml);
         generatedCount++;
-        progress.status('Auto-index', `Generated index.html for ${dir.replace(output, '') || '/'}`);
+        progress.status('Auto-index', `Generated index.html for ${dir.replace(outputNorm, '') || '/'}`);
       } catch (e) {
         progress.log(`Error generating auto-index for ${dir}: ${e.message}`);
       }