hdoc-tools 0.8.25 → 0.8.27

package/hdoc-build.js

@@ -30,6 +30,7 @@
         conversion_failed = 0,
         doc_header_template = '',
         doc_header_template_non_git = '',
+        pdf_enable = false,
         pdf_header_template = '',
         pdf_header_template_non_git = '',
         pdf_template = '',
@@ -43,7 +44,24 @@
         index_records = [],
         md_files = [],
         static_html_files = [],
-        work_path_content = '';
+        work_path_content = '',
+        verbose = false;
+
+    const pdf_path_excluded = function(relative_path) {
+        if (relative_path.startsWith('/')) {
+            relative_path = relative_path.slice(1, relative_path.length);
+        }
+        for (let i = 0; i < hdocbook_project.pdfGeneration.exclude_paths.length; i++) {
+            const exclude_path = hdocbook_project.pdfGeneration.exclude_paths[i];
+            if (relative_path === exclude_path) return true;
+            if (exclude_path.at(-1) === '*') {
+                if (relative_path.startsWith(exclude_path.slice(0, -1))) {
+                    return true;
+                }
+            }
+        }
+        return false;
+    };
 
     const transform_static_html = async function (file_path) {
         if (fs.existsSync(file_path.path)) {
@@ -141,11 +159,12 @@
 
             let metadata = {};
 
+            // Remove the first <h1>title</h1> from the HTML as we'll add that in the document header
+            html_txt = html_txt.replace(/(<h1.*?>)\s*.*\s*(.*<\/h1>)/, '');
+
             // Get contributor data from Github, if exists
             let contribs = [];
             if (hdocbook_config.publicSource && hdocbook_config.publicSource !== '' && hdocbook_config.publicSource.includes('github.com/Hornbill-Docs')) {
-                // Remove the first <h1>title</h1> from the HTML as we'll add that in the document header
-                html_txt = html_txt.replace(/(<h1.*?>)\s*.*\s*(.*<\/h1>)/, '');
 
                 const github_paths = hdoc.get_github_api_path(hdocbook_config.publicSource, file_path.relativePath);
                 const contributors = hdoc.get_github_contributors(github_paths.api_path, git_token);
@@ -195,11 +214,23 @@
             }
 
             let doc_header = '';
+            let pdf_header = '';
             if (hdocbook_config.publicSource.includes('github.com/Hornbill-Docs')) {
                 // Build doc header from template and frontmatter tags
                 doc_header = process_doc_header(fm_headers, file_path.relativePath, doc_header_template);
+                if (pdf_enable && !pdf_path_excluded(file_path.relativePath)) pdf_header = process_doc_header(fm_headers, file_path.relativePath, pdf_header_template);
             } else {
                 doc_header = process_doc_header(fm_headers, file_path.relativePath, doc_header_template_non_git);
+                if (pdf_enable && !pdf_path_excluded(file_path.relativePath)) pdf_header = process_doc_header(fm_headers, file_path.relativePath, pdf_header_template_non_git);
+            }
+
+            if (pdf_enable && !pdf_path_excluded(file_path.relativePath)) {
+                let pdf_txt = await hdoc_build_pdf.process_images(file_path, html_txt);
+                pdf_txt = `${pdf_header}\n${pdf_txt}`;
+                
+                // Generate PDF file from HTML
+                const pdf_file_path = file_path.path.replace(path.extname(file_path.path), '.pdf');
+                await hdoc_build_pdf.generate_pdf(pdf_template_path, pdf_template, hdocbook_config, pdf_txt, pdf_file_path, verbose);
             }
 
             html_txt = `${fm_header_content}\n${doc_header}\n${html_txt}`;
@@ -219,7 +250,7 @@
         }
     };
 
