@mgks/docmd 0.3.7 → 0.3.9

package/src/live/live.css

@@ -1,9 +1,11 @@
+/* Source file from the docmd project — https://github.com/docmd-io/docmd */
+
 :root {
     --header-height: 50px;
     --border-color: #e0e0e0;
     --bg-color: #f9fafb;
     --primary-color: #007bff;
-    --resizer-width: 8px;
+    --resizer-width: 8px
 }
 
 body {
@@ -12,10 +14,9 @@ body {
     display: flex;
     flex-direction: column;
     font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, sans-serif;
-    overflow: hidden;
+    overflow: hidden
 }
 
-/* --- Top Bar --- */
 .top-bar {
     height: var(--header-height);
     background: #fff;
@@ -24,24 +25,24 @@ body {
     align-items: center;
     justify-content: space-between;
     padding: 0 1rem;
-    flex-shrink: 0;
+    flex-shrink: 0
 }
 
-.logo { 
-    font-weight: 700; 
-    font-size: 1.1rem; 
-    display: flex; 
-    align-items: center; 
-    gap: 12px;
+.logo {
+    font-weight: 700;
+    font-size: 1.1rem;
+    display: flex;
+    align-items: center;
+    gap: 12px
 }
 
-.logo span { 
-    background: var(--primary-color); 
-    color: white; 
-    padding: 2px 6px; 
-    border-radius: 4px; 
-    font-size: 0.75rem; 
-    text-transform: uppercase; 
+.logo span {
+    background: var(--primary-color);
+    color: #fff;
+    padding: 2px 6px;
+    border-radius: 4px;
+    font-size: .75rem;
+    text-transform: uppercase
 }
 
 .back-link {
@@ -49,51 +50,73 @@ body {
     align-items: center;
     justify-content: center;
     color: #666;
-    transition: color 0.2s, transform 0.2s;
+    transition: color 0.2s, transform .2s;
     text-decoration: none;
     padding: 4px;
-    border-radius: 4px;
+    border-radius: 4px
 }
 
 .back-link:hover {
     color: var(--primary-color);
     background: #f0f0f0;
-    transform: translateX(-2px);
+    transform: translateX(-2px)
 }
 
-.view-controls { display: flex; gap: 8px; background: #f0f0f0; padding: 3px; border-radius: 6px; }
-.view-btn { border: none; background: transparent; padding: 6px 10px; border-radius: 4px; cursor: pointer; font-size: 0.85rem; color: #666; font-weight: 500; }
-.view-btn.active { background: white; color: black; box-shadow: 0 1px 3px rgba(0,0,0,0.1); }
+.view-controls {
+    display: flex;
+    gap: 8px;
+    background: #f0f0f0;
+    padding: 3px;
+    border-radius: 6px
+}
+
+.view-btn {
+    border: none;
+    background: transparent;
+    padding: 6px 10px;
+    border-radius: 4px;
+    cursor: pointer;
+    font-size: .85rem;
+    color: #666;
+    font-weight: 500
+}
+
+.view-btn.active {
+    background: #fff;
+    color: #000;
+    box-shadow: 0 1px 3px #0000001a
+}
 
-/* --- Main Layout --- */
 .workspace {
     flex: 1;
     display: flex;
     position: relative;
-    overflow: hidden;
+    overflow: hidden
 }
 
 .pane {
     height: 100%;
     display: flex;
     flex-direction: column;
-    min-width: 300px; /* Minimum width constraint */
-    background: white;
+    min-width: 300px;
+    background: #fff
 }
 
 .pane-header {
     padding: 8px 16px;
-    font-size: 0.75rem;
+    font-size: .75rem;
     font-weight: 600;
     text-transform: uppercase;
     color: #888;
     background: var(--bg-color);
     border-bottom: 1px solid var(--border-color);
-    flex-shrink: 0;
+    flex-shrink: 0
+}
+
+.editor-pane {
+    width: 50%
 }
 
-/* Editor Pane */
-.editor-pane { width: 50%; }
 textarea#input {
     flex: 1;
     border: none;
@@ -103,14 +126,21 @@ textarea#input {
     font-size: 14px;
     line-height: 1.6;
     outline: none;
-    background: var(--bg-color);
+    background: var(--bg-color)
 }
 
-/* Preview Pane */
-.preview-pane { flex: 1; background: white; }
-iframe#preview { width: 100%; height: 100%; border: none; display: block; }
+.preview-pane {
+    flex: 1;
+    background: #fff
+}
+
+iframe#preview {
+    width: 100%;
+    height: 100%;
+    border: none;
+    display: block
+}
 
-/* --- Resizer Handle --- */
 .resizer {
     width: var(--resizer-width);
     background: var(--bg-color);
@@ -120,48 +150,107 @@ iframe#preview { width: 100%; height: 100%; border: none; display: block; }
     display: flex;
     align-items: center;
     justify-content: center;
-    transition: background 0.2s;
-    z-index: 10;
+    transition: background .2s;
+    z-index: 10
 }
-.resizer:hover, .resizer.resizing { background: #e0e0e0; }
-.resizer::after { content: "||"; color: #aaa; font-size: 10px; letter-spacing: 1px; }
 
-/* --- View Modes (Single vs Split) --- */
+.resizer:hover,
+.resizer.resizing {
+    background: #e0e0e0
+}
 
-/* Single Mode (Mobile style on Desktop) */
-body.mode-single .resizer { display: none; }
-body.mode-single .pane { width: 100% !important; min-width: 0; }
-body.mode-single .editor-pane { display: none; }
-body.mode-single .preview-pane { display: none; }
-body.mode-single.show-editor .editor-pane { display: flex; }
-body.mode-single.show-preview .preview-pane { display: flex; }
+.resizer::after {
+    content: "||";
+    color: #aaa;
+    font-size: 10px;
+    letter-spacing: 1px
+}
+
+body.mode-single .resizer {
+    display: none
+}
+
+body.mode-single .pane {
+    width: 100% !important;
+    min-width: 0
+}
+
+body.mode-single .editor-pane {
+    display: none
+}
+
+body.mode-single .preview-pane {
+    display: none
+}
+
+body.mode-single.show-editor .editor-pane {
+    display: flex
+}
+
+body.mode-single.show-preview .preview-pane {
+    display: flex
+}
 
-/* --- Mobile Responsive Overrides --- */
 @media (max-width: 768px) {
-    /* Force single mode on mobile, hide desktop view controls */
-    .desktop-only { display: none !important; }
-    .resizer { display: none !important; }
-    
-    .pane { width: 100% !important; }
-    .editor-pane { display: none; }
-    .preview-pane { display: none; }
-    
-    body.mobile-tab-editor .editor-pane { display: flex; }
-    body.mobile-tab-preview .preview-pane { display: flex; }
-    
+    .desktop-only {
+        display: none !important
+    }
+
+    .resizer {
+        display: none !important
+    }
+
+    .pane {
+        width: 100% !important
+    }
+
+    .editor-pane {
+        display: none
+    }
+
+    .preview-pane {
+        display: none
+    }
+
+    body.mobile-tab-editor .editor-pane {
+        display: flex
+    }
+
+    body.mobile-tab-preview .preview-pane {
+        display: flex
+    }
+
     .mobile-tabs {
         display: flex !important;
         position: fixed;
-        bottom: 0; left: 0; right: 0;
+        bottom: 0;
+        left: 0;
+        right: 0;
         height: 50px;
-        background: white;
+        background: #fff;
         border-top: 1px solid var(--border-color);
-        z-index: 100;
+        z-index: 100
+    }
+
+    .mobile-tab-btn {
+        flex: 1;
+        border: none;
+        background: transparent;
+        font-weight: 600;
+        color: #888;
+        cursor: pointer
+    }
+
+    .mobile-tab-btn.active {
+        color: var(--primary-color);
+        border-top: 2px solid var(--primary-color)
+    }
+
+    .workspace {
+        padding-bottom: 50px
     }
-    .mobile-tab-btn { flex: 1; border: none; background: transparent; font-weight: 600; color: #888; cursor: pointer; }
-    .mobile-tab-btn.active { color: var(--primary-color); border-top: 2px solid var(--primary-color); }
-    
-    .workspace { padding-bottom: 50px; } /* Space for tabs */
 }
 
-.mobile-tabs { display: none; } /* Hidden on desktop */
+.mobile-tabs {
+    display: none
+}

package/src/plugins/analytics.js

@@ -1,4 +1,4 @@
-// Source file from the docmd project — https://github.com/mgks/docmd
+// Source file from the docmd project — https://github.com/docmd-io/docmd
 
 /*
  * Generate analytics scripts for a page

package/src/plugins/seo.js

@@ -1,4 +1,4 @@
-// Source file from the docmd project — https://github.com/mgks/docmd
+// Source file from the docmd project — https://github.com/docmd-io/docmd
 
 /*
  * Generate SEO meta tags for a page
@@ -7,11 +7,11 @@
 function generateSeoMetaTags(config, pageData, relativePathToRoot) {
   let metaTagsHtml = '';
   const { frontmatter, outputPath } = pageData;
-  const seoFrontmatter = frontmatter.seo || {}; // Use nested seo object, fallback to empty
+  const seoFrontmatter = frontmatter.seo || {};
 
   if (frontmatter.noindex || seoFrontmatter.noindex) {
-    metaTagsHtml += '  <meta name="robots" content="noindex">\n';
-    return metaTagsHtml; // No other SEO tags if noindex
+    metaTagsHtml += '<meta name="robots" content="noindex">\n';
+    return metaTagsHtml;
   }
 
   const siteTitle = config.siteTitle;
@@ -22,46 +22,46 @@ function generateSeoMetaTags(config, pageData, relativePathToRoot) {
   const pageSegment = outputPath.replace(/index\.html$/, '').replace(/\.html$/, '');
   const pageUrl = `${siteUrl}${pageSegment.startsWith('/') ? pageSegment : '/' + pageSegment}`;
 
-  metaTagsHtml += `  <meta name="description" content="${description}">\n`;
+  metaTagsHtml += `<meta name="description" content="${description}">\n`;
 
   const canonicalUrl = seoFrontmatter.permalink || frontmatter.permalink || seoFrontmatter.canonicalUrl || frontmatter.canonicalUrl || pageUrl;
-  metaTagsHtml += `  <link rel="canonical" href="${canonicalUrl}">\n`;
+  metaTagsHtml += `<link rel="canonical" href="${canonicalUrl}">\n`;
 
   // Open Graph
-  metaTagsHtml += `  <meta property="og:title" content="${pageTitle} : ${siteTitle}">\n`;
-  metaTagsHtml += `  <meta property="og:description" content="${description}">\n`;
-  metaTagsHtml += `  <meta property="og:url" content="${pageUrl}">\n`;
-  metaTagsHtml += `  <meta property="og:site_name" content="${config.plugins?.seo?.openGraph?.siteName || siteTitle}">\n`;
+  metaTagsHtml += `<meta property="og:title" content="${pageTitle} : ${siteTitle}">\n`;
+  metaTagsHtml += `<meta property="og:description" content="${description}">\n`;
+  metaTagsHtml += `<meta property="og:url" content="${pageUrl}">\n`;
+  metaTagsHtml += `<meta property="og:site_name" content="${config.plugins?.seo?.openGraph?.siteName || siteTitle}">\n`;
 
   const ogImage = seoFrontmatter.image || frontmatter.image || seoFrontmatter.ogImage || frontmatter.ogImage || config.plugins?.seo?.openGraph?.defaultImage;
   if (ogImage) {
     const ogImageUrl = ogImage.startsWith('http') ? ogImage : `${siteUrl}${ogImage.startsWith('/') ? ogImage : '/' + ogImage}`;
-    metaTagsHtml += `  <meta property="og:image" content="${ogImageUrl}">\n`;
+    metaTagsHtml += `<meta property="og:image" content="${ogImageUrl}">\n`;
   }
-  metaTagsHtml += `  <meta property="og:type" content="${seoFrontmatter.ogType || frontmatter.ogType || 'website'}">\n`;
+  metaTagsHtml += `<meta property="og:type" content="${seoFrontmatter.ogType || frontmatter.ogType || 'website'}">\n`;
 
   // Twitter Card
   const twitterCardType = seoFrontmatter.twitterCard || frontmatter.twitterCard || config.plugins?.seo?.twitter?.cardType || 'summary';
-  metaTagsHtml += `  <meta name="twitter:card" content="${twitterCardType}">\n`;
+  metaTagsHtml += `<meta name="twitter:card" content="${twitterCardType}">\n`;
   if (config.plugins?.seo?.twitter?.siteUsername) {
-    metaTagsHtml += `  <meta name="twitter:site" content="${config.plugins.seo.twitter.siteUsername}">\n`;
+    metaTagsHtml += `<meta name="twitter:site" content="${config.plugins.seo.twitter.siteUsername}">\n`;
   }
   const twitterCreator = seoFrontmatter.twitterCreator || frontmatter.twitterCreator || config.plugins?.seo?.twitter?.creatorUsername;
   if (twitterCreator) {
-    metaTagsHtml += `  <meta name="twitter:creator" content="${twitterCreator}">\n`;
+    metaTagsHtml += `<meta name="twitter:creator" content="${twitterCreator}">\n`;
   }
-  metaTagsHtml += `  <meta name="twitter:title" content="${pageTitle} : ${siteTitle}">\n`;
-  metaTagsHtml += `  <meta name="twitter:description" content="${description}">\n`;
+  metaTagsHtml += `<meta name="twitter:title" content="${pageTitle} : ${siteTitle}">\n`;
+  metaTagsHtml += `<meta name="twitter:description" content="${description}">\n`;
   if (ogImage) {
     const twitterImageUrl = ogImage.startsWith('http') ? ogImage : `${siteUrl}${ogImage.startsWith('/') ? ogImage : '/' + ogImage}`;
-    metaTagsHtml += `  <meta name="twitter:image" content="${twitterImageUrl}">\n`;
+    metaTagsHtml += `<meta name="twitter:image" content="${twitterImageUrl}">\n`;
   }
 
   // Keywords
   const keywords = seoFrontmatter.keywords || frontmatter.keywords;
   if (keywords) {
     const keywordsString = Array.isArray(keywords) ? keywords.join(', ') : keywords;
-    metaTagsHtml += `  <meta name="keywords" content="${keywordsString}">\n`;
+    metaTagsHtml += `<meta name="keywords" content="${keywordsString}">\n`;
   }
 
   // LD+JSON Structured Data
@@ -71,20 +71,14 @@ function generateSeoMetaTags(config, pageData, relativePathToRoot) {
       const baseLdJson = {
         '@context': 'https://schema.org',
         '@type': 'Article',
-        mainEntityOfPage: {
-          '@type': 'WebPage',
-          '@id': canonicalUrl,
-        },
+        mainEntityOfPage: { '@type': 'WebPage', '@id': canonicalUrl },
         headline: pageTitle,
         description: description,
         url: canonicalUrl,
       };
 
       if (config.siteTitle) {
-        baseLdJson.publisher = {
-          '@type': 'Organization',
-          name: config.siteTitle,
-        };
+        baseLdJson.publisher = { '@type': 'Organization', name: config.siteTitle };
         if (config.logo?.light) {
           baseLdJson.publisher.logo = {
             '@type': 'ImageObject',
@@ -97,17 +91,13 @@ function generateSeoMetaTags(config, pageData, relativePathToRoot) {
         baseLdJson.image = `${siteUrl}${ogImage.startsWith('/') ? ogImage : '/' + ogImage}`;
       }
 
-      const finalLdJson = typeof ldJsonConfig === 'object' 
-        ? { ...baseLdJson, ...ldJsonConfig } 
-        : baseLdJson;
+      const finalLdJson = typeof ldJsonConfig === 'object' ? { ...baseLdJson, ...ldJsonConfig } : baseLdJson;
 
-      metaTagsHtml += `  <script type="application/ld+json">\n`;
-      metaTagsHtml += `    ${JSON.stringify(finalLdJson, null, 2)}\n`;
-      metaTagsHtml += `  </script>\n`;
+      metaTagsHtml += `<script type="application/ld+json">\n`;
+      metaTagsHtml += `${JSON.stringify(finalLdJson, null, 2)}\n`;
+      metaTagsHtml += `</script>\n`;
     } catch (e) {
-      console.error(`❌ Error generating LD+JSON for page: ${outputPath}`);
-      console.error(`   Could not stringify the ldJson object. Please check its structure in the frontmatter.`);
-      console.error(`   ${e.message}`);
+      console.error(`❌ Error generating LD+JSON: ${e.message}`);
     }
   }
 

package/src/plugins/sitemap.js

@@ -1,10 +1,10 @@
-// Source file from the docmd project — https://github.com/mgks/docmd
+// Source file from the docmd project — https://github.com/docmd-io/docmd
 
 /*
  * Generate sitemap.xml in the output directory root
  */
 
-const fs = require('fs-extra');
+const fs = require('../core/fs-utils');
 const path = require('path');
 
 // Function to format paths for display (relative to CWD)