@knowcode/doc-builder 1.9.27 → 1.9.28

package/assets/css/notion-style.css

@@ -534,6 +534,12 @@ pre code {
   overflow: hidden;
 }
 
+/* Static build main wrapper - adjust for no header and smaller breadcrumb */
+.breadcrumbs-static ~ .main-wrapper {
+  height: calc(100vh - 28px);
+  margin-top: 28px;
+}
+
 .main-wrapper.banner-visible {
   height: calc(100vh - var(--header-height) - var(--breadcrumb-height) - 3.5rem);
   margin-top: calc(var(--header-height) + var(--breadcrumb-height) + 3.5rem);
@@ -990,6 +996,76 @@ tr:hover {
   gap: var(--space-2);
 }
 
+/* Static build breadcrumbs - no header so top is 0 */
+.breadcrumbs-static {
+  top: 0 !important;
+  height: auto !important;
+  min-height: 28px !important;
+  padding: 0.15rem var(--space-6) !important;
+}
+
+/* Breadcrumbs content wrapper for static builds */
+.breadcrumbs-content {
+  display: flex;
+  justify-content: space-between;
+  align-items: center;
+  width: 100%;
+}
+
+.breadcrumbs-left {
+  display: flex;
+  align-items: center;
+  gap: 0;
+}
+
+.breadcrumbs-right {
+  display: flex;
+  align-items: center;
+  gap: var(--space-3);
+}
+
+/* Timestamp in breadcrumbs */
+.breadcrumb-date {
+  color: var(--color-text-tertiary);
+  font-size: var(--text-xs);
+  white-space: nowrap;
+}
+
+/* PDF button in breadcrumbs */
+.breadcrumb-pdf-btn {
+  background: none;
+  border: none;
+  color: var(--color-text-secondary);
+  cursor: pointer;
+  padding: var(--space-1) var(--space-2);
+  border-radius: var(--radius-md);
+  transition: all 0.2s;
+  font-size: 1rem;
+}
+
+.breadcrumb-pdf-btn:hover {
+  background: var(--color-bg-tertiary);
+  color: var(--color-text-primary);
+}
+
+/* Minimal breadcrumbs for homepage - even more compact */
+.breadcrumbs-minimal.breadcrumbs-static {
+  height: auto !important;
+  min-height: 24px !important;
+  padding: 0.1rem var(--space-6) !important;
+}
+
+/* Homepage breadcrumbs content - right-aligned only */
+.breadcrumbs-homepage {
+  justify-content: flex-end !important;
+}
+
+/* Adjust main wrapper for minimal breadcrumbs */
+.breadcrumbs-minimal.breadcrumbs-static ~ .main-wrapper {
+  height: calc(100vh - 24px);
+  margin-top: 24px;
+}
+
 .breadcrumbs.banner-visible {
   top: calc(var(--header-height) + 3.5rem);
 }

package/assets/js/main.js

@@ -1468,6 +1468,11 @@ function generateBreadcrumbs() {
   const breadcrumbContainer = document.getElementById('breadcrumbs');
   if (!breadcrumbContainer) return;
   
+  // Check if this is a static build (has data attributes)
+  const isStaticBuild = breadcrumbContainer.classList.contains('breadcrumbs-static');
+  const buildDate = breadcrumbContainer.getAttribute('data-build-date');
+  const docBuilderVersion = breadcrumbContainer.getAttribute('data-doc-builder-version');
+  
   // Decode the URL to handle special characters and spaces
   const currentPath = decodeURIComponent(window.location.pathname);
   let pathSegments = currentPath.split('/').filter(segment => segment !== '');
@@ -1561,7 +1566,46 @@ function generateBreadcrumbs() {
     }
   }).join('<i class="fas fa-chevron-right breadcrumb-separator"></i>');
   