-    const transform_markdown_and_save_html = async function (file_path, verbose) {
+    const transform_markdown_and_save_html = async function (file_path) {
         conversion_attempted++;
         if (fs.existsSync(file_path.path)) {
             // Load markdown file
@@ -328,11 +359,12 @@
             }
             let metadata = {};
 
+            // Remove the first <h1>title</h1> from the HTML as we'll add that in the document header
+            html_txt = html_txt.replace(/(<h1.*?>)\s*.*\s*(.*<\/h1>)/, '');
+
             // Get contributor data from Github, if exists
             let contribs = [];
             if (hdocbook_config.publicSource && hdocbook_config.publicSource !== '' && hdocbook_config.publicSource.includes('github.com/Hornbill-Docs')) {
-                // Remove the first <h1>title</h1> from the HTML as we'll add that in the document header
-                html_txt = html_txt.replace(/(<h1.*?>)\s*.*\s*(.*<\/h1>)/, '');
 
                 const github_paths = hdoc.get_github_api_path(hdocbook_config.publicSource, file_path.relativePath);
                 const contributors = hdoc.get_github_contributors(github_paths.api_path, git_token);
@@ -384,19 +416,21 @@
             if (hdocbook_config.publicSource.includes('github.com/Hornbill-Docs')) {
                 // Build doc header from template and frontmatter tags
                 doc_header = process_doc_header(fm_headers, file_path.relativePath, doc_header_template);
-                pdf_header = process_doc_header(fm_headers, file_path.relativePath, pdf_header_template);
+                if (pdf_enable && !pdf_path_excluded(file_path.relativePath)) pdf_header = process_doc_header(fm_headers, file_path.relativePath, pdf_header_template);
             } else {
                 // Build doc header from template and frontmatter tags
                 doc_header = process_doc_header(fm_headers, file_path.relativePath, doc_header_template_non_git);
-                pdf_header = process_doc_header(fm_headers, file_path.relativePath, pdf_header_template_non_git);
+                if (pdf_enable && !pdf_path_excluded(file_path.relativePath)) pdf_header = process_doc_header(fm_headers, file_path.relativePath, pdf_header_template_non_git);
             }
 
-            let pdf_txt = await hdoc_build_pdf.process_images(file_path, html_txt);
-            pdf_txt = `${pdf_header}\n${pdf_txt}`;
-
-            // Generate PDF file from HTML
-            const pdf_file_path = file_path.path.replace(path.extname(file_path.path), '.pdf');
-            await hdoc_build_pdf.generate_pdf(pdf_template_path, pdf_template, hdocbook_config, pdf_txt, pdf_file_path, verbose);
+            if (pdf_enable && !pdf_path_excluded(file_path.relativePath)) {
+                let pdf_txt = await hdoc_build_pdf.process_images(file_path, html_txt);
+                pdf_txt = `${pdf_header}\n${pdf_txt}`;
+                
+                // Generate PDF file from HTML
+                const pdf_file_path = file_path.path.replace(path.extname(file_path.path), '.pdf');
+                await hdoc_build_pdf.generate_pdf(pdf_template_path, pdf_template, hdocbook_config, pdf_txt, pdf_file_path, verbose);
+            }
             
             html_txt = `${fm_header}\n${doc_header}\n${html_txt}`;
 
@@ -469,7 +503,9 @@
                 bc_tags += `\t\t\t\t<li class="mt-0 nav-bar-item"><a href="${bc_for_path[i].link}" class="ps-0 pe-0 text-decoration-none">${bc_for_path[i].text}</a></li>\n`;
             }
         } else {
-            console.log(`[WARNING] Path is not present in navigation items: ${logical_path}`);
+            if (verbose) {
+                console.log(`[WARNING] Path is not present in navigation items: ${logical_path}`);
+            }
         }
         bc_tags += '\t\t\t';
         wip_doc_header = wip_doc_header.replaceAll('{{breadcrumbs}}', bc_tags);
@@ -618,11 +654,11 @@
         //console.log(JSON.stringify(bc, null, 2));
     };
 
-    exports.run = async function (source_path, verbose, github_api_token) {
+    exports.run = async function (source_path, verbose_output, github_api_token) {
         if (github_api_token !== '') {
             git_token = github_api_token;
         }
-
+        verbose = verbose_output;
         // GERRY: The purpose of this function is to create a zip file containing the hdocbook content, 
         // * Create a _work folder 
         // * copy the hdocbook content to the work folder
@@ -635,12 +671,16 @@
 
         console.log('Hornbill HDocBook Build', '\n');
         console.log('  Document Path:', source_path, '\n');
+        const build_start_dt = new Date().toLocaleString();
 
         // Load the hdocbook-project.json file to get the docId
         // use the docId to get the book config
         const hdocbook_project_config_path = path.join(source_path, 'hdocbook-project.json');
         hdocbook_project = require(hdocbook_project_config_path);
         doc_id = hdocbook_project.docId;
+        if (hdocbook_project.pdfGeneration !== undefined && hdocbook_project.pdfGeneration.enable !== undefined) {
+            pdf_enable = hdocbook_project.pdfGeneration.enable;
+        }
 
         const book_path = path.join(source_path, doc_id),
             hdocbook_path = path.join(book_path, 'hdocbook.json'),
@@ -680,12 +720,14 @@
             process.exit(1);
         }
 
-        // Load PDF templates
-        try {
-            pdf_template = fs.readFileSync(pdf_template_file_path, 'utf8');
-        } catch (err) {
-            console.log(`Error reading PDF template: ${err}`);
-            process.exit(1);
+        if (pdf_enable) {
+            // Load PDF templates
+            try {
+                pdf_template = fs.readFileSync(pdf_template_file_path, 'utf8');
+            } catch (err) {
+                console.log(`Error reading PDF template: ${err}`);
+                process.exit(1);
+            }
         }
 
         build_breadcrumbs(hdocbook_config.navigation.items);
@@ -696,7 +738,7 @@
 
         // Work through MD files and convert to HTML
         for (let i = 0; i < md_files.length; i++) {
-            await transform_markdown_and_save_html(md_files[i], verbose);
+            await transform_markdown_and_save_html(md_files[i]);
         }
 
         // Work through Static HTML files and add Frontmatter tags
@@ -769,7 +811,9 @@
             const zip_path = path.join(work_path, doc_id + '.zip');
             zipper.sync.zip(work_path_content).compress().save(zip_path);
             console.log(`\nZIP Creation Success: ${zip_path}\n`);
-            console.log('Build Complete\n');
+            console.log('  Build Started:', build_start_dt);
+            console.log(`Build Completed: ${new Date().toLocaleString()}\n`);
+            
         } catch (e) {
             console.log('\nError creating ZIP: ' + e);
         }

package/hdoc.js

@@ -40,7 +40,9 @@
          continue;
       }
 
-      if (process.argv[x] == '-path') {
+      if (process.argv[x] === '-v') {
+         verbose = true;
+      } else if (process.argv[x] == '-path') {
          x++;
          if (x < process.argv.length) {
             source_path = process.argv[x];
@@ -56,10 +58,6 @@
             git_token = process.argv[x];
          }
       }
-
-      if (process.argv[x] === '-v') {
-         verbose = true;
-      }
    }
 
    console.log('Hornbill HDocBook Tools v' + getHdocPackageVersion(packageFile), '\r\n');

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "hdoc-tools",
-  "version": "0.8.25",
+  "version": "0.8.27",
   "description": "Hornbill HDocBook Development Support Tool",
   "main": "hdoc.js",
   "bin": {