-  breadcrumbContainer.innerHTML = breadcrumbHTML;
+  // For static builds, add timestamp and PDF button to breadcrumbs
+  if (isStaticBuild && buildDate) {
+    // Check if we're on the homepage (only "Home" breadcrumb)
+    const isHomePage = pathSegments.length === 0 || 
+                       (pathSegments.length === 1 && (pathSegments[0] === 'index' || pathSegments[0] === 'README'));
+    
+    if (isHomePage) {
+      // On homepage, just show the timestamp and PDF button in a compact bar
+      const wrapperHTML = `
+        <div class="breadcrumbs-content breadcrumbs-homepage">
+          <div class="breadcrumbs-right">
+            <span class="breadcrumb-date" title="Built with doc-builder v${docBuilderVersion || ''}">Last updated: ${buildDate}</span>
+            <button class="breadcrumb-pdf-btn" onclick="exportToPDF()" title="Export to PDF" aria-label="Export to PDF">
+              <i class="fas fa-file-pdf"></i>
+            </button>
+          </div>
+        </div>
+      `;
+      breadcrumbContainer.innerHTML = wrapperHTML;
+      breadcrumbContainer.classList.add('breadcrumbs-minimal');
+    } else {
+      // Create a wrapper div for layout with breadcrumbs
+      const wrapperHTML = `
+        <div class="breadcrumbs-content">
+          <div class="breadcrumbs-left">
+            ${breadcrumbHTML}
+          </div>
+          <div class="breadcrumbs-right">
+            <span class="breadcrumb-date" title="Built with doc-builder v${docBuilderVersion || ''}">Last updated: ${buildDate}</span>
+            <button class="breadcrumb-pdf-btn" onclick="exportToPDF()" title="Export to PDF" aria-label="Export to PDF">
+              <i class="fas fa-file-pdf"></i>
+            </button>
+          </div>
+        </div>
+      `;
+      breadcrumbContainer.innerHTML = wrapperHTML;
+    }
+  } else {
+    breadcrumbContainer.innerHTML = breadcrumbHTML;
+  }
 }
 
 // Initialize tooltip positioning for navigation items

package/doc-builder.config.js

@@ -1,5 +1,5 @@
 module.exports = {
-  "configVersion": "1.9.23",
+  "configVersion": "1.9.27",
   "docsDir": "docs",
   "outputDir": "html",
   "siteName": "@knowcode/doc-builder",

package/doc-builder.config.js.backup.1755031374829

@@ -0,0 +1,126 @@
+module.exports = {
+  "configVersion": "1.9.23",
+  "docsDir": "docs",
+  "outputDir": "html",
+  "siteName": "@knowcode/doc-builder",
+  "siteDescription": "Beautiful documentation with the least effort possible",
+  "favicon": "✨",
+  "features": {
+    "authentication": false,
+    "changelog": true,
+    "mermaid": true,
+    "mermaidEnhanced": true,
+    "tooltips": true,
+    "search": false,
+    "darkMode": true,
+    "phosphorIcons": true,
+    "phosphorWeight": "regular",
+    "phosphorSize": "1.2em",
+    "normalizeTitle": true,
+    "showPdfDownload": true,
+    "menuDefaultOpen": false,
+    "attachments": true,
+    "dynamicNavIcons": true,
+    "subtleColors": true,
+    "privateDirectoryAuth": false,
+    "banner": false,
+    "staticOutput": true
+  },
+  "staticOutputDir": "html-static",
+  "auth": {
+    "supabaseUrl": "https://xcihhnfcitjrwbynxmka.supabase.co",
+    "supabaseAnonKey": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJzdXBhYmFzZSIsInJlZiI6InhjaWhobmZjaXRqcndieW54bWthIiwicm9sZSI6ImFub24iLCJpYXQiOjE3NTM0Mzc2MzcsImV4cCI6MjA2OTAxMzYzN30.zvWp3JFIR8fBIiwuFF5gqOR_Kxb42baZS5fsBz60XOY"
+  },
+  "changelog": {
+    "daysBack": 14,
+    "enabled": true
+  },
+  "banner": {
+    "enabled": false,
+    "text": "This documentation is a preview version - some content may be incomplete",
+    "icon": "fas fa-exclamation-triangle",
+    "type": "warning",
+    "dismissible": true
+  },
+  "folderOrder": [],
+  "folderDescriptions": {},
+  "folderIcons": {},
+  "deployment": {
+    "platform": "vercel",
+    "outputDirectory": "html"
+  },
+  "seo": {
+    "enabled": true,
+    "siteUrl": "https://doc-builder-delta.vercel.app",
+    "author": "Lindsay Smith",
+    "twitterHandle": "@planbbackups",
+    "language": "en-US",
+    "keywords": [
+      "documentation",
+      "markdown",
+      "static site generator",
+      "vercel",
+      "notion-style"
+    ],
+    "titleTemplate": "{pageTitle} | {siteName}",
+    "autoKeywords": true,
+    "keywordLimit": 7,
+    "descriptionFallback": "smart",
+    "organization": {
+      "name": "Knowcode Ltd",
+      "url": "https://knowcode.tech",
+      "logo": ""
+    },
+    "ogImage": "/og-default.png",
+    "generateSitemap": true,
+    "generateRobotsTxt": true,
+    "customMetaTags": [
+      {
+        "name": "google-site-verification",
+        "content": "FtzcDTf5BQ9K5EfnGazQkgU2U4FiN3ITzM7gHwqUAqQ"
+      },
+      {
+        "name": "msvalidate.01",
+        "content": "B2D8C4C12C530D47AA962B24CAA09630"
+      }
+    ]
+  },
+  "attachmentTypes": [
+    ".pdf",
+    ".doc",
+    ".docx",
+    ".xls",
+    ".xlsx",
+    ".csv",
+    ".ppt",
+    ".pptx",
+    ".txt",
+    ".rtf",
+    ".html",
+    ".htm",
+    ".zip",
+    ".tar",
+    ".gz",
+    ".7z",
+    ".rar",
+    ".png",
+    ".jpg",
+    ".jpeg",
+    ".gif",
+    ".svg",
+    ".webp",
+    ".ico",
+    ".bmp",
+    ".json",
+    ".xml",
+    ".yaml",
+    ".yml",
+    ".toml",
+    ".mp4",
+    ".mp3",
+    ".wav",
+    ".avi",
+    ".mov"
+  ],
+  "productionUrl": "https://doc-builder-delta.vercel.app"
+};

package/html/README.html

@@ -101,8 +101,8 @@
     "name": "Knowcode Ltd",
     "url": "https://knowcode.tech"
   },
-  "datePublished": "2025-08-07T14:41:11.030Z",
-  "dateModified": "2025-08-07T14:41:11.030Z",
+  "datePublished": "2025-08-12T20:49:06.534Z",
+  "dateModified": "2025-08-12T20:49:06.534Z",
   "mainEntityOfPage": {
     "@type": "WebPage",
     "@id": "https://doc-builder-delta.vercel.app/README.html"
@@ -128,6 +128,7 @@
 </script>
 </head>
 <body>
+    
     <!-- Header -->
     <header class="header">
         <div class="header-content">
@@ -135,7 +136,7 @@
             
             <div class="header-actions">
                 <div class="deployment-info">
-                    <span class="deployment-date" title="Built with doc-builder v1.9.23">Last updated: Aug 7, 2025, 02:41 PM UTC</span>
+                    <span class="deployment-date" title="Built with doc-builder v1.9.27">Last updated: Aug 12, 2025, 08:49 PM UTC</span>
                 </div>
                 
                 
@@ -157,8 +158,9 @@
     
     
     
+    
     <!-- Breadcrumbs -->
-    <nav class="breadcrumbs" id="breadcrumbs">
+    <nav class="breadcrumbs " id="breadcrumbs" >
         <!-- Breadcrumbs will be generated by JavaScript -->
     </nav>
     

package/html/about-doc-builder.html

@@ -101,8 +101,8 @@
     "name": "Knowcode Ltd",
     "url": "https://knowcode.tech"
   },
-  "datePublished": "2025-08-07T14:41:11.041Z",
-  "dateModified": "2025-08-07T14:41:11.041Z",
+  "datePublished": "2025-08-12T20:49:06.547Z",
+  "dateModified": "2025-08-12T20:49:06.547Z",
   "mainEntityOfPage": {
     "@type": "WebPage",
     "@id": "https://doc-builder-delta.vercel.app/about-doc-builder.html"
@@ -128,6 +128,7 @@
 </script>
 </head>
 <body>
+    
     <!-- Header -->
     <header class="header">
         <div class="header-content">
@@ -135,7 +136,7 @@
             
             <div class="header-actions">
                 <div class="deployment-info">
-                    <span class="deployment-date" title="Built with doc-builder v1.9.23">Last updated: Aug 7, 2025, 02:41 PM UTC</span>
+                    <span class="deployment-date" title="Built with doc-builder v1.9.27">Last updated: Aug 12, 2025, 08:49 PM UTC</span>
                 </div>
                 
                 
@@ -157,8 +158,9 @@
     
     
     
+    
     <!-- Breadcrumbs -->
-    <nav class="breadcrumbs" id="breadcrumbs">
+    <nav class="breadcrumbs " id="breadcrumbs" >
         <!-- Breadcrumbs will be generated by JavaScript -->
     </nav>
     

package/html/css/notion-style.css

@@ -534,6 +534,12 @@ pre code {
   overflow: hidden;
 }
 
+/* Static build main wrapper - adjust for no header and smaller breadcrumb */
+.breadcrumbs-static ~ .main-wrapper {
+  height: calc(100vh - 28px);
+  margin-top: 28px;
+}
+
 .main-wrapper.banner-visible {
   height: calc(100vh - var(--header-height) - var(--breadcrumb-height) - 3.5rem);
   margin-top: calc(var(--header-height) + var(--breadcrumb-height) + 3.5rem);
@@ -990,6 +996,76 @@ tr:hover {
   gap: var(--space-2);
 }
 
+/* Static build breadcrumbs - no header so top is 0 */
+.breadcrumbs-static {
+  top: 0 !important;
+  height: auto !important;
+  min-height: 28px !important;
+  padding: 0.15rem var(--space-6) !important;
+}
+
+/* Breadcrumbs content wrapper for static builds */
+.breadcrumbs-content {
+  display: flex;
+  justify-content: space-between;
+  align-items: center;
+  width: 100%;
+}
+
+.breadcrumbs-left {
+  display: flex;
+  align-items: center;
+  gap: 0;
+}
+
+.breadcrumbs-right {
+  display: flex;
+  align-items: center;
+  gap: var(--space-3);
+}
+
+/* Timestamp in breadcrumbs */
+.breadcrumb-date {
+  color: var(--color-text-tertiary);
+  font-size: var(--text-xs);
+  white-space: nowrap;
+}
+
+/* PDF button in breadcrumbs */
+.breadcrumb-pdf-btn {
+  background: none;
+  border: none;
+  color: var(--color-text-secondary);
+  cursor: pointer;
+  padding: var(--space-1) var(--space-2);
+  border-radius: var(--radius-md);
+  transition: all 0.2s;
+  font-size: 1rem;
+}
+
+.breadcrumb-pdf-btn:hover {
+  background: var(--color-bg-tertiary);
+  color: var(--color-text-primary);
+}
+
+/* Minimal breadcrumbs for homepage - even more compact */
+.breadcrumbs-minimal.breadcrumbs-static {
+  height: auto !important;
+  min-height: 24px !important;
+  padding: 0.1rem var(--space-6) !important;
+}
+
+/* Homepage breadcrumbs content - right-aligned only */
+.breadcrumbs-homepage {
+  justify-content: flex-end !important;
+}
+
+/* Adjust main wrapper for minimal breadcrumbs */
+.breadcrumbs-minimal.breadcrumbs-static ~ .main-wrapper {
+  height: calc(100vh - 24px);
+  margin-top: 24px;
+}
+
 .breadcrumbs.banner-visible {
   top: calc(var(--header-height) + 3.5rem);
 }

package/html/documentation-index.html

@@ -101,8 +101,8 @@
     "name": "Knowcode Ltd",
     "url": "https://knowcode.tech"
   },
-  "datePublished": "2025-08-07T14:41:11.044Z",
-  "dateModified": "2025-08-07T14:41:11.044Z",
+  "datePublished": "2025-08-12T20:49:06.551Z",
+  "dateModified": "2025-08-12T20:49:06.551Z",
   "mainEntityOfPage": {
     "@type": "WebPage",
     "@id": "https://doc-builder-delta.vercel.app/documentation-index.html"
@@ -128,6 +128,7 @@
 </script>
 </head>
 <body>
+    
     <!-- Header -->
     <header class="header">
         <div class="header-content">
@@ -135,7 +136,7 @@
             
             <div class="header-actions">
                 <div class="deployment-info">
-                    <span class="deployment-date" title="Built with doc-builder v1.9.23">Last updated: Aug 7, 2025, 02:41 PM UTC</span>
+                    <span class="deployment-date" title="Built with doc-builder v1.9.27">Last updated: Aug 12, 2025, 08:49 PM UTC</span>
                 </div>
                 
                 
@@ -157,8 +158,9 @@
     
     
     
+    
     <!-- Breadcrumbs -->
-    <nav class="breadcrumbs" id="breadcrumbs">
+    <nav class="breadcrumbs " id="breadcrumbs" >
         <!-- Breadcrumbs will be generated by JavaScript -->
     </nav>
     

package/html/guides/authentication-default-change.html

@@ -101,8 +101,8 @@
     "name": "Knowcode Ltd",
     "url": "https://knowcode.tech"
   },
-  "datePublished": "2025-08-07T14:41:11.048Z",
-  "dateModified": "2025-08-07T14:41:11.048Z",
+  "datePublished": "2025-08-12T20:49:06.556Z",
+  "dateModified": "2025-08-12T20:49:06.556Z",
   "mainEntityOfPage": {
     "@type": "WebPage",
     "@id": "https://doc-builder-delta.vercel.app/guides/authentication-default-change.html"
@@ -134,6 +134,7 @@
 </script>
 </head>
 <body>
+    
     <!-- Header -->
     <header class="header">
         <div class="header-content">
@@ -141,7 +142,7 @@
             
             <div class="header-actions">
                 <div class="deployment-info">
-                    <span class="deployment-date" title="Built with doc-builder v1.9.23">Last updated: Aug 7, 2025, 02:41 PM UTC</span>
+                    <span class="deployment-date" title="Built with doc-builder v1.9.27">Last updated: Aug 12, 2025, 08:49 PM UTC</span>
                 </div>
                 
                 
@@ -163,8 +164,9 @@
     
     
     
+    
     <!-- Breadcrumbs -->
-    <nav class="breadcrumbs" id="breadcrumbs">
+    <nav class="breadcrumbs " id="breadcrumbs" >
         <!-- Breadcrumbs will be generated by JavaScript -->
     </nav>
     

package/html/guides/authentication-guide.html

@@ -101,8 +101,8 @@
     "name": "Knowcode Ltd",
     "url": "https://knowcode.tech"
   },
-  "datePublished": "2025-08-07T14:41:11.051Z",
-  "dateModified": "2025-08-07T14:41:11.051Z",
+  "datePublished": "2025-08-12T20:49:06.560Z",
+  "dateModified": "2025-08-12T20:49:06.560Z",
   "mainEntityOfPage": {
     "@type": "WebPage",
     "@id": "https://doc-builder-delta.vercel.app/guides/authentication-guide.html"
@@ -134,6 +134,7 @@
 </script>
 </head>
 <body>
+    
     <!-- Header -->
     <header class="header">
         <div class="header-content">
@@ -141,7 +142,7 @@
             
             <div class="header-actions">
                 <div class="deployment-info">
-                    <span class="deployment-date" title="Built with doc-builder v1.9.23">Last updated: Aug 7, 2025, 02:41 PM UTC</span>
+                    <span class="deployment-date" title="Built with doc-builder v1.9.27">Last updated: Aug 12, 2025, 08:49 PM UTC</span>
                 </div>
                 
                 
@@ -163,8 +164,9 @@
     
     
     
+    
     <!-- Breadcrumbs -->
-    <nav class="breadcrumbs" id="breadcrumbs">
+    <nav class="breadcrumbs " id="breadcrumbs" >
         <!-- Breadcrumbs will be generated by JavaScript -->
     </nav>
     

package/html/guides/claude-workflow-guide.html

@@ -101,8 +101,8 @@
     "name": "Knowcode Ltd",
     "url": "https://knowcode.tech"
   },
-  "datePublished": "2025-08-07T14:41:11.055Z",
-  "dateModified": "2025-08-07T14:41:11.055Z",
+  "datePublished": "2025-08-12T20:49:06.566Z",
+  "dateModified": "2025-08-12T20:49:06.566Z",
   "mainEntityOfPage": {
     "@type": "WebPage",
     "@id": "https://doc-builder-delta.vercel.app/guides/claude-workflow-guide.html"
@@ -134,6 +134,7 @@
 </script>
 </head>
 <body>
+    
     <!-- Header -->
     <header class="header">
         <div class="header-content">
@@ -141,7 +142,7 @@
             
             <div class="header-actions">
                 <div class="deployment-info">
-                    <span class="deployment-date" title="Built with doc-builder v1.9.23">Last updated: Aug 7, 2025, 02:41 PM UTC</span>
+                    <span class="deployment-date" title="Built with doc-builder v1.9.27">Last updated: Aug 12, 2025, 08:49 PM UTC</span>
                 </div>
                 
                 
@@ -163,8 +164,9 @@
     
     
     
+    
     <!-- Breadcrumbs -->
-    <nav class="breadcrumbs" id="breadcrumbs">
+    <nav class="breadcrumbs " id="breadcrumbs" >
         <!-- Breadcrumbs will be generated by JavaScript -->
     </nav>
     

package/html/guides/configuration-guide.html

@@ -101,8 +101,8 @@
     "name": "Knowcode Ltd",
     "url": "https://knowcode.tech"
   },
-  "datePublished": "2025-08-07T14:41:11.058Z",
-  "dateModified": "2025-08-07T14:41:11.058Z",
+  "datePublished": "2025-08-12T20:49:06.571Z",
+  "dateModified": "2025-08-12T20:49:06.571Z",
   "mainEntityOfPage": {
     "@type": "WebPage",
     "@id": "https://doc-builder-delta.vercel.app/guides/configuration-guide.html"
@@ -134,6 +134,7 @@
 </script>
 </head>
 <body>
+    
     <!-- Header -->
     <header class="header">
         <div class="header-content">
@@ -141,7 +142,7 @@
             
             <div class="header-actions">
                 <div class="deployment-info">
-                    <span class="deployment-date" title="Built with doc-builder v1.9.23">Last updated: Aug 7, 2025, 02:41 PM UTC</span>
+                    <span class="deployment-date" title="Built with doc-builder v1.9.27">Last updated: Aug 12, 2025, 08:49 PM UTC</span>
                 </div>
                 
                 
@@ -163,8 +164,9 @@
     
     
     
+    
     <!-- Breadcrumbs -->
-    <nav class="breadcrumbs" id="breadcrumbs">
+    <nav class="breadcrumbs " id="breadcrumbs" >
         <!-- Breadcrumbs will be generated by JavaScript -->
     </nav>